Swagger概念
传统API文档管理缺点:
对API文档更新时需要通知前端人员,导致文档更新交流不及时,API接口返回信息不明确
缺乏在线接口测试,需要使用额外的API测试工具:postman,SoapUI...,支持在界面测试API接口功能
及时更新: 在开发工程中编写好注释,就可以及时更新API文档
整合简单: 通过添加pom.xml依赖和简单配置,内嵌于应用中就可同时发布API接口文档界面,不需要部署独立服务...,Swagger是在每个服务进行集成的,需要将整个微服务中的Swagger进行合成到同一台服务器上:
使用Zuul+Swagger实现
使用Nginx+Swagger实现,以项目类型跳转到不同的接口文档...使用Zuul+Swagger实现微服务整个API接口文档的管理
SpringBoot中支持对Swagger进行管理,只需要在Zuul网关中添加对应服务的Swagger文档即可
原理: 每个独立服务都会集成...依赖swagger-spring-boot-starter
2.配置文件,可省略不写:
(swagger.base-package=需要生成文档的包名)
3.在微服务的主类上标注@EnableSwagger2Doc