swagger-core

• Contact Model has no Vendor Extensions (#3320)
• refs #3318 - update osgi export package (#3319)
• refs #3287 - update jackson (#3308)
• refs #2189 - remove current class from JsonSubTypes (#3299)
• Add possibility to NOT expand super types while using setScan (#3296)
• fix #3286 - prioritize schema name resolving by ApiModel.value (#3292)

Note: swagger-gradle-plugin version for this release is 2.0.9.1, this is due to an issue with the publishing mechanism of gradle plugin portal

• fix DateTimeSchema example serialization by updating type to OffsetDateTime (#3273)
• refs #2340 - add JsonTypeInfo.property to schema if not existing (#3272)
• fix DateSchema and DateTimeSchema example serialization (#3271)
• refs #3197 - resolve properties within allOf for composed schemas (#3262)
• Jackson update to 2.9.9 (#3245)
• Readme Update - Security Section Added (#3216)
• Cleanup Gradle plugin buildscript classpath (#3214)
• Serialize org.joda.time.LocalDateTime as a string (#3212)
• Make parseMethod protected thus improving extensibility. (#3211)
• Do not set default type string for composed schema. (#3210)
• Respect required status of form parameters. (#3209)

minor release bumping jackson to 2.9.9 (#3246) and fixing a bug related to @JsonSerialize processing (#3264)

• deserialize into MapSchema for bool additionalProperties (#3188)
• Ticket-3115: Documentation for the swagger-gradle-plugin appears to give incorrect artifact path (#3186)
• ref #3144 - support filter in maven/gradle plugins (#3183)
• unnamed example support (#3182)
• fix #3173 - iterate filtered paths (#3177)
• fix #3173 - use filtered values in returned instance (#3176)
• AnnotationsUtils: API response header can be processed with only name… (#3175)
• Update maven wrapper distribution to 0.5.3 (#3152)
• Add swagger config file option to maven plugin (#3133) (#3150)
• ref #3138 - add Automatic-Module-Name to manifest (#3139)

• fix #3088 - fixes boolean @type annotation (#3125)
• Update jackson version to 2.9.8 (#3123)
• ref #3079 - update guava (#3121)
• bump jackson to 2.9.8 (#3120)
• fix #3071 - fixes empty enum in server variable (#3110)
• ref #2943 - replace reflections with classgraph (#3109)
• ref #3074 - include ModelConverter skipped classes in Reader shouldIgnoreClass (#3107)
• fix ArraySchema toString (#3105)
• fix #3094 - avoid duplicate fields in schema classes (#3102)
• fix #3098 - fix null enum item handling (#3100)
• ref #3082 - updated returnType handling (#3096)
• ref #3082 - jaxrs generic return type is abstract class (#3083)
• ref #3074 - Incorporate ModelConverters.skippedClasses before adding method return type to schema (#3078)
• ref #3073 - fix gradle plugin ext url (#3077)
• Swagger Core Rebranding in master (#3055)
• ref #3037 - SpecFilter fix filter schemas (#3039)
• ref #2971 - fix ObjectMapperProcessor scope of action (#3038)

• ref #3079 - update guava for v1 (#3122)
• try resolving response example as json (#3113)
• Swagger-core Jackson version update to 2.9.8 (#3091)
• Consider properties for equality of ObjectProperty (#3085)
• fix for issue #2907 - 1.5.x version (#2920)

• ref #3029 - fix ref parameter resolving (#3032)
• ref #3016 - synchronized OpenApiContextLocator (#3018)
• ref #3015 - fixed schema impl resolving as primitive, add excluded custom classes (#3017)
• ref #3013 - contextId in maven and gradle plugin (#3014)
• ref #2918 - JsonView support for RequestBody (#3010)
• ref #2972 - fixes resolving multiple map properties (#3001)
• ref #2992 - add support for LocalTime and custom system and primitive types (#2993)
• ref #2977 - fix ctxId in context, fix reader usage (#2990)
• ref #2984 - fix duplicated operationId (#2988)
• Form param bean param fix (#2986)
• Assign id to OpenApiContext correctly, to enable caching of OpenApiCo… (#2978)
• Fix for Issue #2966 (#2974)
• ref #2971 - adds modelConverterClasses and objectMapperProcessorClass to config (#2973)
• Preserve order in maps accross the OAS model (#2968)
• fix ref callback deserialization (#2963)

Notable features

• implements maven and gradle plugins (#2954)

Provides maven and gradle plugins to resolve an OpenAPI definition at build time.

• make ModelResolver _isOptionalType protected (#2908)
• ref #2420 - adds propertyName to annotatedType (#2909)
• make addRequiredItem protected so that it can be used in subclasses (#2911)
• ref #2915 - fix property name (#2917)
• ref #2926 - fix extensions (de)serialization (#2931)
• ref #2846 - fix SecuritySchemePair visibility (#2932)

Minor bug fix release implementing/fixing the following:

• refactor and fix references handling (#2849, see PR description)
• Not specifying example causes warn log message with stacktrace for longs (#2783)
• Basic implementation of 'allOf' for properties (#2890)

• Add ref field to annotations with related support in Reader (#2839)

• refs #2848 - fix required resolving for arrayschema schema (#2867)

• refs #2778 - also consider NotEmpty and NotBlank to resolve required (#2876)

• refs #2833 - fixes and resolves Links requestBody (#2877)
  IMPORTANT NOTE: this PR addresses #2833, by updating requestBody member datatype of swagger-models Link to be Object instead of previous RequestBody, as it correctly maps to OpenAPI definition https://github.com/OAI/OpenAPI-Specification/blob/3.0.1/versions/3.0.1.md#linkObject.
  This is a breaking change, but it makes sense as the previous datatype was basically wrong and meaningless. An alternative would be deprecating requestBody, and introducing a new requestBodyObject serialized as JSON requestBody via mixin and jackson annotations.

• NPE on Json sub type with no name defined (#2862)

• Add ref field to annotations with related support in Reader (#2839)

• supports primitives in oneOf, anyOf, allOf schema annotations (#2902)

Notable features

• Updates master branch to Swagger 2.0 / OpenAPI 3.0 code; 1.5.X code has been moved from master to 1.5 branch where 1.5.X code development/maintenance will continue (#2787)

• Allows custom typename resolving (#2121)

• Matrix param support (#2799)

• @NotNull support in parameter (#2803)

• Avoid NPE in some scenarios involving maps (#2793)

• Full support for ArraySchema properties via annotations (#2806)

• Updates master branch to Swagger 2.0 / OpenAPI 3.0 code; 1.5.X code has been moved from master to 1.5 branch where 1.5.X code development/maintenance will continue (#2787)

• Add missing properties to Model (#2768)

• Fix security scheme name/key resolving (#2767)

• Fix missing enum in converted response schema (#2790)

• Allows setting operation deprecated to false (#2782)

• Fix name resolution in enums (#2707)

• Allows custom typename resolving (#2121)

• Fixed override issue on property collectionFormat part of annotation @ApiImplicitParam (#2800)

• Response example support (#2319)

Notable features

Mainly bug fix release implementing/fixing the following:

• JDK 9/10 support in build (#2735)

• Supports OpenAPIExtension decorateOperation (#2748)

• Fix path building for resources without leading slashes (#2751)

• Fix stackOverflowError for circuclar reference in jackson ModelResolver (#2740)

• Fix CVE-2018-7489 - jackson version 2.9.5 (#2755)

• Fix random build error (#2752)

• Fix NPE in Reader with null config (#2736)

• Improve support for #2635

• Correctly resolve array schema annotations with ref schema items (#2763)

• Fix security scheme name/key resolving (#2767)

Notable features

• JsonView support (#2681, #2079)
• new ApiModelProperty field accessMode which replaces readOnly (deprecated) to allow setting readOnly both as true and false in ApiModelProperty annotation. (#2379)
  Current behaviour (without usage of accessMode) is left unaltered to maintain backward compatibility.
  See this test for a usage example.

Bug fixes

• Fix CVE-2018-7489 - jackson version 2.9.5 (#2756)
• Improve support for #2635
• Fix newline errors for tests on Windows (#2702)
• Path in Class level removed for subresources (#2632)
• Inner properties may have XML declared (#2316)
• Relocate Parameter allowEmptyValue (#2492)
• Move xml schema property to AbstractModel (#2669)
• Avoid duplicated operationId (#2433)

Overview

The Swagger team is proud to announce the first official 2.0.0 release of our main java library swagger-core. This release enhances rc4 support for OpenAPI 3.0’s main features.

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.

Notable Features:

• See also rc1, r2, rc3 and rc4 release notes (v2.0.0-rc1, v2.0.0-rc2, v2.0.0-rc3, v2.0.0-rc4)
• First official release with 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.
• Brand new 2.0 wiki!
• Jackson 2.9.4 (#2655)
• JsonView support (#2079)
• internal refactor (#2593)
• Updated annotations target (#2653)
• deprecates Schema.readOnly and introduces accessMode field (#2379)
• Class level response annotations (#2685)
• rework JsonProperty, readonly/writeonly support (#2169)
• JsonIdentity support (#2704)
• Complex types support in @ExtensionProperty (#2723)
• Adds openapi.json and openapi.yaml to known locations (#2727)

Bug fixes

• Annotation inheritance from interfaces (#2644)
• @Produces full support (#2646)
• Reader Correctly skips non JAX-RS methods (#2656)
• fix models osgi export packages (#2663)
• avoid duplicate operationId (#2433)
• file upload and multipart fixes (#2689)
• support ArraySchema context annotations in container type properties (#2616)
• Path in Class level removed for subresources (#2632)
• Configuration loading from servlet path (#2706)

Overview

The Swagger team is proud to announce the rc4 release candidate of our main java library swagger-core. This release candidate enhances rc3 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, r2, and rc3 release notes (v2.0.0-rc1, v2.0.0-rc2, v2.0.0-rc3)
• Fourth 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.
• Enhanced polymorphic schemas resolving (#2620)
• Remove guava dependency from core code (#2618)
• Subresource resolving (#2607)
• Additional properties as Boolean or Schema (#2461)
• Versions updates
• Enhanced RequestBody and other annotations support (#2562)
• Extended set of samples
• Various bug fixes and improvements

Limitations

• 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

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)

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

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