API管理-基于SpringBoot项目集成swagger实现接口文档自动生成

1. 为什么要使用swagger？

上一次博客（API管理-使用开源xxl-api项目管理接口）中我也提到过接口文档在整个生命周期中的重要性以及使用开源xxl-api的优缺点，缺点就是没法自动完成接口文档的生成，而是手动的录入，这样的话跟我们传统的通过编写word来管理接口文档也没什么区别；而swagger却是通过开发者在编写接口的时候就已经通过指定的注解标注好接口的信息，在启动的时候swagger会自动生成对应的接口文档。

2. SpringBoot配置使用方式

• 配置pom.xml依赖

• 配置SwaggerConfig类

• 配置MvcConfig类

• 以规定的注解编写接口信息

• 启动项目、访问地址、查看接口信息：http://localhost:8080/swagger-ui.html
• 效果图

3. 总结

Swagger API 接口文档生成工具的利与弊，对于使用swagger利弊这边文章已经解释的很清楚了，虽然通过这种方式集成swagger后有一个统一的接口可以查看接口信息了，但这个springfox-swagger-ui版本的并不支持接口文档的下载以便于离线查看，还有就是原生的ui使用起来总感觉不顺手，所以又有人基于swagger的接口方式自定义开发了基于bootstrap的ui并扩展了部分功能，详细请参考博客：API管理-舍弃springfox-swagger-ui，采用功能更加丰富的swagger-bootstrap-ui。