Swagger是遵守OpenAPI规范（OAS）的世界上最大的API框架开发工具，可在整个API生命周期内进行开发，从设计和文档到测试和部署。它提供了许多试用的工具来帮助开发者进行接口开发，如及时接口文档编写工具swagger-editor，前端展示swagger-ui，还有代码自动生成工具swagger-codegen。
下面会分别对这些工具进行介绍，由于Swagger的版本更新较快，功能愈发强大，所以我选择了使用swagger2进行整合，并且使用java语言进行示例。
swagger-codegen自动生成代码工具的介绍与使用 --生成客户端代码
功能强大的swagger-editor的介绍与使用 --生成API文档，兼生成服务端代码
swagger-ui生成api文档并进行测试 --API文档和接口测试
如果，你只是想在你的java spring工程里使用swagger，那么你可以直接看这篇文章
Spring Boot中使用Swagger2构建强大的RESTful API文档
如果，你觉得swagger原生的ui风格不好看，想换换风格，你可以看这篇文章
Swagger 自定义UI界面
标准
OAS标准（OpenAPI规范标准） https://www.jianshu.com/p/5365ef83252a