Swagger 2——@ApiOperation注解、@ApiModel注解、@ApiImplicitParams注解、@ApiImplicitParam注解无效解决方案
问题描述
Spring MVC REST API使用springfox-swagger2。swagger一切都可以正常工作,但是我的问题是我无法在我的swagger文档中添加其他信息。
@RestController
@RequestMapping("/persons")
public class PersonController {Logger LOGGER = LoggerFactory.getLogger(PersonController.class);@RequestMapping(value = "/{id}", method = RequestMethod.GET, headers = "Accept=application/json")@ApiOperation(value = "doStuff", response = Person.class)@ApiImplicitParams({@ApiImplicitParam(name="Authorization", value="MY DESCRIPTION")})public @ResponseBody Person getPerson(@PathVariable String id,@RequestHeader(value = "Authorization") String authToken) throws Exception {//do things and return}
}
@ApiOperation注解、@ApiModel注解、@ApiImplicitParams注解、@ApiImplicitParam注解无效

Maven
io.springfox springfox-swagger2 2.9.2 io.springfox springfox-swagger-ui 2.9.2
解决方案
DocumentationType
Docket构造函数中使用DocumentationType.SWAGGER_2,而不是DocumentationType.SPRING_WEB
@Bean
public Docket customImplementation() {return new Docket(DocumentationType.SWAGGER_2).select().apis(RequestHandlerSelectors.any()).build().apiInfo(apiInfo());
}

参考文章
https://stackoverflow.com/questions/35504101/springfox-swagger2-apioperation-not-working
https://github.com/springfox/springfox/issues/388
https://bbs.csdn.net/topics/392517922?list=18355447
本文来自互联网用户投稿,文章观点仅代表作者本人,不代表本站立场,不承担相关法律责任。如若转载,请注明出处。 如若内容造成侵权/违法违规/事实不符,请点击【内容举报】进行投诉反馈!
