Examples and server integrations for generating the Swagger API Specification, which enables easy access to your REST API
APACHE-2.0 License
Bot releases are hidden (Show)
Published by webron almost 7 years ago
Minor release that upgrades a couple of dependency to deal with their respective security vulnerabilities. See #2275 for more details.
Published by frantuma about 7 years ago
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.
Example/Examples
support (#2416)@Operation
(swagger-jaxrs2)
subtypes
field in Schema
annotation, with related resolver processing (swagger-annotations / core)
type
+ format
full support (swagger-core)
MatrixParam
annotation supportPublished by frantuma about 7 years ago
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.
@Operation
(swagger-jaxrs2)
subtypes
field in Schema
annotation, with related resolver processing (swagger-annotations / core)
type
+ format
full support (swagger-core)
implementation
field full support (swagger-core)
MatrixParam
annotation supportPublished by frantuma about 7 years ago
Something went wrong with rc0, please use swagger-core v2.0.0-rc1 instead.
Published by fehguy over 7 years ago
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...
Published by fehguy over 7 years ago
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:
@JsonSerializeAs
annotation #2147.equals
and .hashcode
#2168Fixes:
setRequired(...)
method in ModelImpl
#2167Published by fehguy almost 8 years ago
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
multipleOf
#1907@ApiImplicitParams
at class level #1926type
and format
in annotations #1973, #2034, #2035vendorExtension
s #2020readOnly
, allowEmptyValue
, collectionFormat
fields in annotations #2054, #2055minimum
, maximum
boolean
enum support (as if true
| false
wasn't enough) #2058null
vs. false
for default boolean value #1827operationId
values with inheritance #1959Published by frantuma about 8 years ago
(see also specific sample java-jersey-jaxrs-multi-use-basepath)
(see example for decorator and annotated resource)
Published by webron over 8 years ago
1.5.8 introduced a change of behavior to the resource scanning which ended up reading unintended resources. This change was reverted to the way it was before, only with a cleaner scanning of sub resources. The table below describes what will be scanned and what will be skipped:
Annotations | Result |
---|---|
@Api |
skip |
@Path |
skip |
scanAllResources | skip |
@Api (hidden=true) |
skip |
@Api (hidden=true) @Path
|
skip |
@Api (hidden=true) scanAllResources |
skip |
@Api scanAllResources |
skip |
@Api @Path
|
parse |
@Path scanAllResources |
parse |
subresource | parse |
@Api subresource |
parse |
The wiki has been updated with the details.
Published by webron over 8 years ago
@ApiOperation
, @Api
, @Produces
and @Consumes
annotations; previously these values would be treated as single consume/produce e.g.@Produces(“text/xml,text/html”)
in previous version would result in:
"consumes": [
"text/xml,text/html"
]
With current behavior it will generate:
"consumes": [
"text/xml",
"text/html"
],
/swagger
and /swagger.{type:json|yaml}
JAX-RS endpoints provided by two separate resources, andio.swagger.jaxrs.listing.ApiListingResource
provides only /swagger.{type:json|yaml}
endpoint and no longer both /swagger
(with Accept header application/json
or application/yaml
) and /swagger.{type:json|yaml}
/swagger
endpoint is provided by io.swagger.jaxrs.listing.AcceptHeaderApiListingResource
If package scanning for providers is used, behavior remains the same (AcceptHeaderApiListingResource
is in the same package and gets scanned), otherwise AcceptHeaderApiListingResource
must be added to scanned classes.
see also wiki
io.swagger.jersey.listing.ApiListingResourceJSON
no longer provides /swagger.{type:json|yaml}
endpointRelated to JAX-RS endpoints change above,
usage of Jersey2 io.swagger.jersey.listing.ApiListingResourceJSON
should be replaced by
io.swagger.jaxrs.listing.ApiListingResource
(or package scanning io.swagger.jaxrs.listing
);
ApiListingResourceJSON
no longer provides /swagger
and /swagger.{type:json|yaml}
; it provides only /
endpoint.
@PATCH
, @GET
...etc annotations (#1643)@Produces
Annotation are ignored in Accept header (#1609)@ApiResponse
at class level (#1382)Published by fehguy over 8 years ago
This release provides new functionality for lower-level integration with Swagger and resolves compatibility issues in some deployments where @Provider
scanning is not configurable.
swagger-jaxrs
module. This made configuration of the JSON mapper easy and consistent with what is provided for rendering the swagger json/yaml definitions. Because some deployments need a different mapper configuration, this was causing problems and was removed. If you were relying on the JacksonJsonProvider
in the io.swagger.jaxrs.json
package, please either copy the logic of this file from the 1.5.6 tag or create your own provider!@Api
and @Path
parameters. The commit https://github.com/swagger-api/swagger-core/commit/8921f2f566aa8a1fd3917610fd3c0802017bed2a fixes this, but may create issues for those taking advantage of those "bugs". If you are using subresources, please verify that it's behaving how you like after upgrading to 1.5.7.Published by fehguy almost 9 years ago
This release includes a minor fix to address a bug with defaultValues (#1568)
Published by fehguy almost 9 years ago
This release includes minor fixes to models and example value support.
byte
, binary
properties (#1578)Published by fehguy almost 9 years ago
This release includes major functionality improvements in swagger-core, including migration of the swagger-servlet
project for annotating non JAX-RS-based projects to support swagger.
Please note that we have moved support for the Play! framework into a separate project
As with all swagger OSS projects, we couldn’t have made so much progress without support from the community. A special thanks to @webron, @lugaru1234, @iushankin, @tomtit and @elakito for all your efforts!
java.validation.Pattern
(#1439)java.time.LocalDate
and java.time.LocalDateTime
(#1475)java.util.Optional
(#1479)responses
model definitions in root swagger object (#1489)/
(1393nickname
if specified for operationId
on operations (#1440)@Consumes
and @Produces
at api root (#1448)description
(#1462)description
field in security definitions (#1463)enum
support for non-string types (#1418)Published by fehguy about 9 years ago
This release introduces important support for references throughout the swagger object, as well as a shift in development workflow of the swagger project. Please see here for details of that change.
Published by webron about 9 years ago
First service release for the 1.5 branch.
@ApiParam#hidden()
to hide parameters - #1188@SwaggerDefinition
- #1243@ApiModelProperty#allowableValues()
- #1276@ApiImplictParameter
- #1150BigDecimal
and BigInteger
- #1154@Deprecated
now works - #1183, #1212FormDataBodyPart
is used in Jersey - #1187BeanConfig
in the Mule module - #1234Published by webron about 9 years ago
Maintenance release.
Revert breaking change introduced by https://github.com/swagger-api/swagger-core/pull/1297.
Published by webron over 9 years ago
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!
Published by fehguy over 9 years ago
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.
1.5.0-M2 is API compatible with M1. It has improved stability as well as configuration options.
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
Published by fehguy over 9 years ago
Minor release to support the following: