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