Spring Boot 2系列(三十七)：集成 Swagger2 生成 API 文档
Swagger官方宣称是最好的 API 文档构建工具，也确实好用，易用。Swagger 生成的 API 接口文档是 Restful 风格的，会自动识别传参方式( path , query , body )，参数类型等；会自动识别允许的请求方式，若接口没有限制请求方式，Swagger 则会生成 Restful 风格的所有请求(get、post、put、patch、options、head、delete)。
项目的 API 接口需要更新，需要维护，直接通过 Swagger 工具生成非常的方便，不需要维护一个单独的API文档。单独的 API 文档非常容易出错和遗漏，特别是时间长了修改的人多的情况下，更是难以保证准确性。