Springfox 2.5.0 发布了,Springfox的前身是swagger-springmvc,是一个开源的API doc框架,可以将我们的Controller的方法以文档的形式展现。 改进日志如下: 新特性: (#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 该版本完整发布说明。 Springfox 2.5.0 发布下载地址