Release Notes

Picture Credit National Geographic

First and foremost a big thank you to the community for keeping me motivated to work on this project. There have been some really amazing contributions in this release in terms of code, comments, bug reports and it is humbling to see people jumping in to solve problems on the issue forum. It sure motivated me to get over the "hump" and start working on in earnest. What better way to lose the COVID blues!

Thank you! 🥳 🍾

Also please welcome the newest maintainer to the springfox team @MaksimOrlov. A lot of the great work you see in the model generation support is due to his efforts, collaborating tirelessly on weekends and not giving up while ensuring the model generation engine is performant 👏

NOTE: This is a breaking change release, I've tried to maintain backwards compatibility with earlier versions of springfox as much as possible. Deprecated APIs prior to 2.9 have been aggressively removed and new APIs that will go away in the near future have been marked. So please look out for those and do report anything that has been missed.

Highlights of this release include

• Spring 5, Webflux support (only request mapping support, functional endpoints aren't supported yet)
• Spring Integration support (feedback is much appreciated)
• Spring Boot support springfox-boot-starter dependency (Zero Config, Autoconfiguration support)
• Documented Configuration Properties with autocomplete
• Better specification compatibility with 2.0
• Support for OpenApi 3.0.3
• Zero Dependency (almost, the only libraries needed are spring-plugin, pswagger-core](https://github.com/swagger-api/swagger-core)
• Existing swagger2 annotations will continue to work and enrich open api 3.0 specification

Compatibility Notes

• Requires Java 8
• Requires Spring 5.x (not tested with earlier versions
• Requires SpringBoot 2.2+ (not tested with earlier versions)

Contributions

Significant contributions that come to mind (and please remind me of others in this list cos' my memory is weak)

• @MaksimOrlov for his work on better model generation (json view, validation groups, request/response models)
• @dschulten for introducing spring integration support
• @deblockt and @ligasgr for their work on webflux support
• @ile for spring 5 support
• @neil1hart for removing the guava dependencies
• and @cbornet for the occasional nudges to working on this release :)

Pull Requests

• 3348 - Fixed model generation bugs (#3350) by @dilipkrish
• Returning cache to life. (#3307) by @MaksimOrlov
• Check to prevent NPE. #3303 (#3304) by @MaksimOrlov
• Enhancement of merging algorithm. maintenance (#3298) by @MaksimOrlov
• Issue 3255 (#3259) by @shouldnotappearcalm
• Model enhancement bugfix (#3247) by @MaksimOrlov
• Update swagger ui to version without css security issue (#3226) by @msbg
• Jackson 2.10.1 (#3217) by @sullis
• Issue 2932 (#3210) by @alienisty
• #3189 - handle defaults in Spring placeholders (#3190) by @beliakou
• fix for issue #3178 (#3179) by @ogerardin
• Create a FormParameter model object instead of BodyParameter (#3176) by @kremers
• Fixed typo (#3161) (#3162) by @wormuth
• Fix #2932 - Spring Boot 2.2.2 (#3159) by @JoGir
• Set the basePath using the request context path if present (#3158) by @jgcollings
• Bump swagger-ui depdency (#3135) by @StevenLocke
• Fix method sort order (#182 ) (#3132) by @MaksimOrlov
• fix #3118 discriminator not set to discriminator from model (#3119) by @weaselflink
• #3075 SpringDataRest Pageable resource with integer paramters (#3078) by @csegedicsaba
• support multiple ApiImplicitParameters feature (#3064) by @ileler
• Feature/3062 : Possibility to define order of produces and consumes attribute by Docket configuration (#3063) by @wojciec
• jackson-dataformat-xml plugin (#3051) by @brunomendola
• 2967: disable DocumentationPluginsBootstrapper if spring-integration-plugin is present (#2995) by @dschulten
• Expose the 'showCommonExtensions' configuration available in swagger-ui (#2973) by @benbenw
• Remove ComponentScan from springfox-swagger2 (#2971) by @wreulicke
• Add sourcemap to springfox.js. (#2956) by @lzhoucs
• Use release version of oas dependencies (#2937) by @ashirley
• collectionFormat always multi (#2922) by @deripas
• Fix #2622 Error on use X-Forwarded-Prefix and ForwardedHeaderFilter (#2897) by @rainoko
• added IsNullAnnotationPlugin (#2862) by @hsynkrtl
• Fix #2247 maps Enum constants to value of name() rather than toString() (#2860) by @DavidSeptimus
• Fix #2855, fix incorrect api parameter type (#2856) by @dulong
• Fix #2822 related to @ApiParam(example="..") not working for @Request… (#2824) by @StasKolodyuk
• Documentation for 3.3. Springfox Spring Data Rest (#2810) by @paulvi
• Feature/spring integration support (#2793) by @dschulten
• Preserve examples (#2778) by @dschulten
• Add license scan report and status (#2770) by @fossabot
• add support for deprecated controllers (#2738) by @v3rtumnus
• Create a FormParameter model object instead of BodyParameter (#2722) by @shartte
• Sort parameters by their order before sorting them by their name (#2721) by @shartte
• Fixes #2719: Implement support for @NotBlank (#2720) by @shartte
• allow importing into eclipse (#2696) by @a1dutch
• fix typo can-use-for-docs (#2666) by @rfigueroa
• Add support for showCommonExtensions configuration options for swagger-ui (#2663) by @sakuna63
• fix/remove apostrophe in package JSON description (#2624) by @JoshMcCullough
• Feature/webflux (#2608) by @ligasgr
• Migrate to ClassGraph (formerly FastClasspathScanner) 4.0 (#2582) by @PascalSchumacher
• #1570 Add Examples Support (#2530) by @jasouyris
• Added response message examples support (#1570) (#2514) by @sol
• Bug/2511 (#2513) by @dbaje
• Removing Guava dependency (#2412) by @neil1hart
• Replace Reflections with FastClassPathScanner (#2243) (#2346) by @PascalSchumacher
• Feature/spring5 (#2273) by @ile
• Feature/webflux (#2233) by @deblockt
• Remove guava and use java8 constructs (#1082) (#2086) by @copa2
• PR to support Model enhancements (#2056) by @MaksimOrlov

Bug Fixes

• Parameter 0 of constructor in springfox.documentation.spring.data.rest.EntityServicesProvider required a bean of type 'javax.servlet.ServletContext' that could not be found. (#3382) by @desiderati
• Model property order is no longer respected as of 2.9.2 (#3087) by @dilipkrish
• Base URL is wrong with 3.0.0.SNAPSHOT waiting-for-more-info (#3030) by @ogerardin
• Example property on operations does not work (#2767) by @dilipkrish
• JsonView Is not working as expected (#3373) by @dilipkrish
• Provide intelligent defaults for web flux types Mono and Flux maintenance (#3354) by @dilipkrish
• How to detect Spring MultipartFile paramter in ApiModel annotated POJOs and show file upload button in Swagger-UI (#1370) by @RoseoxHu
• Unable to infer base url... springfox-swagger2 version 2.9.2 (#3001) by @lombocska
• swagger-ui.min.js and jquery1.8.0.min.js fail to load on AWS Lambda using Sprint Boot 2 (#3289) by @thomashoef
• ApiInfo in Docket will not contain old value if parameter is null. (#3314) by @Snap252
• Response Model with Map can not be showed the details in response (#3297) by @dianfenzhan
• 502 bad gateway when deploying to AWS, works locally. (#3300) by @AliZarrouk
• Swagger UI is not showing fileupload button for RequestBody of type Byte Array (#3364) by @lakshmitharun
• Missing "content-type" header during POST request and missing properties in swagger-ui screen (#3353) by @gwcakep
• springfox-swagger2:3.0.0-SNAPSHOT Generates conflict of the beans 'requestMappingHandlerAdapter (#3342) by @josuemojena
• Infinity loop when starting spring boot server (#2907) by @Tandolf
• springfox-swagger 3.0.0 - SNAPSHOT - JSON schema not being generated as it was before te update (#3343) by @pmroch
• Missing #ref in JSON when using Map<String,Map<String,List>> as a response type. (#3356) by @vpm911
• Swagger UI is not able to submit form data with file attachment & JSON parameter (#3311) by @mobasherswl
• NPE on EnumMapper.maybeAddAllowableValuesToParameter(EnumMapper.java:117) (#3339) by @othellico
• In 3.0.0-SNAPSHOT, using the ModelAndView parameter, an error log appears. (#3380) by @wangxin
• ResponseHeader is not working as expected (#3374) by @dilipkrish
• ResponseHeader annotation not parsed? (#2684) by @watery
• Swagger does not respect Jackson @JsonIgnoreProperties annotation (#2613) by @guan25
• @ExampleProperty/value is getting ignored (#3037) by @napolev
• Unable to scan documentation context default java.lang.NullPointerException: null (#3303) by @WesleyBlancoYuan
• Oauth 2.0 redirect_uri params is not an absolute URL using 3.0.0-SNAPSHOT (#3368) by @Tqup3
• Swagger-ui is incorrectly using a base path when you "Try Out" the api (#3351) by @dilipkrish
• SecurityContext#securityForOperation unespected behaviour if using only operationSelector (#3361) by @Aitor1405
• springfox-swagger2:3.0.0-SNAPSHOT Access denied to: springfox-swagger2-3.0.0-20200629.123820-84.jar (#3357) by @kentilini
• swagger-2.9.1 /csrf is 404 (#2603) by @hxiugangxh
• Unable to find a model that matches key in 3.0-SNAPSHOT and Spring WebFlux (#3348) by @mdsina
• AllowableValues for @ApiParam is not honored by Swagger when request parameter is Collection Array (#3321) by @SarveshSharma06
• Docket.apiInfo never reverts to default (#3327) by @jensgram
• Spring fox not accepting size parameter for uuid (#3329) by @manya0810
• When using javax.validation.constraints annotation on method parameters，the parameter is recognized as the request body (#3338) by @zx472010602
• When @EnableSwagger2WebFlux is used, Failed to start bean 'documentationPluginsBootstrapper' (#3340) by @DongDDo
• Add Implementation-Version to MANIFEST.MF (#3341) by @seregamorph
• Exception in Spring Boot 2.0.1 (#2345) by @fischest
• Suffix with number like "_1" is added to duplicated object name. (#3014) by @pitzcarraldo
• Springfox Bean Validations @Size annotation does not work properly on List (#3255) by @shouldnotappearcalm
• SpringDataRest with multiple DTO-s (#3082) by @csegedicsaba
• discriminator field is set incorrectly in ModelBuilder (typo?) (#3118) by @weaselflink
• x-forwarded-prefix ignored with springfox webflux (#3157) by @jgcollings
• SpringRestDocsOperationBuilderPlugin won't load resources from a jar (#3178) by @ogerardin
• @ApiParam(example="..") doesn't work for @RequestBody (#2822) by @StasKolodyuk
• SpringDataRest Pageable resuorce page and size parameter generated with wrong type (#3075) by @csegedicsaba
• Error on use X-Forwarded-Prefix and ForwardedHeaderFilter (#2622) by @diegobmd
• No API Generation with Webflux, Swagger 3.0.0-SNAPSHOT AND spring integration (#2967) by @Numbernick
• Typo in docs (#2665) by @rfigueroa
• Since version 2.9.0, APIs with @PathVariable are not picked up anymore due to Spring 4.3.3 code help-wanted (#2511) by @dbaje

Maintenance

• Provide intelligent defaults for web flux types Mono and Flux (#3354) by @dilipkrish
• Security vulnerability with springfox-swagger-ui-2.9.2 (#3193) by @gokumar
• Security fix in Swagger UI 3.23.11 (#3131) by @jsampson1
• SpringFox 3.0.0-SNAPSHOT boot time is unacceptably slow (#3171) by @sgri
• Password oauth2 flow not refreshing token (#3091) by @samuelj90
• Issue when using Swagger latest version 2.9.2 with Spring boot 2.2.0 (#2932) by @AdityaJaiswal7
• Update Swagger UI (#3012) by @joa
• Use name() instead of toString() for enums help-wanted (#2247) by @jonata
• Update dependencies (#2688) by @dilipkrish
• Replace Guava by java8 predicates function help-wanted (#1082) by @ouaibsky
• Upgrade to Java 8 (#2516) by @dilipkrish
• Migrate to Circle CI 2.0 (#2506) by @dilipkrish

Features

• How to configure spring integration (#797) by @ghost
• Keep property on response, but hide from request (#895) by @wind57
• Pageable support should not be only springfox-data-rest wontfix (#2761) by @c
• Polymorphism can lead to a recursive model wontfix (#2724) by @shartte
• Add better support for non-spring boot apps (#3366) by @dilipkrish
• support password format for parameter (#3002) by @natrem
• Bean Validation @Null annotation should result in readOnly (#2861) by @hsynkrtl
• Not preserving the parameter order when creating API using Java Configuration in springfox 2.9.2 can-use-for-docs (#2705) by @Manish794
• Spring 5 support (#1773) by @pabl0rg
• Add support for @JsonView (#563) by @trycatchblock
• Optional ACAHs: X-XSRF-TOKEN (#2578) by @iutipikin
• Bean Validation @NotBlank should be supported (#2719) by @ghost
• add support for the showCommonExtensions configuration option of swagger-ui (#2402) by @guyv
• Springfox does not apply JacksonXml annotations #(2734) by @norbson
• Errors on using @EnableSwagger 2 with version 2.9.0 #(2501) by @PrateekSB
• @Deprecated annotation on class(Controller),the view does't show deprecated tag （horizontal line） #(2638) by @wdyun
• Unable to infer base url with Spring 5 and Boot 2 #(2710) by @mapto
• Replace a String parameter documentation with the corresponding full type model? #(2523) by @watery
• Support for Response examples #(1570) by @yangwangxing

2.9.2 Release

© JUDITH VRUGT, NATIONAL GEOGRAPHIC YOUR SHOT

Thank you for the patience with this release. More importantly, thank you for your contributions in helping identify bugs and issues and improving the library with your contributions!

Pull requests and contributions

• (#2492) Added missing backtick @TwinProduction
• (#2465) X-Forwarded-Prefix should replace basePath in newer spring versions @rainoko
• (#2464) Remove replaceAll with trim @ctruzzi
• (#2434) Add csrf token support @olOwOlo
• (#2429) Remove output related to fixed issue (#1244) #2428 @haelduksf
• (#2404) Using media type to determine correct param type when expanding param… @andyRokit

Bugs

• (#2502) OperationContext only finds SecurityContext's by path ignoring methods
  @robinsonmark
• (#2481) ConditionalOnWebApplication not found after upgrading to 2.9.0 duplicate @gionn
• (#2461) 2.8.0 /swagger-resource/configuration/ui does not set Accept header properly @OverDrone
• (#2446) ApiParam allowableValues string with spaces is not supported @uriparush
• (#2438) Upgrade to SpringFox 2.9.0 causes failures in Spring Boot 2.0.2.RELEASE @james
• (#2428) description = "@Size: Min - Max (until #1244 gets fixed)" when param annotated with @Min and/or @Max but #1244 is already fixed @haelduksf
• (#2423) Query Parameter extracted from Object doesn't recognize public field without getter @kintomiko
• (#2415) JSR-303: Size annotation on Path Param generates maximum/minimum, but on Model generates maxLength/minLength @retinaburn
• (#2401) Present multipart object attributes as "formData" duplicate @andyRokit
• (#2376) Model attribute expansion should respect form/query parameter type
  @dilipkrish
• (#2498) Path Parameter generated having unsupported properties duplicate @FossilBlade
• (#2481) ConditionalOnWebApplication not found after upgrading to 2.9.0 duplicate @gionn
• (#2466) There is no jar in maven repo.Why? duplicate @litttlefisher
• (#2441) Upgrading from 2.8.0 to 2.9.0 causes SpringBootTest to stop working duplicate @maraswrona
• (#2401) Present multipart object attributes as "formData" duplicate @andyRokit
• (#755) o.s.data.domain.Pageable - automatically add @ApiImplicitParams? can-use-for-docs duplicate @steve

Feature

• (#2180) Is it possible to document OAuth 2 scopes for different HTTP methods? feature @Beontra

©️Photograph by Alex Geifman courtesy National Geographic

2.9.0 Release

This is the last release supporting jdk 7 and spring 4.x. The next planned release is 3.0 which will have jdk 8 as a pre-requisite. There was a large effort to ensure a stable release before moving to the next major release. A big thank you again for the numerous feature/bug requests for making this product better and supporting this library.

A special thank you to @kasecato, @MaksimOrlov, @neumaennl, @rgoers and @Fyro-Ing for working on some much requested features.

NOTE: All deprecations will be removed when we move to 3.0

NOTE: This release isnt available via maven central due to issues publishing to maven central. Still working through the issues. It is available via jcenter.

Pull Requests

• (#2356) Add tag vendor extensions @nhtzr
• (#2323) fix for spring data rest 3.0.5.RELEASE while maintaining backward com… @deodeveloper
• (#2313) springfox-data-rest: fix EntitySearchExtractor return type @iles
• (#2302) Fix several typos in the documentation can-use-for-docs @rillig
• (#2288) add Bean Property Definition presence check @bratwurzt
• (#2277) Not checking if defaultValue on is empty @matthewmcgarvey
• (#2275) Take the parameter name from attribute @RequestPart value @VasilievAleksey
• (#2264) Upgrading swagger-ui to 3.11.0 maintenance @kasecato
• (#2258) Issue 2257 fix default file encoding related failures @atsu85
• (#2228) Added minify plugin maintenance @kasecato
• (#2225) Added support for IE 11 and Edge @kasecato
• (#2163) add @SwaggerExampleObject annotation. @gena
• (#1817) Support javadoc based document generation => Issue 1691 @rgoers
• (#1671) General functionality for comparing models. Initial support for #182, #807, #895, #1356 @MaksimOrlov
• (#1152) Add Polymorphism Support @Fyro-Ing

Features

• (#2361) Make Documentation Plugins Bootstrapper autostart configurable feature @dilipkrish
• (#2293) Added Vendor Extensions Support to Tag object feature help wanted @nhtzr
• (#2253) Producing "x-example" with @ApiParam for @PathVariable feature help wanted @kilsbo
• (#2166) Swagger UI 3.x Suggested Improvements feature help wanted @dilipkrish
• (#2125) I want to Example Value customize feature help wanted @cheese10yun
• (#1903) XmlAttribute not applied duplicate feature @janfockaert
• (#1151) Add Polymorphism Support feature @Fyro
• (#868) Springfox support for polymorphism duplicate feature help wanted @sunaina
• (#2043) Generate own model @deblockt
• (#1700) @ApiModelProperty add example will be parsed to json duplicate @igieon
• (#1232) Externalizing Descriptions of Api-Annotations (ApiModel/ApiModelProperty/...) @jfiala
• (#1449) @ApiModelProperty not displaying attribute when using @ModelAttributeode duplicate @rantunesboreas

Bugs

• (#2039) Endpoints with the same path and parameters but different headers some times cause java.lang.IllegalArgumentException: Multiple entries with same key @joaoacmota
• (#2194) Swagger-UI authorization headers stopped being sent in 2.8.0 @ctmay4
• (#1964) How to disable 'example' output in models for booleans @fairct
• (#2127) Endpoints not exported with Spring Data REST has-workaround @drenda
• (#1827) Error when rendering recursively defined models @tcsw1221
• (#2230) @XMLRootElement and @XmlAttribute ignored @rstmm
• (#2265) @ApiModelProperty throwing NumberFormatException if example value is not set wontfix @nikunjundhad
• (#2204) Schema error: should NOT have additional properties allowEmptyValue @igorko
• (#2203) Nested maps are not being converted properly to Swagger models @francocm
• (#1937) @ModelAttribute with getters and no setters @bademux
• (#2357) swagger-ui.html in 2.8.0 contains references to 2.8.0-SNAPSHOT @nahguam
• (#1831) @ApiParam hidden=true does not work on @RequestHeader help wanted @scottf
• (#2231) Cannot create a rule to substitute list items with primitive types @mclem
• (#2182) JsonUnwrapped prefix ignored in release 2.7.0 @ccdd4ever
• (#2314) UUID parameters don't have format "uuid" @dominik
• (#2249) How to avoid the automatic number convertion for example @thelo
• (#2368) Void type in @ModelAttribute annotated classes. @MaksimOrlov
• (#1944) @ApiResponse(... response = Void.class) produces empty model, (... response = void.class) does not has-workaround @rtomsick
• (#2076) How to convert a model Property to an Attribute in XML based req/res spring boot application? @vinodamity
• (#2226) JAXB is required as explicit dependency for kotlin service/ @flatiron32
• (#2257) Tests fail on windows @atsu85
• (#2272) springfox-data-rest v3 support duplicate @PascalSchumacher
• (#2311) springfox-data-rest: Inconsistent model returned between findAll and search methods @iles
• (#2322) NumberFormatException when parsing node name from Forward header with double quotes not-reproducable @thiagolocatelli
• (#2216) Springfox Swagger UI [2.8] IE / Edge Support @gerard
• (#2278) Swagger UI 2.8.0 doesn't show response working with ApiOperation can-use-for-docs @mhersc1
• (#2320) SpringFox 2.8.0 Error: "Could not resolve pointer: /definitions/String" @mrgrew
• (#2212) SizeAnnotationPlugin spams log at INFO level @shabino
• (#2220) OperationParameterReader does not process optional path parameters correctly @raphw
• (#2235) Full URLs in /swagger-resources no longer works after 2.7.0 -> 2.8.0 Upgrade @gloeglm
• (#2263) @RequestPart "name/value" attribute ignored @fschmager
• (#2268) Optional query parameters are marked as required in the UI not-reproducable @ok11
• (#2271) When there are two return bodies with the same name class, only one class parameter can be parsed normally. For example: two Data classes duplicate @k631583871
• (#2282) java.lang.StackOverflowError happened when model extends genericity class @Seven4X
• (#2283) IE11 browsers can't display page on version 2.8.0 duplicate @903452746
• (#2296) @RequestParam field with default value "" (empty string) is marked required duplicate @Mumi
• (#2298) Support for breaking spring-data-rest changes java.lang.NoSuchMethodError duplicate @salah3x
• (#2309) Swagger-ui web jar is not producing the artifact correctly @dilipkrish
• (#2315) Swagger 2.8.0 not working on IE11 duplicate @Snina88
• (#2316) @RequestPart not reporting type or allowableValues in generated API not-reproducable @bgiaccio
• (#2347) Parameter Vendor Extensions doesn't show up in generated spec @RisenZhong
• (#2276) @RequestParam with defaultValue of empty string on String parameter marked as required @matthewmcgarvey
• (#2286) [XmlPropertyPlugin]: Optional.get() cannot be called on an absent value @bratwurzt
• (#2370) Not able to disable schema validation. @makcpop
• (#1909) springfox doesn't work with Jackson 2.9.0.pr4 beihaifeiwu
• (#2344) When i use Swagger Junit is not working not working @pparnati
• (#2365) The json serialiser ignores the dataType when output the digits only string @ouya2

Maintenance

• (#2350) Upgrade libraries @dilipkrish
• (#2329) Activate springfox only when web environment is available @dilipkrish
• (#2264) Upgrading swagger-ui to 3.11.0 PR @kasecato
• (#2256) Docket SecurityContexts to filter by HTTP methods @vadimkim
• (#2252) Suggestion about PojoPropertyBuilderFactory: Change the alerts about Jackson 2.6 compliance @rs
• (#2243) Remove dependency on org.reflections.Reflections @leewinder
• (#2228) Added minify plugin PR @kasecato
• (#2219) ApiListingScannerPlugin is ignored if no Spring controller is registered @raphw
• (#2137) From swagger editor able to get the JWT auth token, but from application which enabled swagger-ui using springfox is not working @ranjithap7576
• (#1980) spring-data-rest RepositoryRestResource.collectionResourceRel not Mapped in Model @n3utrino
• (#1973) Springfox Swagger configuration breaks customized ObjectMapper in Spring Boot has-workaround @avillev
• (#1680) HAL Resources not rendered correctly duplicate @raffaelschmid
• (#1657) Parameter vendor extension support @zidanluo

Photograph by Margaret Krzepkowski

Thank you everyone for your contributions.

While this release still doesnt support OpenAPI 1.0 spec, it does bring support for the new swagger-ui look thanks to @kasecato!! 🙇

Apologies for the delayed release schedule of 2.8.0. Much of the work in this release was to shore up the library for significant work in the near future to support in 2.9.0

• OpenAPI spec 3.0
• Set the stage for fixing bugs related to Swagger 1.2 Spec. This is the penultimate release with support for swagger1

2.9.0 will be the last supported release for Java 6/Java 7. Much of 2.9.0 will focus on Improvements in the model rendering thanks to @MaksimOrlov! 🙇 (support @JsonView, better support for rendering the same models in request/response, inheritance support). Please note the deprecation warnings to prepare for breaking changes in 3.0.0.

Pull Requests

(#2178) Change regex in Paths.java to handle expressions/constraints correctly @nobe0716
(#2174) fix fmt maintenanc @silenceshell
(#2169) Swagger ui 3.x suggested improvements feature @kasecato
(#2160) Fix conversion of byte to integer with max / min bug @avdv
(#2153) Upgrading Swagger UI to 3.7.0 @kasecato
(#2144) Allow ApiModelProperties on methods to be discovered from superclasses @RoyJacobs
(#2106) Add support for exclusive ranges handling @filiphr
(#2103) Fix some tests under windows @apixandru
(#2101) Fix Remapping issue @apixandru
(#2081) Fix child expansion context creation bug @gzsombor
(#2069) Optimise HandlerMethodResolver.getMemberMethods maintenance @simongajdosech
(#2066) Added error handling around "duplicate" request handlers @mate1983
(#2048) Support explicit ordering for Tags @jroweboy
(#2040) Use Guava 20.0 throughout the project maintenance @Thunderforge
(#2014) Fix markdown @koppor
(#2013) Fixed merging headers from the already existing request with the supplied request @pvanassen
(#1988) custom the web page title as swagger.title when had set it @rainplus
(#1974) Add default property support on model properties feature @matrosovs
(#1956) @ApiModelProperty example string does not escape char "" from JSON example @heapifyman
(#1952) Fix to recognize @Param as query parameter in EntitySearchExtractor know @viruscamp
(#1943) Wrong API resource path in Swagger 1.2 @mathieuales
(#1942) Model classes having names containing integers are not detected as array @mathieuales
(#1917) Consumes / Produces media-types on the document level aren't copied and merged anymore with the operation level consumes / produces media-types. @mzeijen
(#1914) Provide proprty pattern annotation support @simonamc
(#1897) Correct spelling and typos @naXa777
(#1878) Preserve tags order in documentation builder @rainoko
(#1868) Create EntitySaveExtractor.java @jadhavsuhas
(#1838) Fix a mixed up part in the Getting Started guide for Docket @PeterWippermann
(#1837) Minor update of Docket's JavaDoc @PeterWippermann
(#1829) JacksonEnumDeterminer to handle JsonFormat.Shape.Object @yelhouti

Features

(#2177) Paths.sanitizeRequestMappingPattern fix @nobe0716
(#2139) Should support "title" property, set via @ApiModel annotation. @ngbalk
(#2088) @ApiParam(allowableValues = "range(0, infinity)") does not work @filiphr
(#2063) Added support for Pageable resolved parameter @avillev
(#2057) Swagger-ui don't render additionalProperties duplicate @deblockt
(#2026) Produces/Consumes do not maintain order @jgaribay21
(#2023) Is it possible to disable globalResponseMessage configuration partially. duplicate @dohoon
(#2021) @ApiModelProperty.allowEmptyValue = true/false does not emit "allowEmptyValue" in swagger.json @bill
(#2000) Upgrade to latest version of Swagger UI (3.1.5) duplicate @madheshr
(#1960) Upgrade to swagger-ui 3.0 duplicate @alex
(#1957) springfox doesn't work with spring boot 2.0 and spring data Kay-RC2 duplicate @shashankitmaster
(#1955) Add support for inclusive and exclusive ranges for allowable values @JohnNiang
(#1946) collectionFormat problem @vitek499
(#1936) configuration for adding dynamic api-key(access token value). duplicate @akashgupta08
(#1919) Add support to rename ApiModel property name in Model Attributes @peterjurkovic
(#1901) Pattern Bean Validations API (JSR-303) support for Request Parameters help wanted @simonamc
(#1900) Tag custom ordering @rainoko
(#1818) JsonFormat for enum and other cases @yelhouti
(#1729) Status of support for v3.0.2 of Swagger UI duplicate @JLLeitschuh

Maintenance

(#2161) How to set a default value to a field of a model? in progress @michele
(#2093) swagger-ui.html appears to be empty documentation @silentsnooc
(#2090) When using AlternateTypeRuleConvention ApiModelProperty annotation does not work @snimavat
(#2031) How to get object in response body in autogenerated swagger.json file documentation @rajat
(#2029) ApiImplicitParam with empty datatype fails when we try it out documentation @ljp510016132
(#1995) View APIs from different Spring Cloud Instances registered in Eureka documentation @s
(#1971) Vavr/Javaslang Jackson module support documentation @Sir4ur0n
(#1954) Multiple swagger JSON's in swagger-ui.html documentation @dreambrother
(#1950) Document support customized param using HandlerMethodArgumentResolver documentation @neil4dong
(#1916) Consumes and produces media-types defined on Docket are incorrectly merged together with consumes/produces media-types that are defined on a resource level @mzeijen
(#1913) Space getting added to oAuth scope while making authorization request documentation @mojaiq
(#1904) Nondeterministic output for Models used in multiple controllers documentation @kevinm416
(#1899) Upgrade libraries @dilipkrish
(#1896) Wrong spelling and typos in code @naXa777
(#1882) @RepositoryRestResource -- ApiParam definition for the JPA methods always defines the @Param as "body" type parameter @aniruthmp
(#1875) Tags should be orderable @rainoko
(#1870) The lasted version supported for Swagger UI 3.x? @maliqiang
(#1865) Can't test the configuration 404 not found documentation @pinkyjain26
(#1833) Different guava versions in dependencies @Dimok74
(#1704) Document springfox oauth2 documentation duplicate @kidshg

Bugs

(#2165) AlternateTypeRules doesn't work as expected @crmky
(#2148) 2.7.1-SNAPSHOT NullPointerException when attempting to view http://localhost:8080/v2/api-docs @beardy247
(#2138) java.util.Optional<java.time.OffsetDateTime> disappears from request params duplicate @bohdan
(#2135) No qualifying bean error when launching spring 5.0.x application with springfox duplicate @gauravphoenix
(#2133) Optional @kitsjory
(#2132) @ApiModelProperty has no effect on some variables (name starting with one lowercase) not-reproducable @bbrenne
(#2118) Request type mapping doesn't work if using both RequestBody and ModelAttribute on the same parameter @andrea
(#2114) @RequestParam and @PathVariable annotated parameters should not be expanded @loxal
(#2111) Application startup failed org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'documentationPluginsBootstrapper' @shobhit921
(#2107) @ApiParam ignores certain properties duplicate @milosonator
(#2097) Swagger 2 : Getting "type": "ref" when using @RequestPart duplicate @jrishabh198
(#2096) @ApiParam is ignored on ValueObjects wrapped with @JsonCreator @dkellenb
(#2080) NullPointerException in handlerPackage duplicate @ejuniorasas
(#2072) Springfox generates Api-Doc for non-exported Repositories @stoetti
(#2053) @PathVariable work with Parameter Converter strangely duplicate @cxl086
(#2039) Endpoints with the same path and parameters but different headers some times cause java.lang.IllegalArgumentException: Multiple entries with same key @joaoacmota
(#2025) SpringFox-Data-Rest 2.7.0: Missing camelCase with generated Associations operationIds @stoetti
(#2015) Add support for generics not-reproducable wontfix @raderio
(#2012) Duplicated swagger.json document not-reproducable @cesartl
(#2011) OperationBuilder mergeResponseMessages overwrites headers @pvanassen
(#1999) Generated JSON for endpoints with PathVariables converted to non-trivial objects is incorrect duplicate @joel
(#1998) PathVarible composed of Custom Objects are not parsed correctly duplicate @frbo42
(#1965) @RequestPart annotation not rendering models correctly @pratapyelugula
(#1963) Spring Data Rest Integration doesn't document repository method parameters correctly @thombergs
(#1961) Springfox - Authorization value didn't update after Authorize confirmed.. @thomasharin
(#1941) swagger-ui does not remove java string escape char "" from @ApiModelProperty example @heapifyman
(#1932) BasePathAwareController docs aren't base path aware @fquinner
(#1926) Can't be filtered by ignoredParameterTypes not-reproducable @heyuxian
(#1924) Unable to define host in Swagger 1.2 @mathieuales
(#1906) Swagger shows wrong id field using Spring Data Rest duplicate @drenda
(#1894) @EnableSwagger2 breaking my unit tests not-reproducable @rawadrifai
(#1890) Can't declare Docket in multiple Configuration classes not-reproducable @lorenzobenvenuti
(#1887) @ApiResponses tag does not override default responses not-reproducable @muff1nman
(#1880) Wrong API resource path in Swagger 1.2 @mathieuales
(#1876) NullPointerException with Spring Data Rest integration @drenda
(#1866) 2.7.0 does not list PATCH methods from Spring Data Rest @jadhavsuhas
(#1864) @NotNull not working to mark field as required @sddakoty
(#1860) [Spring boot] @EnableAspectJAutoProxy cause endpoint scanning failed duplicate @jdupont22
(#1841) Overloaded method does not respect the "tag" option @jackmatt2
(#1839) Primary keys are added to path parameters for Spring Data Rest Entities POST request after upgrading to 2.7.0 @jadhavsuhas
(#1830) CORS headers disappeared after upgrading to 2.7.0 not-reproducable @gionn
(#1804) Api key input missing in swagger ui after upgrading version to 2.6.1 @prajapatkiran
(#1781) Swagger JSON generated by SpringFox shows 'Consumes' for GET and DELETE operations @dcp65
(#1672) Swagger-UI giving 405 (Method not allowed) when called not-reproducable @GarrettMosier

Photo credit Mark Summers via National Geographic

Thank you for being patient with this release. This is packed with bug fixes (over 40 of them) and over 15 new features.

Many thanks to those contributing with feature requests, questions, bug reports and most importantly helping out with pull requests. With time being such a premium, its getting harder and harder to address without the contributions of the many listed below.

Significant changes in this release

• This includes a re-write of the spring-data-rest support
• Preparation for removing deprecations that will be removed support 3.0 of Open API spec. Also this release is no longer verified as compatible with spring 3.x. Also it requires spring 4.2.x and greater
• Libraries have been upgraded especially jackson to 2.8.x and guava to 18.0

PRs (Thank you 🙇)

#1806 Update PropertySourcedRequestMappingHandlerMapping.java @OzgaRobert
#1793 [#1770] Remove the requirement for property sources placeholder @dilipkrish
#1782 Model property vendor extension @philippejulien
#1776 Fix Swagger version error in documentation @ersinciftci
#1761 Vendor Extensions for API Info and Documentation @jkgentry
#1758 Use double backtick to prevent miss parsing @naxhh
#1741 1740 @JsonUnwrapped is ignored by schema generation test @StepanLeybo
#1730 Fix a typo at the common-problems documentation file @florianrusch
#1717 Adding vendorExtensions in apiKey class @cfernandezh
#1702 Make ApiResourceController methods public @psyho
#1699 Make Swagger2Controller respect basePath even if a host is not set @asdcdow
#1693 Fix for https://github.com/springfox/springfox/issues/1653 @pjskyboy
#1667 #1666 allowableValues blank for Optional parameter @madgnome
#1660 waffle.io Badge maintenance @waffle
#1617 Updated swagger-ui version to 2.2.8 @acourtiol
#1593 OAuth2 not initialized when clientSecret undefined @gonzalad
#1589 Apply ApiParam hidden attribute to parameters @defshine
#1576 Added support for composed bean validation constraints @jamesbassett
#1371 JSR-303 for Request parameters, Fix Allowable values not displayed in Apidocs, Externalizing Api Descriptions @jfiala

Features

#1759 Support for property vendor extensions @philippejulien
#1707 Removal of "swagger-ui.html" from uri path causes swagger-ui JavaScript error @LukeHackett
#1636 VendorExtension support in ApiKey @mlstocks
#1627 Error with group handling response @marchc
#1592 OAuth2 clientSecret shouldn't be required for implicit flow @gonzalad
#1590 springfox-data-rest : Pageable not supported duplicate @tooms4444
#1544 [Feature request] JDK8 JSR310 types support @cbornet
#1497 springfox-staticdocs : Update to last swagger2markup version @orevial
#1490 Infer alternate type rules using serializers and deserializers @justcoon
#1423 @RequestParam with placeholders syntax like ${x.y} @blelem
#1413 Ability to set VendorExtensions on ApiInfo? @michael-pratt
#1367 Springfox overwrites swagger path entries with the same base path but with different content types @codecounselor
#1299 Feature Request: Upgrade swagger2markup version to v1.0.0 duplicate @fayndee
#1227 Bean Validations API (JSR-303) support for Request Parameters @jfiala
#1169 Add Support For Documenting Services In Grails Projects @dilipkrish
#1008 Models with different packages are not represented uniquely in the generated swagger document @tenstriker
#824 Support vendor extensions in operations @cbornet
#1736 Spring-Data-Rest support for property references

Maintenance

#1701 Make ApiResourceController methods public @psyho
#1694 Fixed the intermittent build failures @dilipkrish
#1675 Why generic method names are being generated for Spring Data Rest? @tahir
#1653 springfox-data-rest: 2.6.1 spring-data-rest: 2.6 RepositoryRestHandlerMapping constructor broken @cbbs
#1644 Update library to support for Spring 5 @binkley
#1628 swagger-ui 2.2.10 @IanSwift
#1621 2.6.1 breaks @Value placeholder replacement @2is10
#1505 Release process fails when updating the documentation @dilipkrish

Bugs

#1797 How to write a custom ApiListingScannerPlugin? @indrabasak
#1786 StackOverflowError In 2.6.1 @tcsw1221
#1785 @ApiOperation "response" value causing docs to ignore model annotations @bfinleyui
#1780 ConcurrentModificationException on startup with -20170420.041823-43 @gionn
#1778 javax @Valid annotation makes parameter as requestbody-parameter @jmattheis
#1775 Swagger version error in documentation @ersinciftci
#1772 BasePath can't be defined without host @astafev
#1770 SNAPSHOT breaks @Value placeholder replacement @stacysimpson
#1767 Unable to implement and use ApiListingScannerPlugin @stacysimpson
#1749 Error resolving $ref pointer for input DTO @gionn
#1746 How to override API-Documentation of generated endpoints (spring-data-rest) @florianrusch
#1734 swagger ui not showing the default parameter value zero @liudonghua123
#1732 Default value of "supportedSubmitMethods" in springfox.js @thadc23
#1727 Jackson required/optional @raderio
#1726 @Size is not working @raderio
#1725 If you have both Read and Write operation in single Controller readOnly do not work. But if only Write it works. @dzmitryhil
#1724 Swagger methods in multiple groups being renamed @nitin02
#1708 @EnableSwagger2 interfering with application configuration. @rycentious
#1706 X-Forwarded-Port NumberFormatException: For input string: "443,443" looking-for-contributions @sixcorners
#1698 [BUG] custom swagger endpoint returns a 404. Default endpoint works. @ahatzz11
#1697 Problem with direct model substitution @cbornet
#1677 OAuth2 request adds vendorExtension scope to all auth requests @pmlido
#1676 Invalid attributes that starts with x or y @isolisduran
#1670 Question: how to use @ApiParam annotation on a parameter defined in an interface? @taxone
#1666 AllowableValues blank for Optional parameter @madgnome
#1651 ResponseHeaders do not preserve lexical ordering question @ahatzz11
#1648 Operation ordering is not working @neil
#1632 Invalid response model for class with name "File" @dreambrother
#1623 Swagger annotations like @ApiParam, @ApiOperation annotation work for Spring Data Rest operations @taxone
#1615 api_docs shows content but swagger-ui (2.6.1) is empty @StefanSchubert
#1613 HTML code in API description in ignored using springfox-swagger-ui 2.6.1 @anouarchattouna
#1605 Response with a byte array does not work as expected @maukito
#1603 StackOverflowError on swagger generation @jmattheis
#1597 @ApiParam value is not respected @sta
#1594 IndexOutofBoundException when using unbounded Map models @sac10nikam
#1588 springfox-data-rest : @Param annotation not supported @tooms4444
#1580 Can't expand the operation when I set @Api tags by chinese wontfix @letorn
#1571 2.6.1 Cannot read property of custom enum list @jearton
#1569 When using ApiKey "keyname" is mapped incorrectly in progress @jmattheis
#1507 Broken basePath with AbstractPathProvider in version 2.5.0 of springfox-swagger2 @danielbcorreia
#1435 Setting a Custom basePath Requires Setting a Static Host in 2.5 looking-for-contributions @asdcdow

Photo courtesy National Geographic

A big thank you for reporting bugs and

Pull Requests 🙇

• (#1546) Add native support for jdk8 jsr310 date types @cbornet
• (#1529) Suggested fix for "Adding Models using ApiImplicitParam #468". Allow… @jimhooker2002
• (#1517) Added bean validation support for @DecimalMin/@DecimalMax and made the min/max values explicit @jamesbassett
• (#1515) Added conditional PropertyPlaceholderConfigurer bean @dilipkrish
• (#1341) Adding @Past/@Future support to Bean Validators @boeboe

Features

• (#1535) Class Support for @ApiImplicitParam @jimhooker2002
• (#1523) Make Swagger UI XmlHttpRequest timeout configurable? @neildcruz19
• (#1521) Remove defaults for min / max in MinMaxAnnotationPlugin @jamesbassett

Bug Fixes

• (#1531) UI configuration problem when not using jackson @yangyang0507
• (#1562) IndexOutOfBoundsException in ModelMapper @lhanson
• (#1558) Coercing Optional to String @kevinm416
• (#1555) Dead circulation @evencht
• (#1554) spec violation: springfox generates json without parameter type for @RequestParam Map<String, String> wontfix @nikit
• (#1553) After updating to 2.6, stack overflow exception is occured @HanDDol
• (#1550) Custom endpoint not working @raderio
• (#1542) @EnableSwagger2 forces microservice to register as UNKNOWN to registry @martin3361
• (#1540) ApiImplicitParams documentation lacks Model and Model Schema for user-defined types @richmeyer7
• (#1538) SpringDataRestConfiguration ModelAttributeParameterExpander StackOverflowError @mpostelnicu
• (#1532) SpringFox and Eureka failing @sundarsy
• (#1528) The service does not work after using Swagger 2.6 in Spring Cloud @puras
• (#1525) 2.6.0 breaks the swagger documentation link @apixandru
• (#1514) Properties are not read anymore (regression) @cbornet
• (#1513) Respect ApiModelProperty(hidden=true) on @ModelAttribute annotated models, Cycles in Java classes cause infinite loop has-workaround @leelance
• (#1508) Update overrides the default behavior for the PropertyPlaceholderHelper @apixandru

The one where spring data rest support lands!

The one that you've all been waiting for :)

image courtesy @SWildlifepics

This is the initial support, its is still rough would love to have feedback to improve support.

PR's

Thank you for all your contributions!

• (#1498) Add pathsGroupedBy configuration of Swagger2Markup @orevial
• (#1492) Intermediate push @davidnewcomb
• (#1486) remove duplicate enum values @apixandru
• (#1483) Update common-problems.adoc @qwang1990
• (#1477) Initial support for spring-data-rest @dilipkrish
• (#1476) Fix mistype in documentation @mvpotter
• (#1474) Merge method-level and class-level @ApiResponses annotations. @sworisbreathing
• (#1470) Supporting for hidden attribute of @ApiParam and @ApiModelProperty annotations. @MaksimOrlov
• (#1469) Fixing java.sql.Date to be a date in swagger instead of date-time @mtalbot
• (#1463) Add 'example' in merged model @wssccc
• (#1456) java.sql.Date should become a "date" in JSON Schema output, according to docs @ssevertson
• (#1448) Update to use swagger2markup version 1.0+ @ssevertson
• (#1445) upgrade to swagger-ui 2.2.0 @kevinchabreck
• (#1388) S3 maven repo @jongo593
• (#1386) #1373 - Modified how to set jsonEditor parameter @miborra
• (#1350) Complex type support by @ModelAttribute @MaksimOrlov

Features

• (#1494) Define a reason for applying @ApiIgnore @gdrouet
• (#1465) Type-level @ApiResponses are ignored looking-for-contributions @sworisbreathing
• (#1444) Support for rendering parameters and model attributes when no annotations are present @tianchengbaihe
• (#1412) Mixing string and Properties parameters causes display error in 2.5.0 has-workaround @rherrick
• (#1395) Swagger ui dose not work when @RequestParam annotation dose not set to method parameter @azizkhani
• (#1335) Ability to add custom ApiDescriptions not described via request mappings @romanwozniak
• (#1294) Utilize the jackson property definition to determine additional model information @dilipkrish
• (#1286) Make 'supportedSubmitMethods' configurable to enable and disable the "Try it out!" functionality @mibeumer
• (#1271) @ResponseHeader description not generated in apidocs @basvanstratum
• (#1137) Support VendorExtensions described as swagger schema @MinosPong
• (#1021) Add @JsonFormat support for date and time @YLombardi
• (#699) Integration with Spring-Data-Rest @raranzueque

Bug fixes

• (#1504) "infinity" in allowableValues property of @ApiModelProperty annotation @SomeoneToIgnore
• (#1485) Remove duplicate values in enum displays (case insensitive) @apixandru
• (#1475) Map<LocalDateTime, List> not displayed correctly @jlaugesen
• (#1440) Springfox expects _links to be array, while Spring hateoas return _links as object @jiangchuan1220
• (#1436) Explicit value JsonProperty ignored when PropertyNamingStrategy is configured not-reproducable @mborkunov
• (#1420) Result of adding tags to docket in swagger configuration @ChrisHartman
• (#1380) ApiResponses can not support custom status code such like 1010 @dockerlet
• (#1361) Request header "Content-Type" is not being sent with request wontfix @manish2aug
• (#1353) RequestParam with a map crashes swagger-ui wontfix @BryceMehring
• (#1346) @ApiIgnore is not respected on a method @ben

Photo courtesy: https://twitter.com/swildlifepics/status/736672399958114304

Features

• (#1296) Support for JSR-303: @Pattern annotation @ashutosh-shirole
• (#1291) Make 'supportedSubmitMethods' configurable in springfox-swagger-ui @thomseno
• (#1287) Feature: Headers in @RequestMapping are not documented @ry4n-sc0tt
• (#1244) @ApiParam - Allowable values not displayed in Swagger API docs @jfiala

Bugs

• (#1325) Missing @RequestParam on a boolean parameter causes Swagger page to not render that controller, and all controllers alphabetically after has-workaround @Thunderforge
• (#1321) Cannot fully change swagger and swagger ui path has-workaround @nikit-cpp
• (#1133) Respect ApiModelProperty(hidden=true) on @ModelAttribute annotated models has-workaround @cm325
• (#1317) @ApiModelProperty(value="something") on bean annotated with @ModelAttribute changes dataType to "ref" @mpostelnicu
• (#1310) 'enum' query parameter type(annotated with @ModelAttribute) is 'ref'. @namkee
• (#1306) Maps as parameters were not rendered correctly @aqlu
• (#1285) dataType="file" is not working in springfox 2.4.0 @HDBandit
• (#1282) Missing model definitions in swagger json document when return type is array syntax (CustomModel[]) @namkee
• (#1280) @ApiModelProperty.position not respected @marceloverdijk
• (#1268) Compatible issue encountered with Spring Boot 1.4.0.M2 and Spring 4.3.RC @hantsy
• (#1260) Not working proper with query params not-reproducable @Gaurav-Deshkar
• (#1258) Fields not visible from children when implementing interfaces in parent request objects @stashthecode 2 of 2
• (#1249) Bug: Templated url are submited with the template part @anthofo
• (#1241) Overloaded method resolution was incorrect causing ArrayIndexOutOfBoundsException @tdeverdiere
• (#1238) Swagger UI showing incorrect URLs @martin3361
• (#1211) ApiParam allowableValues string with spaces @pvpkiran
• (#1209) Query parameters - complex data types are coerced to 'string' type, especially collections @jkasmann
• (#1207) CachingModelPropertiesProvider - NullPointerException @bharatkaushik
• (#1203) swagger-ui location /configuration/ui configurable? @flexguse
• (#1196) Springfox not emitting attributes for definitions with some kinds of circular references @benfowler

PRs

• (#1331) Fix for #1282: Array dependent types not part of models @namkee
• (#1319) Fix for #1318: fixing favicon images urls @rubencepeda
• (#1316) Fix for #1296: Adding Pattern annotation support @ashutosh-shirole
• (#1314) Fix for #1296: Support for JSR-303: @Pattern annotation @igor-sokolov
• (#1233) Fix for #1207: Skip events from child application context @praveen12bnitt
• (#1295) Make 'supportedSubmitMethods' configurable in springfox-swagger-ui / Enable and disable the "Try it out!" functionality @thomseno
• (#1292) Added support for documenting headers in @RequestMapping @ry4n-sc0tt
• (#1284) Fix for broken contributing link in README @ry4n-sc0tt
• (#1277) Set encoding to utf-8 for multilanguage support. @catinred2
• (#1275) Added message about starring the repository maintenance @dilipkrish
• (#1265) Don't include a license object when both license and licenseUrl are e… @wgreven-ibr
• (#1239) Fix for the context refresh ordering issue. Support for spring-cloud brixton @dilipkrish
• (#1218) Only encode the API key when passed in URL query @franklloydteh
• (#1217) adds basePath from x-forwarded-prefix for reverse proxy scenarios @matonthecat
• (#1213) Fixed some wrong asciidoc typos @RobWin

Maintenance

• (#1332) Support for jdk 8 build @dilipkrish
• (#1326) Simplify the gradle build @dilipkrish
• (#1322) Copyright check for license should allow for newer years @dilipkrish
• (#1276) character encoding error in springfox-staticdocs @catinred2
• (#1275) Added message about starring the repository PR @dilipkrish
• (#1253) BeanPropertyDefinitions not compatible with Jackson 2.7.x @Stephan202
• (#1162) java.sql.Date creates an useless "Date" definition @cbornet

Not to mention all the questions and suggestions by the community!! 🤘

©️ Image courtesy of Richard Spiller@flickr

Features

(#1145) Generated file is not compatible with Swagger specification if method parameter is Object and is used as path parameter @tjuchniewicz
(#1122) Default page served isn't configurable and lacks search / listAll functionality @porcoesphino
(#1087) Change hardcoded "api_key" @JulianaRed
(#1061) Add support @RequestParam of type Map<String, String> @matias2681
(#1046) Control over swagger contact object @smwurster
(#1037) Add support for multiple allowable values @smwurster
(#1023) Provide a method for Model Properties to by sorted by configurable methods @nickpanaiotov
(#969) Support alternate type resolution for @ModelAttribute annotated model fields @ejain
(#937) Add support for @ResponseHeader @MarkVanVenrooij
(#936) Add support for adding global tags to the docket @dilipkrish
(#735) Support for adding additional models for request or response that are not inferred from operationshas-workaround @cabbonizio
(#388) @ApiParam not working on Interface method declarations @charleslieferando
(#356) Support for JSR-303 (Java Bean Validation) @omayevskiy

Bugs

(#1194) Swagger-ui does not render correctly in safari
@dilipkrish
(#1193) NPE when Feign, Swagger and Spring Security are used - Brixton.BUILD-SNAPSHOT @varghgeorge
(#1186) Unwanted class with map of map attribute @cbornet
(#1174) Doc: includePatterns does not exist (anymore?) can-use-for-docs @vorburger
(#1147) Using parameterized types using Void resulting in invalid Swagger @nigelsim
(#1132) Api operations on abstract superclass not affected by @API tags @gionn
(#1129) Swagger2Controller.getDocumentation get IndexOutOfBoundsException @yqzhan2014
(#1127) Setup base URL after Swagger UI is initialized #1126 @chornyi
(#1126) Race condition and crash on Swagger UI startup @chornyi
(#1125) Service description has no api's as the path regular expression does not match any of the service @irfandawood
(#1051) Customised ObjectMapper not recognized @milanov
(#953) NullPointerException when extending controller classes with multiple parameterized types @woemler
(#902) @ApiImplicitParam: "array" dataType is getting resolved into "type":"ref" @anny-ts

Maintenance

(#1180) Supply the text values for `@ApiOperation, @ApiResponse, @ApiParam, @ApiModelProperty from an external resource file, instead of hardcoding? @joetconcur
(#1168) Changelog not being updated question @jayanderson
(#1161) Update documentation for JSR310 and Joda dates @cbornet
(#1142) Fix the reference document not showing versions correctly in the gh pages @dilipkrish
(#854 ) Rework the ModelRef design to not be a hacky project of the swagger models @dilipkrish

A BIG thank you 🙇 for all the questions/issues/comments and contributions to make this a better product!

PRs in this release!

(#1189) Allow extension of ApiResourceController by making its methods public @gmarziou
(#1165) ParameterDefaultReader in swagger does not honor other annotations usage of DefaultValue @ctruzzi
(#1163) Updated the Docket XML Configuration Documentation @kellydavid
(#1159) Add basic Bean validation api (JSR-303) support @jfiala
(#1127) Setup base URL after Swagger UI is initialized #1126 @chornyi

Maintenance

• Remove runtime dependency on spring-hateoas #1104
• Fix the accidental reference to java.util.Objects class so that java 6 is still supported
• Upgraded gradle to 2.10
• Upgraded to swagger 1.5.5
• Fix Documentation Formatting
• Upgraded jdk to 8 for building
• Upgrade Classmate to 1.3.1 #1079
• Document use of google guava in code examples #1117

Pull Requests

• v2/api-docs does not support application/json media type by default #1110
• Add support for api model property positions. feature PR #1101

Bug Fixes

• Could not define global consumes and produces set #1115
• Support for showing controller methods with defaulted @RequestMapping#params values with different values is incorrect #1114
• Better Support for 2 dimensional arrays #956

Big thank you to @wxjlibra, @abaile33 for reporting bugs and Thanks @sbuettner and @vmarusic for the PRs!

2.3.0 Release notes

Full Changelog
As usual thank you for all your PR's, questions and support. Special thanks to @RobWin for also hanging out on the gitter channel and helping answering questions!

Highlights of this release are:

• Stable spring 3.2.x support, Spring 4.2.x compatibility and spring boot 1.3 support
• Global operation parameter configuration
• Ability to supply examples
• Better swagger-codegen support for generating unique method names
• swagger-ui configuration options and stability
• Docket level overriding of host name

Features:

• Disable appending of Using #1066
• @ApiModelProperty example field is ignored #998
• Configuration for global Operation-Parameters #845
• OAuth password grant_type support #789

Pull requests from the community: 🙇

• Updated Swagger2Markup version to 0.9.1 #1065 (RobWin)
• Fix issue #767, duplicate @JsonProperty #1045 (glarfs)
• Fixing logging error #1042 (AndreTurgeon)
• Added a fix for 'example' field in @ApiModelProperty annotation #1041 (jrhowell)
• Fix 2 minor typos in the documentation #1013 (erikthered)
• Add host() method to docket #1011 (cbornet)
• Springfox #845: Configuration for global Operation-Parameters. (Documentation) #1005 (GitVhaos)
• fix javadoc #1002 (n0mer)
• Fix handling of RequestMapping that include regex with quantifier(s) #993 (erikthered)
• Proper handling of @ResponseStatus with default reason(). #970 (acourtneybrown)
• Fix generation of "schema" section for a "body" parameter to contain correct "type" & "format" #968 (acourtneybrown)
• Allow security scheme of same type in resource listing #967 (cbornet)
• Add ResourceOwnerPasswordCredentialsGrant and ClientCredentialsGrant #966 (cbornet)
• DOC - Fixing path to Swagger UI image #932 (HNygard)
• Updated swagger2markup version #930 (RobWin)
• fix async bug #1078 (rockytriton)
• Fixing typo #922 (phchang)

Bug Fixes:

• UiConfiguration setting validatorUrl doesn't actually work. #1077
• Springfox generates empty types in the definitions (which swagger-codegen struggles with) #1063
• ArrayIndexOutOfBoundsException when using custom Maps #1062
• Swagger is not compatible with Spring 4.2.3 #1055
• ClassCastException in Eclipse #1054
• Provide custom resource grouping strategy #1039
• @Api(hidden = true) does not hide #995
• Extra closing curly brace on endpoints defined with a regex containing a quantifier #991
• Multiple oauth security schemes not supported #959
• NullPointerException when extending controller classes with multiple parameterized types #953
• Regression disabling schema validator #951
• Sending API key to endpoints in request header #943
• Provide default descriptions for non-200 status codes #941
• General maintenance #939
• tags parameter in @Api is ignored by ApiOperation reader/mapper #934
• defaultValue parameter in RequestParam is ignored #933
• @ModelAttribute Generates Different Output than @RequestBody #929
• Change links in docs #928
• java.net.UUID #925
• Documentation not generated in latest versions of springfox with spring 3.x #921
• Retire ResourceGroupingStrategy in favor of the available tag support #919
• Support Java 8 "-parameters" #900
• "click to authenticate" button not clickable #870
• @RequestPart that are in the body aren't represented correctly #836
• Post release tasks #708
• DOC - Fixing path to Swagger UI image #932 (HNygard)
• Updated swagger2markup version #930 (RobWin)

Closed issues:

• How to override @RequestBody annotated method parameter description? #1069
• Content-Type not being set #1029
• Support for custom Optional class #1027
• java.io.FileNotFoundException: Jar URL cannot be resolved to absolute file path #1026
• Docket documentation #1010
• Everything on logs seem fine, but get 404 when I try to access the ui #1009
• Method with @PathVariable Map attributes being ignored #999
• Swagger produce IllegalArgumentException while using Spring HATEOAS classes #997
• Are query parameter templates for "path" entries valid? #986
• Want to convert Springfox-2.0.1 source into Eclipse Maven project #974
• @ApiResponse maps to wrong ApiModel-definition name using "globalResponseMessage" #961
• Hiding injected Spring parameters from the API #960
• How to hide a property in an @ApiModel? #955
• springfox-swagger2 dependency issue #946
• SpringMvc error #940

2.2.2 Release notes

Thank you as usual for everyone who contributed in some for or the other to make this product better!! This release sneaks in some features we're incubating to provide hypermedia support.

Features

• #866 Missing REST API descriptions in JSON @EranIsraeli
• #861 Springfox #845: Configuration for global Operation-Parameters @GitVhaos
• #834 OAUTH problem @dorukokan
• #801 Allowable Values for enumerations on response models do not render options @GitVhaos
• #766 springfox-swagger2 doesn't respect ApiModelProperty#position @olkulyk
• #755 o.s.data.domain.Pageable - automatically add @ApiImplicitParams? @steve-oakey
• #750 Same RequestMapping URL's containing different RequestParam gets overridden @rajeshkamal
• #723 Models annotated with static JsonCreator factory methods do not render properly @who
• #679 Reuse documentation across methods/types @hestad
• #675 Tags in @ApiOperation are not rendered @who
• #590 swagger2asciidoc converter @RobWin
• #293 ModelProperty doesn't have a field for Min/Max @Charlie-IAS

Bug fixes

• #911 Documentation generate empty model when input is an interface but not always @Richou
• #905 Uncaught TypeError: Cannot read property 'clientAuthorizations' of null @mongofish
• #903 fix for issue #870. "click to authenticate" button not clickable @sloppycoder
• #901 SpringFox no more compatible with Spring 3.2.x ? @Abdennebi 2.2.0
• #897 Does springfox-swagger2:2.1.2 work with Scala? @cer
• #885 Issue Related to #586 - Empty properties when using @JsonProperty but not using @JsonCreator @jreckner
• #873 @ApiModelProperty hidden not working @ wind57
• #737 Api annotation value should remain as-is @RobWin

Questions

• #916 Error while deploying on cloud foundry -::0 can't find referenced pointcut model @brajput24
• #915 ignored values in annotations @iiyam
• #910 Support for Spring Boot Management endpoints @sbuettner
• #908 Response 200 always added to POST / DELETE @tatabatyo
• #902 @ApiImplicitParam: "array" dataType is getting resolved into "type":"ref" @anny-ts
• #896 How to hide a parameter/field from an object annotated with @ModelAttribute @jmarinco
• #893 Docket.ignoredParameterTypes() removes classes completly @thomseno
• #892 Error at Spring Boot when testing @Ivan-Masli-GDP
• #889 Can I set some flag to use the non minified swagger ui for debugging? has-workaround @mrgreen7
• #874 springfox-staticdocs usage @EranIsraeli
• #872 Range not respected by swagger ui for validation @wind57
• #795 New to Springfox @Cpruce
• #914 Does swagger2 have any support for java.time introduced in java8 can-use-for-docs @zhukboh
• #912 @BeanParam-type request parameters aren't handled properly @ejain
• #909 Bad URL when using "try it out!" swagger ui functionality with RequestParam (query param) @Fabrice-Deshayes-aka-Xtream
• #907 @ApiModelProperty(allowableValues = "range[min, max]") not working @pn279j
• #899 Swagger 2.1.2 deployment Error - Error creating bean with name 'apiDescriptionReader' @GLE81
• #898 Is there a way to load my own ApiModelProperty annotation? @awenblue
• #887 Question regarding query params @rcruzper
• #882 I cannot get "definitions object" generated @lelininkas
• #880 2.1.0 - nickname not getting honored as operationId @rajeshkamal
• #877 Swagger Annotations Not Working, Using Springfox not-reproducable @samillm
• #187 Custom Schemas for Models @anthonyroach