swagger (可视化RESTful API的工具)
时间:2015-04-13 16:43:20
收藏:0
阅读:3093
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框架。
原文:http://blog.csdn.net/chuchus/article/details/45026351
评论(1)
xmdxzyf
2015-09-17 23:22:41
可以在网站(www.sosoapi.com)上试下在线表单方式编写swagger-ui对应的json哈,编辑简单而且可以在线预览和导入导出,挺方便的
共1条