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
© 2014 bubuko.com 版权所有 - 联系我们:wmxa8@hotmail.com
打开技术之扣,分享程序人生!