Merge pull request #10 from planetlabs/0.9.0

WIP Upgrade to 0.9.0-RC1

Author: joshfix

.idea/.gitignore

@@ -5,8 +5,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
+### Added
+- STAC spec v0.9.0-RC1 updates
 
-## [0.8.0.3] - 2019-10-30
+## [0.9.0.0] - 2019-10-30
 ### Added
 - STAC spec v0.8.0 updates
 - Upgrade to Spring Boot 2.2.0

CHANGELOG.md

@@ -37,7 +37,7 @@ Requires:
 
 Example build command: `mvn clean install`
 
-Additionally the docker image can be built from the [staccato-main](./staccato-main) package using the command: 
+Additionally the docker image can be built from the [staccato-application](./staccato-application) package using the command: 
 `mvn dockerfile:build`
 
 ### Running 
@@ -50,15 +50,15 @@ An Elasticsearch instance must be available.  To run locally in a docker contain
 Any of the following methods are acceptable ways of running Staccato
 - `./staccato-{version}.jar (self executing jar)`
 - `java -jar staccato-{version}.jar`
-- `mvn spring-boot:run` (from the [staccato-main](./staccato-main) directory)
+- `mvn spring-boot:run` (from the [staccato-application](./staccato-application) directory)
 - `docker run -d -i -t -p:8080:8080 quay.io/boundlessgeo/staccato:{version}`
 
 ## Endpoints
 
 ### API Endpoints
 
-- GET /stac/search - dynamic catalog endpoint
-- GET /stac/search/{id} - returns an item by ID
+- GET /search - dynamic catalog endpoint
+- GET /search/{id} - returns an item by ID
 
 ### Collection Endpoints
 
@@ -68,27 +68,27 @@ Any of the following methods are acceptable ways of running Staccato
 
 ### Catalog Endpoints
 
-- GET /stac - retrieves the root catalog
+- GET / - retrieves the root catalog
 - GET /stac/{catalog_id} - retrieves a catalog by ID
 - GET /stac/{catalog_id}/items - retrieves a collection of items belonging to a collection
 - GET /stac/{collection_id}/items/{id} - retrieves an item by ID from a collection
 
 ### Transaction Endpoints
 
-- POST /stac/{collection_id}/items - creates a new item
-- PUT /stac/{collection_id}/items/{item_id} - creates a new item
-- PATCH /stac/{collection_id}/items/{item_id} - updates an item item
-- DELETE /stac/{collection_id}/items/{item_id} - deletes an item
+- POST /collection/{collection_id}/items - creates a new item
+- PUT /collection/{collection_id}/items/{item_id} - creates a new item
+- PATCH /collection/{collection_id}/items/{item_id} - updates an item item
+- DELETE /collection/{collection_id}/items/{item_id} - deletes an item
 
 ### Stats Endpoints
 
-- GET /stac/stats - retrieves aggregations for all collections
-- GET /stac/stats/{collection_id} - retrieves aggregations for a specific collection
+- GET /stats - retrieves aggregations for all collections
+- GET /stats/{collection_id} - retrieves aggregations for a specific collection
 
 ### Schema Endpoints
 
-- GET /stac/schema - returns the STAC specification in JSON format
-- GET /stac/schema/{collection_id} - returns the JSON schema for the specified collection
+- GET /schema - returns the STAC specification in JSON format
+- GET /schema/{collection_id} - returns the JSON schema for the specified collection
 
 ### Actuator Endpoints
 
@@ -103,15 +103,15 @@ Any of the following methods are acceptable ways of running Staccato
 - **query** a Common Query Language text string to query properties of the catalog entry (see below for examples)
 - **ids** a list of comma separated IDs to be returned
 - **collections** a list of comma separated collection IDs on which to filter the results
-- **fields.include** a comma separated list of json field names to include in the result
-- **fields.exclude** a comma separated list of json field names to exclude in the result
+- **fields** a comma separated list of json field names to include in the result; fields to be excluded can be prefixed with "-"
+- **sortby** a comma separated list of fields to sort by 
 
 Examples:  
 _GET_
-- <https://stac.boundlessgeo.io/stac/search?fields.include=id,bbox>
-- [https://stac.boundlessgeo.io/stac/search?query=landsat:wrs_path=105 AND landsat:wrs_row=83](https://stac.boundlessgeo.io/stac/search?query=landsat:wrs_path=105%20AND%20landsat:wrs_row=83)
-- <https://stac.boundlessgeo.io/stac/search?ids=LC81050832019135LGN00,LC81050822019135LGN00&collections=landsat-8-l1>
-- [https://stac.boundlessgeo.io/stac/search?limit=20&page=2&query=eo:cloud_cover<0.1&bbox=27.3245,29.85465,30.5214,31.8685&time=2018-02-12T00:00:00Z/2019-06-12T00:00:00Z](https://stac.boundlessgeo.io/stac/search?limit=20&page=2&query=eo:cloud_cover%3C.1&bbox=27.3245,29.85465,30.5214,31.8685&time=2018-02-12T00:00:00Z/2019-06-12T00:00:00Z)
+- <https://stac.boundlessgeo.io/search?fields.include=id,bbox>
+- [https://stac.boundlessgeo.io/search?query=landsat:wrs_path=105 AND landsat:wrs_row=83](https://stac.boundlessgeo.io/stac/search?query=landsat:wrs_path=105%20AND%20landsat:wrs_row=83)
+- <https://stac.boundlessgeo.io/search?ids=LC81050832019135LGN00,LC81050822019135LGN00&collections=landsat-8-l1>
+- [https://stac.boundlessgeo.io/search?limit=20&page=2&query=eo:cloud_cover<0.1&bbox=27.3245,29.85465,30.5214,31.8685&time=2018-02-12T00:00:00Z/2019-06-12T00:00:00Z](https://stac.boundlessgeo.io/stac/search?limit=20&page=2&query=eo:cloud_cover%3C.1&bbox=27.3245,29.85465,30.5214,31.8685&time=2018-02-12T00:00:00Z/2019-06-12T00:00:00Z)
 
 _POST_
 
@@ -163,7 +163,7 @@ _POST_
 ## Configuration
 
 The STAC API has several properties that are configurable from the command line, as environment properties in the 
-[application.yml](./staccato-main/src/main/resources/application.yml) file.  The table below details the properties that 
+[application.yml](./staccato-application/src/main/resources/application.yml) file.  The table below details the properties that 
 are available for configuration.
 
 Property | Default Value | Description
@@ -257,7 +257,7 @@ Each query interface defines a method to return the list of item types that the
 the actual `doFilter` method which does the actual work.  The basic premise is that the `doFilter` method accepts an 
 Item as input and returns an item as output.  This can be used to automatically add data, remove data, or transform 
 data.  Several examples of some included filters can be found in the 
-[filter](./staccato-main/src/main/java/com/planet/staccato/filter) package.  Collections can also provide custom  
+[filter](./staccato-application/src/main/java/com/planet/staccato/filter) package.  Collections can also provide custom  
 filters to accomplish various tasks, such as automatically generating links to related items based on values found in 
 the item's properties.
 
@@ -311,7 +311,7 @@ the `collection` field in every item. Because each collection will have a differ
 implement several different extension interfaces or custom fieldsExtension, Jackson cannot deserialize Item classes without
 more information on which properties class to deserialize to. Having the "collections" field in each item provides an
 extremely convenient 1:1 relationship between the item and it's properties implementation.  The Jackson configuration 
-for this can be found [here](./staccato-main/src/main/java/com/planet/staccato/config/ExtensionConfig.java). 
+for this can be found [here](./staccato-application/src/main/java/com/planet/staccato/config/ExtensionConfig.java). 
 
 ### Custom annotations
 
@@ -326,7 +326,7 @@ Set type `type` attribute to one of the enumerated values found in
 
 The `@Subcatalog` annotation, when applied to a `getter` interface method, will make that field eligible to be 
 automatically subcataloged via the `/stac/{catalog}` endpoint.  The 
-[catalog spec implementation](./staccato-main/src/main/java/com/planet/staccato/catalog) will automatically detect 
+[catalog spec implementation](./staccato-application/src/main/java/com/planet/staccato/catalog) will automatically detect 
 methods with this annotation and build a subcatalog link containing the field name.  That subcatalog will build links 
 containing all unique values in Elasticsearch for that field.  After all eligible subcatalog fieldsExtension have been 
 traversed, the links section will be populated with links to all items that match the selected subcatalog values.
@@ -421,11 +421,11 @@ actual index it belongs to and update it on that index.
 
 STAC will need to be configured with the mappings between the Elasticsearch alias name and the collection ID (eg, the
 value used in the `items.properties.collection` field). This can be set in 
-[application.yml](./staccato-main/src/main/resources/application.yml) under the path 
+[application.yml](./staccato-application/src/main/resources/application.yml) under the path 
 `stac.es.index.aliases`. The key should be the name of the write alias used in Elasticsearch (not the actual index 
 name!). The value should be the collection id.  So in our example case, the key would be `my-index-name` and the value 
 would be the collection ID.  STAC will automatically append `-search` to the alias for executing searches.
 
 At this point, you should be good to start inserting items. See the 
-[transaction API controller](./staccato-main/src/main/java/com/planet/staccato/transaction/TransactionApi.java)
+[transaction API controller](./staccato-application/src/main/java/com/planet/staccato/transaction/TransactionApi.java)
 for the proper methods to use for creating new items.

README.md

@@ -5,18 +5,18 @@
 
     <groupId>com.planet.staccato</groupId>
     <artifactId>staccato</artifactId>
-    <version>0.8.0.3</version>
+    <version>0.9.0.1</version>
     <packaging>pom</packaging>
 
     <parent>
         <groupId>org.springframework.boot</groupId>
         <artifactId>spring-boot-starter-parent</artifactId>
-        <version>2.2.1.RELEASE</version>
+        <version>2.2.3.RELEASE</version>
         <relativePath/> <!-- lookup parent from repository -->
     </parent>
 
-    <name>staccato</name>
-    <description>Staccato STAC implementation by Planet Labs</description>
+    <name>Staccato</name>
+    <description>STAC implementation by Planet Labs</description>
 
     <properties>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
@@ -33,7 +33,7 @@
     </properties>
 
     <modules>
-        <module>staccato-main</module>
+        <module>staccato-application</module>
         <module>staccato-collections</module>
         <module>staccato-commons</module>
         <module>staccato-community</module>
@@ -45,7 +45,7 @@
             <dependency>
                 <groupId>org.springframework.cloud</groupId>
                 <artifactId>spring-cloud-dependencies</artifactId>
-                <version>Hoxton.RC1</version>
+                <version>Hoxton.SR1</version>
                 <type>pom</type>
                 <scope>import</scope>
             </dependency>

pom.xml

@@ -4,15 +4,15 @@
     <modelVersion>4.0.0</modelVersion>
 
     <groupId>com.planet.staccato</groupId>
-    <artifactId>staccato-main</artifactId>
+    <artifactId>staccato-application</artifactId>
 
-    <name>staccato-main</name>
+    <name>staccato-application</name>
     <description>Planet STAC Implementation</description>
 
     <parent>
         <groupId>com.planet.staccato</groupId>
         <artifactId>staccato</artifactId>
-        <version>0.8.0.3</version>
+        <version>0.9.0.1</version>
     </parent>
 
     <properties>

staccato-main/Dockerfile staccato-application/Dockerfilestaccato-main/Dockerfile renamed to staccato-application/Dockerfile

@@ -1,6 +1,7 @@
 package com.planet.staccato;
 
 import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.databind.DeserializationFeature;
 import com.fasterxml.jackson.databind.ObjectMapper;
 import com.planet.staccato.config.StacConfigProps;
 import lombok.extern.slf4j.Slf4j;
@@ -40,6 +41,7 @@ public void run(ApplicationArguments args) throws Exception {
         if (!configProps.isIncludeNullFields()) {
             objectMapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);
         }
+        objectMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, true);
 
         if (null != stacInitializers && !stacInitializers.isEmpty()) {
             for (StacInitializer stacInitializer : stacInitializers) {