简介
号称:世界最流行的API框架
官网:http://swagger.io/
解决什么问题:在前后台分离的开发模式中,减小接口定义沟通成本,方便开发过程中测试,自动生成接口文档。
实例代码位置:https://github.com/pumadong/cl-roadshow/tree/master/roadshow-swagger
swagger使用方式
第一种
定义YAML文件,然后可以生成各种语言的代码框架,对于后台程序员来说,较少人会愿意写出一堆YAML格式。
第二种
swagger有各种语言的插件,可以通过配置及少量代码,生成接口文档及测试界面。
我们多做了:一次性的配置及少量注解代码。
我们不用再做:1、到Wiki中更新接口文档;2、Postman形式的测试;3、Curl形式的测试
swagger java使用介绍
对于一个SpringMVC项目,使用swagger的配置如下:
pom.xml
<!-- Swagger -->
<dependency>
<