服务器之家:专注于VPS、云服务器配置技术及软件下载分享
分类导航

PHP教程|ASP.NET教程|Java教程|ASP教程|编程技术|正则表达式|C/C++|IOS|C#|Swift|Android|VB|R语言|JavaScript|易语言|vb.net|

服务器之家 - 编程语言 - Java教程 - 解决swagger2.9.2接口文档显示的问题

解决swagger2.9.2接口文档显示的问题

2021-09-15 13:34jey_4 Java教程

这篇文章主要介绍了解决swagger2.9.2接口文档显示的问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教

swagger2.9.2接口文档显示

swagger版本:2.9.2

框架:springboot2.1.2

当没有使用

@ApiImplicitParam和response=Resp.class时,swagger会自动去显示接口入参对象的各属性,及响应的对象属性,如下图:

解决swagger2.9.2接口文档显示的问题

解决swagger2.9.2接口文档显示的问题

解决swagger2.9.2接口文档显示的问题

而如果加入@ApiImplicitParam和response=Resp.class时,则没有任务字段属性显示,如下:

解决swagger2.9.2接口文档显示的问题

所以建议,当接口的入参为几个字段属性时可以加上@ApiImplicitParam进行描述,如果是对象,则只要在该 VO对象用@ApiModel和@ApiModelProperty进行注解后,在接口方法上就不需要加@ApiImplicitParam了,swagger会自动进行解析。

解决swagger2.9.2接口文档显示的问题

Spring Boot整合swagger2.9.2版本出现的小问题

访问接口文档地址时,单个应用能正常访问swagger-ui.html页面

但F12看到请求接口有报错:

解决swagger2.9.2接口文档显示的问题

但因为在gateway网关进行了各个服务的接口文档聚合,所以在gateway访问时一直报错,因此最后只能降版本,讲到Swagger2.8.0版本。

然后请求时相比2.9.2版本少了两个请求:

解决swagger2.9.2接口文档显示的问题

这算是2.9.x版本的一个小问题吧,可以看github提交的问题

以上为个人经验,希望能给大家一个参考,也希望大家多多支持服务器之家。

原文链接:https://blog.csdn.net/Javamine/article/details/89961048

延伸 · 阅读

精彩推荐