SpringBoot 整合 Swagger
Swagger 介绍
1.什么是 Swagger
作为后端程序开发,我们多多少少写过几个后台接口项目,不管是编写手机端
接口,还是目前比较火热的前后端分离项目,前端与后端都是由不同的工程师
进行开发,那么这之间的沟通交流通过接口文档进行连接。但往往伴随很多问
题,后端程序员认为编写接口文档及维护太花费时间精力,前端的认为接口文
档变动更新不及时,导致程序之间相互调用出行问题。那么能简化接口文档的
编写直接自动生成吗?当然能!如是乎 Swagger 这种接口文档在线自动生成工
具便孕育而生。
Swagger 是一个规范和完整的框架,用于生成、描述、调用和可视化 RESTful
风格的 Web 服务。总体目标是使客户端和文件系统作为服务器以同样的速度
来更新。文件的方法,参数和模型紧密集成到服务器端的代码,允许 API 来始
终保持同步。Swagger 让部署管理和使用功能强大的 API 从未如此简单。
2.Swagger 优点
代码变,文档变。只需要少量的注解,Swagger 就可以根据代码自动生成 API 文
档,很好的保证了文档的时效性。
跨语言性,支持 40 多种语言。
Swagger UI 呈现出来的是一份可交互式的 API 文档,我们可以直接在文档页面尝
试 API 的调用,省去了准备复杂的调用参数的过程。
还可以将文档规范导入相关的工具(例如 Postman、SoapUI), 这些工具将会为我
们自动地创建自动化测试。
SpringBoot 中整合 Swagger
1.基础环境构建
首先搭建一个基础的 SpringBoot 项目,导入以下 Swagger 启动器