如何实现Springboot项目与Swagger2的在线文档集成？

本文共计2093个文字，预计阅读时间需要9分钟。

SpringBoot集成Swagger2在线文档+什么是Swagger？+我们在开发时经常会创建Restful风格的API接口，供第三方或前端人员使用。那么前端人员在使用的流程中如何知道有哪些接口呢？

SpringBoot整合Swagger2在线文档

一 什么是swagger？

我们前面有讲到说开发时会创建Restful风格的API接口，供第三方或前端人员使用，那么前端人员在使用的过程中怎么知道有哪些接口呢。这个时候可以通过写接口文档来解决，但不同的程序员写出来的可能不一样，前端经常抱怨后端给的接口文档与实际情况不一致。后端又觉得编写及维护接口文档会耗费不少精力，经常来不及更新。无论是前端调用后端，还是后端调用后端，都期望有一个好的接口文档。如果能有工具帮我们能规范接口文档，最好能自动帮我们生成接口文档就好了。于是生成在线文档的工具就是 swagger就产生了。

1、什么是Swagger ？

Swagger是一款开源工具，依据OpenAPI规范（OpenAPI Specification，简称OAS）可以帮助你设计，构建，生成文档，调用REST APIs。

2、Swagger优点

1.号称世界上最流行的Api框架；2.RestFul Api 文档在线自动生成工具，Api文档与Api定义同步更新（写完代码文档就实时更新）3.可以直接运行，可以在线测试Api接口；4.支持多种语言（java，php等）

二 Springboot中怎么整合Swagger2

Swagger工具既然这么好用，那么我们就来看一下在SpringBoot中怎么整合Swagger。

Swagger的工具很多，但SpringBoot中整合Swagger主要是使用Swagger来构建强大的Restful文档。