spring cloud+spring boot__基于swagger实现Springboot项目API文档管理

前言

1. 如果你以前没有接触过springcloud，本专栏将带你一步步实现一套分布式架构基础框架。
2. 如果你以前看过很多demo，但是无法搞清楚每一个实现步骤，本专栏将值得你看一看。
3. 如果你选择学习本专栏，那么所有遇到相关技术问题都可以联系方式我们一起探讨。

关于swagger

Swagger 是一套基于 OpenAPI 规范（OpenAPI Specification，OAS）构建的开源工具，后来成为了 Open API 标准的主要定义者，现在最新的版本为17年发布的 Swagger3（Open Api3）。
国内绝大部分人还在用过时的swagger2（17年停止维护并更名为swagger3）
对于 Rest API 来说很重要的一部分内容就是文档，Swagger 为我们提供了一套通过代码和注解自动生成文档的方法，这一点对于保证API 文档的及时性将有很大的帮助。
OAS本身是一个API规范，它用于描述一整套API接口，包括一个接口是哪种请求方式、哪些参数、哪些header等，都会被包括在这个文件中。它在设计的时候通常是YAML格式，这种格式书写起来比较方便，而在网络中传输时又会以json形式居多，因为json的通用性比较强。
Swagger 主要包含了以下三个部分：
Swagger Editor：基于浏览器的编辑器，我们可以使用它编写我们 OpenAPI 规范。
Swagger UI：它会将我们编写的 OpenAPI 规范呈现为交互式的 API 文档，后文我将使用浏览器来查看并且操作