大大方便了后台开发人员与前端的沟通与联调成本。springfox本身只是利用自身的aop的特点,通过plug的方式把swagger集成了进来,它本身对业务api的生成,还是依靠swagger来实现。此文,就是记述本人在使用springfox过程中对springfox的一些理解以及需要注意的地方。如果项目MVC控制层用的是springMvc那么会自动扫描所有Controller类,跟据这些Controller类中的方法生成相应的api文档。因本人的项目就是SpringMvc,所以此文就以Srping mvc集成springfox为例来讨论springfox的使用与原理。首先,项目需要加入以下三个依赖:上面三个依赖是项目集成springmvc及springfox最基本的依赖,其它的依赖这里省略。springfox是基于spring-plug的机制整合swagger的,spring-plug具体是怎么实现的,我暂时还没有时间去研究spring-plug的原理。但在下文会提到自己写一个plug插件来扩展swagger的功能。

浅谈springfox-swagger原理解析与使用过程中遇到的坑

浅谈springfox-swagger原理解析与使用过程中遇到的坑

浅谈springfox-swagger原理解析与使用过程中遇到的坑

浅谈springfox-swagger原理解析与使用过程中遇到的坑

浅谈springfox-swagger原理解析与使用过程中遇到的坑

浅谈springfox-swagger原理解析与使用过程中遇到的坑

浅谈springfox-swagger原理解析与使用过程中遇到的坑