Skip to content

swagger-core v2.0.0-rc3 Release candidate!

Pre-release
Pre-release

Choose a tag to compare

View all tags
@frantuma frantuma released this 21 Nov 18:00
v2.0.0-rc3
e39422f
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Verified
Learn about vigilant mode.

Important notice!

Project groupId and package naming have changed since v2.0.0-rc3 (see ticket #2485)
New groupId is io.swagger.core.v3, therefore e.g. swagger-jaxrs2 maven dependency is in the form:

    <dependency>
      <groupId>io.swagger.core.v3</groupId>
      <artifactId>swagger-jaxrs2</artifactId>
      <version>2.0.0-rc3</version>
    </dependency>

Root package for all modules also changed to io.swagger.v3, e.g. swagger-jaxrs2 root package is now io.swagger.v3.jaxrs2

Overview

The Swagger team is proud to announce the rc3 release candidate of our main java library swagger-core. This release candidate enhances rc2 support for OpenAPI 3.0’s main features. The missing features will be added in the final release.

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 and rc2 release notes (v2.0.0-rc1, v2.0.0-rc2)
  • Third 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.
  • Project groupId and package naming change! (#2485, see also above)
  • Enhanced and stable annotations (#2481)
  • Repeatable annotations support (#2481)
  • Swagger ServletContainerInitializer based startup scanning (#2504, see related samples in samples, jersey sample, RESTEasy sample)
  • @OpenAPIDefinition support (#2517)
  • @ApplicationPath support (#2489)
  • Full @Schema elements resolving (#2476)
  • @Hidden support (#2528)
  • @Schema.subTypes support (#2511)
  • Better generics support in schema resolution (#2483)
  • Enhanced @ArraySchema support (#2501)
  • Enhanced Response schema resolving (#2513)
  • Extended set of samples
  • Improved 2.0 Wiki
  • Improved Annotation javadocs (#2541)
  • Various bug fixes and improvements

Limitations

  • 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
Assets 2
Loading