swagger (可视化RESTful API的工具)

时间：2015-04-13 16:44:26 收藏：0 阅读：807

swagger 是一个可视化RESTful WebService的工具。

官网：http://swagger.io

效果

下图可以看出，swagger清晰地展现了web服务的方法、地址、发送json格式与应答json格式。还可以通过它直接进行服务调用，查看结果。

技术分享

工作原理

视图部分： swagger-ui是一系列css\js资源，它通过html页面向用户展示一个应用的RESTful API信息。它通过向swagger-core后台模块发送ajax请求获取必要的信息。

后台部分：swagger-core通过 @com.wordnik.swagger.annotations.Api、 @com.wordnik.swagger.annotations.ApiOperation这样的注解，即可让swagger知道你的API信息，从而以json格式应答web页面的ajax请求。

其他工具集成

tomcat作httpServer，jersey作webService框架。