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框架。
时间: 2024-10-15 08:47:35