Skip to content

Releases: swagger-api/swagger-core

Swagger-core 1.5.0 Released!

09 Jun 14:14

Choose a tag to compare

This is the first formal release of swagger-core with 2.0 spec support. Many thanks to the community for furthering the development of swagger.

Please note! We have repackaged the project from com.wordnik to io.swagger. The code API is the same!

Major changes

  • Better generics support - #498, #1096
  • No-annotations support - #978
  • Support for bean validation (JSR303) - #800
  • Improved composition support - #802, #852
  • Support for remote references - #864
  • More samples migrated to 1.5 and moved to a new repository at swagger-samples - #898,
  • Added parsing of @Api/@apioperation#protocols() - #953
  • Improved container support - #954, #955, #1032, #976
  • Improved annotation inheritance support - #1072
  • Added support for constructor parameter declarations - #1085
  • Introduced a new annotation-based configuration method

Bug fixes

  • Subresource integration fixes - #394, #942
  • Fixed support for ranges in allowableValues - #892, #957
  • Support for @ApiImplicitParam - #905
  • Request body not being picked up - #943
  • NPE when configuring swagger-core - #951
  • Fixed processing of @Api/@apioperation#produces()/consumes() - #952
  • Enum support - #1019, #1004
  • File upload support for Jersey2 - #1015
  • Recursive packages scanning - #1011
  • Examples are now objects - #988
  • Fixed authorization inheritance - #1041
  • Fixed primitive support for responses - #1120

Swagger-core 1.5.0-M2 Released!

31 Mar 13:59

Choose a tag to compare

Swagger core has undergone a major update to increase support of the Swagger 2.0 specification. Major features include support for JAXRS sub resources and Bean Validations.

Usage notes

1.5.0-M2 is API compatible with M1. It has improved stability as well as configuration options.

Major changes

Scala support has been moved to a separate project so it can evolve independently. Play! framework support will also be treated the same way.

If you need Play! support, please use swagger-core-1.3.12 until the play module is released.

Notable features
#942, #925 subresource support
#936 support for example objects
#922 better support for jaxrs regex path params
#897 support for schemes, other 2.0 support in BeanConfig
#879 multiple packages can be scanned as CSV list
#878, #841 added support for tags in operations, bootstrap
#876 glassfish PATCH annotation support
#869 response headers supported
#854 read-only fields supported
#844 JAXB default value support
#836 spec filter support
#833 model converter support
#801 BeanValidations support for JSR-303, JSR-349
#519 @JsonIgnoreProperties support
#505 @XmlElementWrapper support

Notable bug fixes
#906 http methods detected case insensitive
#886 Java 8 compilation supported

Swagger-core v1.5.2-M1 Released!

24 Feb 07:01

Choose a tag to compare

Minor release to support the following:

  • Supporting tags in operations #878
  • Return proper response type for Response.Status #877

Swagger-core v1.5.0-M1 Released!

03 Feb 15:20

Choose a tag to compare

The Swagger team is proud to announce the M1 release of three of our main libraries and tools: swagger-js, swagger-ui and swagger-core. All release provide official initial support for Swagger 2.0’s main features. The missing features will be added in the next milestone releases 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 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.

These releases could not have happened without the intensive support of the Swagger community. Each of the projects had a few PRs that really helped us push these projects forward!

Be aware that the release notes contain the notable changes, but there may some changes that we missed in the list.

Notable Features:

  • First official milestone release of Swagger 2.0 support. Swagger-Core now produces Swagger 2.0 specs only.
  • (Software) API compatible with 1.3.6+. For supported configurations, only a dependency upgrade is required. You may need a slight alteration to your configuration.
  • Swagger-core is pure Java. Only the tests are in Scala, and those do not affect the dependencies of the library.
  • Model introspection is now done by Jackson, and is much more robust.
  • No more reliance on com.sun.* packages, making swagger-core safe for Google App Engine deployments.
  • New, extension model for processing different annotation types. Extensions are loaded via Java SPI, see here for an example
  • Available on Maven central, and the sources are in the 1.5.0-M1 branch. PRs should be submitted against the develop_2.0 branch.
  • Please note that the swagger-core-1.5.x-M1 code lives in the 1.5.0-M1 branch.

Limitations:

  • There will be a M2 and M3 release of swagger-core which will provide updated support for Play! framework and scala-based servers. Please see the github milestones page for details
  • Subresource support is not implemented
  • Model converters have a new, incompatible signature with 1.3.x. Please see here for an example for details of the new interface

swagger-core 1.3.10 is now available!

21 Sep 18:17

Choose a tag to compare

We're happy to announce the release of swagger-core 1.3.10!

Changes in this release:
Fixed broken artifact for swagger-play2 for scala 2.10 and 2.11

swagger-core 1.3.9 is now available!

19 Sep 06:05

Choose a tag to compare

We're happy to announce the release of swagger-core 1.3.9!

Changes in this release:
updated to swagger-ui 2.0.24
#667 fixed authorizations in 1.3.8
#633 added hidden=true support for @Api operations
#663 added scanning of interfaces with @Inherited annotation

Also, support for scala 2.9.x has been dropped, and the Play module support is 2.3.x and greater.

version 1.3.7

13 Jul 05:46

Choose a tag to compare

  • Removed hashes for authorization fields which are not oAuth (no ticket)
  • Added parameter descriptions in swagger-servlet module:
    #604
  • Models not merged when a resource with same path is in multiple files:
    #610

Updated swagger-ui in samples to 2.0.18

swagger-project_2.10.0-1.3.6

16 Jun 15:54

Choose a tag to compare

swagger-project_2.10.0-1.3.6

swagger-project_2.9.1-1.3.4

04 Apr 06:30

Choose a tag to compare

  • You can now integrate a JAX-RS project without any custom annotations (#489). While not all swagger niceties are supported, you can see an example here:

https://github.com/wordnik/swagger-core/tree/master/samples/java-jaxrs-no-annotations

  • Better support for Joda DateTime, XMLGregorianCalendar models. They are automatically converted into JSON Schema formats (#509, #439)
  • Automatic handling of java.util.Collection
  • Updated Reflections package (#465)
  • Easier integration for Jersey 2.x. See the sample:

https://github.com/wordnik/swagger-core/tree/master/samples/java-jersey2

  • API Operations defined in multiple files are automatically merged (#501)
  • More Jackson support (#441, #461, #486)
  • Fixed missing allowMultiple request param (#478)
  • Added hidden annotations to allow removing operations and properties without a custom filter (#488, #475, #167)
  • Unified versions between annotations, core, play support (#450)

swagger-project_2.10-1.3.2

17 Jan 07:41

Choose a tag to compare

swagger-project_2.10-1.3.2