离线文档遇到了问题 接口里面的顺序用 @ApiOperationSupport(order = 1)可以解决但是离线文档里面的顺序并没有改变 目录和没有加注释前一样 怎么解决
使用@ApiOperationSupport的order属性可以控制接口在Swagger文档中的顺序,但是对于离线文档可能不会生效。这时候可以尝试使用手动调整目录顺序的方式来解决问题。
具体操作步骤如下:
在Swagger UI中点击右上角的“导出”按钮,选择“JSON”格式导出。
下载生成的JSON文件,并打开。
在JSON文件中找到要调整顺序的接口,修改其在tags数组中的位置即可。
保存JSON文件并重新导入到Swagger UI中,查看是否调整成功。
目前作者提供了spring boot项目和spring mvc项目两种使用方式,区别就是spring mvc需要配置更多的东西。源码和使用方法都在GitHub上,使用方法作者写的特别详细,看就完事儿。
源码地址:https://github.com/xiaoymin/swagger-bootstrap-ui
按照这上面的步骤就是:(spring boot项目)
添加依赖–>初始化配置类(写配置文件)–>启动项目访问接口文档,访问的url是doc.htm结尾的,swagger是swagger-ui.html结尾的,要注意了。