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