最近安装并使用了一下Swagger-ui、Swagger-editor和Swagger-codegen,感觉还不错。
Swagger 是一个规范和完整的框架,用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。Swagger的目标是对REST API定义一个标准的和语言无关的接口,可让人和计算机无需访问源码、文档或网络流量监测就可以发现和理解服务的能力。当通过Swagger进行正确定义,用户可以理解远程服务并使用最少实现逻辑与远程服务进行交互。与为底层编程所实现的接口类似,Swagger消除了调用服务时可能会有的猜测。
Swagger是一组开源项目,其中主要要项目如下:
除了Swagger项目自身支持的Java、Scala和JavaScript语言,Swagger社区中还提供了很多支持其他语言的第三方工具,覆盖了Clojure、ColdFusion / CFML、Eiffel、Go、Groovy、.Net、Perl、PHP、Python、Ruby等各种编程语言。
Swagger这类API文档工具可以满足下列需求:
跟下列其他API文档工具相比,Swagger各有优缺点,但它功能最多、也是最流行的。
参考
Swagger官网
GitHub:Swagger
Swagger规范
SpringFox官网
GitHub:SpringFox
Spring Boot & Swagger UI