Swagger是个功能非常齐全的API文档工具,现在已经非常完备了,支持多种语言,架构灵活,代码生成、UI、编辑器等工具齐全。
其开源官网可以找到所有相关的资源,他们还有一个商业性的官网。
springfox是用spring boot对swagger的封装,提供了各种开箱即用的API。
springfox的文档的文档风格是标准的spring boot生态的文档风格,文档短小精悍、简明扼要,照着文档做基本不会出问题。
注意:
Swagger最近更新比较频繁,springfox是用的相对来说比较旧的版本了。不过Swagger的API变化不是太大,如果不是特别着急,可以等springfox更新,着急的话,可以自己基于springfox的源代码更新到新版本的swagger,工作量不大。