Swagger介绍

使用Swagger的原因：

前后端调用接口过程中，存在接口文档与实际情况不一致的问题。且强制规范随着版本迭代接口文档也很难再跟上代码的变化。

Swagger是什么？

通过规范和Swagger衍生出来的一系列项目和工具，生成各种格式的接口文档，生成过重语言的客户端和服务端代码，以及在线接口调试页面等等，能够做到调用端代码、服务端代码以及接口文档的一致性。

需要编写yml或json格式的描述文档。在通过维护这个描述文件去更新接口文档，以及生成各端代码。

Spring-Swagger项目到Springfox

通过在项目中引入Springfox，可以扫描相关的代码，生成该描述文件，进而生成与代码一直的接口文档和客户端代码。在后面需求持续迭代的项目中，显得尤为重要。

做到了代码即接口文档，接口文档即代码。

【参考文件】

1.Swagger介绍及使用  https://www.cnblogs.com/sea520/p/13195439.html.