首先，老规矩，我们在接触新事物的时候, 要对之前学习和了解过的东西做一个总结。

01

痛     苦

不做、不行

　　之前，前后端分离的系统由前端和后端不同的编写，我们苦逼的后端工程师会把自己已经写完的API接口，写一个接口文档给到我们前端工程师，前端工程师拿到接口文档之后，根据接口文档规定的URL、请求方式(POST或GET)、请求参数、返回结果(成功或失败，失败时，返回的状态分别代表什么意思)，来对接我们后端提供的API接口，如果提供的接口文档有问题，那么同样的，前端对接时，也会出现问题，前端会说是后端提供的接口文档的问题，后端觉得我可能程序更新了，没有及时更新接口文档。其实，不管是前端还是后端，都希望有一个好的接口文档，能随着程序的迭代不断更新的接口文档。

而写接口文档这种没有技术含量又苦恼的事儿，对于后端来说无疑是噩梦一般，API接口少，没几个，可能半个点一个点就完事儿了，如果API接口很多，比如说整个订单系统的接口，写接口文档这种事儿可能会耗上一天，两天，甚至三天，最后写完还不一定是对的，那个痛啊。

02

邂      逅

有痛点、抛出来

之前写API文档的方式各种各样，wiki、word、excel、text等等各种方式，万物皆可盘。

比如word：

对，word要把目录给人家定义好，要不会被喷的。
再比如excel：

        还有text：

千篇一律， 能不能再乱一点，前端已经提这40米的大砍刀在向你走来。

有没有自动生成API文档的插件呢？答：有，还自带各种插件

关于SwaggerSwagger是一个功能强大且易于使用的API开发人员工具套件，适用于团队和个人，可在整个API生命周期（从设计和文档到测试和部署）中进行开发。

Swagger由开放源代码，免费和市售工具共同组成，它使任何人（从技术工程师到街头智能产品经理）都可以构建每个人都喜欢的惊人API。

Swagger由SmartBear Software构建，后者是团队软件质量工具的领导者。SmartBear落后于软件领域的一些知名公司，包括Swagger，SoapUI和QAComplete。

在Swagger官网上提供了几种工具，可以通过集成的方式来实现我们想要的效果。

　　Swagger Inspector:类似postman的一种API调试工具，可以点击URL，查看如何使用。https://swagger.io/docs/swagger-inspector/how-to-use-swagger-inspector/。

　　Swagger Codegen:是一个开源代码生成器，可直接从Swagger定义的RESTful API构建服务器存根和客户端SDK。Swagger Codegen的源代码可以在GitHub中找到，点击URL，查看如何使用。https://swagger.io/docs/open-source-tools/swagger-codegen/。

       Swagger Editor:是一个开源编辑器，用于设计，定义和记录Swagger规范中的RESTful API，点击URL查看如何使用，https://swagger.io/docs/open-source-tools/swagger-editor/

       Swagger UI:提供了一个可视化的UI页面展示描述文件。接口的调用方、测试、项目经理等都可以在该页面中对相关接口进行查阅和做一些简单的接口请求。该项目支持在线导入描述文件和本地部署UI项目，点击URL查看如何使用，https://swagger.io/docs/open-source-tools/swagger-ui/usage/installation/

03

接     触

收入囊中

      Swagger是什么我们已经介绍完了，下面我们通过代码示例来讲解如何与Springboot结合使用。

1、引入Swagger相关jar包(Springboot相关jar自行引入)