v2.4.5

New annotation to set the status code of an ApiMethod

Appengine Java 11 API Explorer fixes

v2.4.4

version bump 2.4.4 -> 2.4.5-SNAPSHOT

Support for App Engine Java 11

Fix scheme when redirecting to API Explorer

Add a local generator for API client library source

Adds two new tool actions: get-client-src and gen-client-src

Improved request deserialization and response serialization

Improve Java 8 support in (de)serialization

• Enable support for java.util.Optional (jackson-datatype-jdk8)
• Enable support for parameter names for constructor detection on deserialization (jackson-module-parameter-names)

Improve reporting of JSON parse errors:

• On query / path parameters when no name available
• An array elements

Major improvements to (de)serialization mechanisms

• Rework parameter / body deserialization to prevent name collisions (#44)
• Improve response serialization customization using JsonInclude Jackson annotation for arrays
• Update all dependencies to latest available (see #47 for details)

Small API specs improvements

Support the required flag on resource properties (Discovery and Swagger)
Allow to configure the template for operationIds and tags (Swagger only)

API specs improvements

Improve body name and description

• Allow @description on resources classes and body method params
• Add default description on arrays and maps (Swagger and Discovery)
• Use the resource name for body params instead of "body" (Swagger)
• Mark request body always required (it actually is in Cloud Endpoints) (Swagger)
• Add resource name in response description (Swagger)

Improve the reference parameter extraction logic (Swagger)

• Extract param ref when a parameter is used in a single path but not on all operations
• Use more unique refs for params by appending type suffix
• Keep param order when replacing by refs
• Escape refs properly when having special chars

Other Swagger improvements

• Custom API name in Endpoints management (x-google-api-name extension)
• Detect "equivalent" paths (same REST signature but different param names)

Swagger fixes

• Fix quota metric display name (wrong location)
• Fix collectionFormat for path parameters (should be csv)

New Swagger generation options

Add new options to Swagger spec generation

• Option to add GoogleJsonError as default response body
• Option to add GoogleJsonError for specific error code when a method
  throws a well-known subclass of ServiceException
• Option to extract common parameters at path level
• Option to extract named parameters at spec level
• Provide a way to customize title and description in info section

Swagger fixes

• Add scope in security definitions (current spec is not valid)
• Swagger should return 204 on response without body

Swagger spec compatibility with Endpoints Portal

Change Maven artifact group id to com.aodocs.endpoints

Support Endpoints Portal authorization flow

• Add authorizationUrl and useScopesInAuthFlow issuer config params
• Define default authorizationUrl for Google id token issuers
• Add scopes in operation's security (required for Try it! in Portal)
• Add authorizationUrl in OAuth2 flow (required for Try it! in Portal)
• Reorder Google id token issuers to have https:// one first

New supported Swagger features

• Support deprecation on Swagger operations with @deprecated
• Add tags to Swagger operations to group like API Explorer in Portal
• Inline Map types (including JsonMap) to avoid useless definitions
• Set default values for parameters
• Add proper collection format (multi instead of csv)

Order consistency

• Remove ordering attempt in reflection-based introspection
• Add ordering in Swagger generation (sort paths by string order)

Testing

• Improve coverage of SwaggerGenerator (array tests)
• Extract Swagger assertion logic in a truth.dev subject
• Update truth.dev to 1.0