Swagger-core 1.5.18 released!

Mainly bug fix release implementing/fixing the following:

• Updated OSGi bundle plugin (#2587)
• Updated Jackson version (#2576)
• Remove logs flood for ApiImplicitParam with no datatype defined (#2556)
• Make Reader and ServletConfig fields protected in BeanConfig (#2415, #1884)
• Fix pretty print support (#2320)
• Fix XmlAccessType.NONE processing (#1847)
• Implements support for "Untyped" schemas (#2507)
• Parse read only model property's flag for all types of model properties (#2502)

swagger-core v2.0.0-rc3 Release candidate!

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

Swagger-core 1.5.17 released!

Minor release fixing a couple of issues and adding extensions to model property:

• move logback-test.xml to /src/test/resources (#2402)
• retain generic types for attributes of BeanParam (#2466)
• add vendor extensions to api model property (#2424)
• minor fixes

swagger-core v2.0.0-rc2 Release candidate!

The 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 in Schema annotation, with related resolver processing (swagger-annotations / core)
• Overriding full support (swagger-core)
  • Schema annotation type + format full support (swagger-core)
• 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

swagger-core v2.0.0-rc1 Release candidate!

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

swagger-core v2.0.0-rc0 Release candidate!

Something went wrong with rc0, please use swagger-core v2.0.0-rc1 instead.

Swagger-core 1.5.16 released!

Minor release that upgrades a couple of dependency to deal with their respective security vulnerabilities. See #2275 for more details.

Swagger-core 1.5.15 released!

Tiny but important fix required for swagger-parser-1.0.30 (#2254)

Don't be shy to pick it up though! Tiny fixes can be important too...

Swagger Core 1.5.14 Released

Looking for OpenAPI 3.0 spec support? Jump in here:

https://github.com/swagger-api/swagger-core/tree/feature/3.0.0-rc1

v1.5.14 adds a few features and fixes a few boo-boos.

New features:

• Updated logback to 1.2.3 #2182
• Better XML support from namespace annotation #2246
• Support for Jackson's @JsonSerializeAs annotation #2147
• Updated .equals and .hashcode #2168
• Support getter-less model scanning #2251

Fixes:

• Null check in setRequired(...) method in ModelImpl #2167
• Null check for empty array inner properties #2214

Swagger-core 1.5.12 Released

Happy Holidays!!! Here's a gift from the Swagger Team.

We've updated Jackson to 2.8.4 in 1.5.12! This brings better performance, security, and bigger numbers to swagger-core.

This release replaces swagger-core-1.5.11, which was released with an issue affecting swagger parser.

As with always, there are many good things in this version

Enhancements:

• Added java.time.OffsetDateTime #1759
• Added minItems,maxItems for array properties #1767, #1781
• Better support for model resolvers when no setters #1768, #1839
• Scanning of split resources, interfaces #1800, #1888
• Jackson unwrapped support #1833
• Better support for child models #1896
• More annotation support for validations #1905
• Added multipleOf #1907
• Support for @ApiImplicitParams at class level #1926
• Added type and format in annotations #1973, #2034, #2035
• Easier setting of vendorExtensions #2020
• Added readOnly, allowEmptyValue, collectionFormat fields in annotations #2054, #2055
• Better type handling for JSON serialization of minimum, maximum
• Added boolean enum support (as if true | false wasn't enough) #2058

Fixes:

• Use null vs. false for default boolean value #1827
• Security enum fixes, other embarrassing stuff #1910, #1919
• Preserve order for maps #1934, #2022
• No more duplicate operationId values with inheritance #1959