swagger-core v2.0.0-rc2 Release candidate!
Pre-releaseThe Swagger team is proud to announce the rc2 release candidate of our main java library swagger-core. This release candidate enhances rc1 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:
- See also rc1 release notes
- Second 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.
Example/Examples
support (#2416)- New 2.0 Wiki
- Enhanced security support (#2450)
- Enhanced request body support (#2401)
- Response header support (#2427)
- Enhanced support for Parameter, Schema and Content (#2404)
- Specification Filter (#2452)
- Reader listener support (#2464)
- Encoding support (#2463)
- Consumes/Produces full support(#2404)
- Annotation javadocs (#2394)
- Full sample code for jersey2 and dropwizard
- Updated dependencies
- Changed the exposed OpenAPI defintion file name to lowercase
- Various bug fixes
Limitations
- Resolve resource operations also when not annotated with
@Operation
(swagger-jaxrs2) - Implement
subtypes
field inSchema
annotation, with related resolver processing (swagger-annotations / core) - Overriding full support (swagger-core)
- Schema annotation
type
+format
full support (swagger-core)
- Schema annotation
- Reader sub-resources support (swagger-jaxrs2)
- Reader extensions full support (swagger-jaxrs2)
- Integration layer enhancements:config file location enhanced loading, additional loaders, etc. (swagger-integration, swagger-jaxrs)
- JsonIdentity support (swagger-core)
MatrixParam
annotation support