目录:
1,Spring Boot集成Swagger
2,Swagger接口文档页面
3,常见问题和解决方法
在Sping开发REST接口服务时,API文档是不可缺少的一个重要部分。Swagger框架定义了完整的REST接口文档规范,提供了强大的页面测试功能,能够调试和可视化API接口服务,并且将文档融合到代码中,让维护文档和修改代码整合为一体,使得修改代码逻辑的同时方便的修改文档说明。
Spring集成Swagger只需3步配置,就能在线生成接口文档,调试API功能。
![93f983ed777777c895e71ef3c0b5a61e.png](https://i-blog.csdnimg.cn/blog_migrate/98f679671cf2d3de3a9b5bbf2cb8f3d9.jpeg)
代码下载:https://github.com/jextop/StarterApi/
一,Spring Boot集成Swagger
1. 在pom.xml中添加Swagger依赖
![bd5fcb6bc7e1f27e88385ccae6182f12.png](https://i-blog.csdnimg.cn/blog_migrate/e1a765f6949b9b4c48f2bbca8da234b7.jpeg)
2. 添加SwaggerConfig.java,配置文档信息和扫描包路径
![fc43640e5dde2732e225149aa2e837da.png](https://i-blog.csdnimg.cn/blog_migrate/d8b4f963696275b52887252cd5797a6b.jpeg)
3. (可选)代码中引用Swagger注解,增加接口文档。
- 不添加这些注解时,Swagger自动生成在线文档将使用默认信息。
- 修改代码功能逻辑时,同时维护文档信息。
![87460feb12ee6a38000d85eb25175e64.png](https://i-blog.csdnimg.cn/blog_migrate/d1f26d039df71d6a35ae2fb64d60b2eb.jpeg)
二,启动项目,打开文档页面
1. http://localhost:8011/swagger-ui.html
![3a82f46e85a59a592bdc5ee602a33d32.png](https://i-blog.csdnimg.cn/blog_migrate/1ea6482ee65730a2b4ac47aba65b6889.jpeg)
2. 展开API信息,点击按钮”Try it out!”,调试接口功能。
![675f28b4df75494ddffba3928b9aa12d.png](https://i-blog.csdnimg.cn/blog_migrate/d9b27fe45f0eb913545a48291889c331.jpeg)
三,常见问题和解决方法
l 增加@Api(tags={“xxx中文”}),Swagger文档页面中点击接口名称无法展开详情?
解决:在pom.xml中配置maven依赖使用Swagger2.7.0或以后版本
原因:Swagger2.7.0修复了tags对中文的支持
![584ebb7b5802cd02a3da7bea274ef956.png](https://i-blog.csdnimg.cn/blog_migrate/1f6937a2b8d8aebb3984a4916bf8c44b.jpeg)