Spring Boot 整合Swagger 2文档
在实际开发过程中,前后端分离后,那么势必存在如何在多人协作中共享和及时更新API开发接口文档的问题,维护接口文档就变成了必不可少的工作,在初期开发的时候接口一直处在变化中,每次接口更新,都要去单独维护接口文档,做过的老铁都知道这是一件多么令人脑瓜子疼得事。使用swagger2集成文档,有多个优势: 功能丰富 :支持多种注解,自动生成接口文档界面,支持在界面测试API接口功能; 及时更新 :开发过程中养成写注释的习惯,就可以及时的更新API文档; 整合简单 :通过添加pom依赖和简单配置,内嵌于应用中就可同时发布API接口文档界面,不需要部署独立服务。 引入依赖 首先是创建一个Spring Boot项目,引入web依赖,引入swagger2相关的依赖,如下: web依赖 <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> swagger2依赖 <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.9.2</version> </dependency>