Skip to content

swagger-core v2.0.0-rc1 Release candidate!

Pre-release
Pre-release
Compare
Choose a tag to compare
@frantuma frantuma released this 17 Aug 16:01
· 1509 commits to master since this release
v2.0.0-rc1
7394f7c

The Swagger team is proud to announce the rc1 release candidate of our main java library swagger-core. This release candidate provides official initial support for OpenAPI 3.0’s main features. The missing features will be added in the next release candidates until the final release is available.

In order to better improve these libraries and tools, we ask that you start using them and provide us with feedback in form of issues (please use label 3.0 spec support) on the github repository. The issues are a huge help in finding what’s missing or not working properly (though note some issues are already submitted). We would also appreciate any PRs that improve existing or new tickets.

Be aware that the release notes contain the notable changes, but there may some changes that we missed in the list. The same applies for the Limitations section.

Notable Features:

  • First official release candidate of OpenAPI 3.0 support. swagger-core now produces OpenAPI 3.0 specs only. swagger-core 2.0 version is not backward compatible with previous 1.x versions.
  • Available on Maven central, and the sources are in the 2.0 branch. PRs should be submitted against the 2.0 branch.
  • Swagger JAX-RS 2 support
  • Java 8
  • Consistent integration mechanism

Limitations

  • Resolve resource operations also when not annotated with @Operation (swagger-jaxrs2)
  • Implement subtypes field in Schema annotation, with related resolver processing (swagger-annotations / core)
  • Overriding full support (swagger-core)
    • Schema annotation type + format full support (swagger-core)
    • Schema annotation implementation field full support (swagger-core)
  • Filter / Reader listener support (swagger-jaxrs2)
  • Reader sub-resources support (swagger-jaxrs2)
  • Reader extensions full support (swagger-jaxrs2)
  • Annotations javadocs (swagger-annotations)
  • Annotations default values enhancement (swagger-annotations / core)
  • Integration layer enhancements:config file location enhanced loading, additional loaders, etc. (swagger-integration, swagger-jaxrs)
  • Consumes/Produces full support (swagger-jaxrs2)
  • JsonIdentity support (swagger-core)
  • MatrixParam annotation support
Assets 2
Loading