Spring MVC中使用Swagger生成API文档和完整项目示例Demo,swagger-server-api
来源:互联网 发布:java h5微信支付视频 编辑:程序博客网 时间:2024/04/30 00:25
实际项目中非常需要写文档,提高Java服务端和Web前端以及移动端的对接效率。
听说Swagger这个工具,还不错,就网上找了些资料,自己实践了下。
一:Swagger介绍
Swagger是当前最好用的Restful API文档生成的开源项目,通过swagger-spring项目
实现了与SpingMVC框架的无缝集成功能,方便生成spring restful风格的接口文档,
同时swagger-ui还可以测试spring restful风格的接口功能。
官方网站为:http://swagger.io/
中文网站:http://www.sosoapi.com
二:Swagger与Spring MVC集成步骤
1.Maven关键配置
2. 插件配置
CustomJavaPluginConfig
3.复制swagger的相关js等静态资源到webapp目录。
swagger-ui.js之类的。
我copy过一次,但是有问题,最后从网上下载了一个项目,可以直接用的那种。
然后自己再逐步改造。
4.启动项目
http://localhost:8080/
三、常见swagger注解一览与使用
最常用的5个注解
@Api:修饰整个类,描述Controller的作用
@ApiOperation:描述一个类的一个方法,或者说一个接口
@ApiParam:单个参数描述
@ApiModel:用对象来接收参数
@ApiProperty:用对象接收参数时,描述对象的一个字段
其它若干
@ApiResponse:HTTP响应其中1个描述
@ApiResponses:HTTP响应整体描述
@ApiClass
@ApiError
@ApiErrors
@ApiParamImplicit
@ApiParamsImplicit
四、关键代码和实际例子
例子1:
@ApiParam(value = "token", required = true) @RequestParam String token
Web前端/移动端HTTP请求方式:直接把参数附带到URL后面,或者用AJAX方法,表单提交。
例子2:
当参数太多的时候,需要定义太多的参数,排版看起来很不舒服。
这个时候,可以使用对象来接收。
@ApiModel(value = "用户对象",description="user2")
public class User extends CommonParam{
}
Web前端/移动端HTTP请求方式:直接把参数附带到URL后面,或者用AJAX方法,表单提交。
这里面存在一个小问题,当后端用对象User来接收参数的时候,Swagger自带的工具是这样的:
这种形式,并不是表单提交,或者把参数附加到URL的后面。
我们只能手动构造URL,附带参数去提交。
如果需要测试的话!
例子3:
Web前端/移动端HTTP请求方式:必须把参数,放到request请求的body中去。
后端不能直接用request.getParam("token")这种。
获得request body中的数据,手动转换成目标数据。
String charReader(HttpServletRequest request) throws IOException {
BufferedReader br = request.getReader();
String str, wholeStr = "";
while ((str = br.readLine()) != null) {
wholeStr += str;
}
return wholeStr;
}
个人推荐:
1.参数不多的时候,用例子1,用@ApiParam注解生成文档。
swagger可视化界面,可以直接设置参数,发送请求来测试
2.参数比较多的时候,用例子2,用对象来接收参数,在对象里针对每个字段,@ApiModelProperty注解生成文档。
swagger可视化界面,可以直接设置参数,但是无法接收到。
因此,推荐使用其它HTTP请求或POST模拟工具,发送请求,模拟测试。
不推荐例子3,不通用,局限性比较大。
五、若干截图
六、源代码
七、项目下载地址
http://git.oschina.net/fansunion/swagger-server-api/tree/master/
八、参考资料
http://blog.csdn.net/jia20003/article/details/50700736
http://www.cnblogs.com/quanyongan/archive/2013/04/16/3024741.html
http://www.cnblogs.com/h9527/p/5506956.html
http://www.cnblogs.com/yuananyun/p/4993426.html
阅读全文
0 0
- Spring MVC中使用Swagger生成API文档和完整项目示例Demo,swagger-server-api
- Spring MVC中使用Swagger生成API文档和完整项目示例Demo,swagger-server-api
- Spring MVC中使用Swagger生成API文档和完整项目示例Demo,swagger-server-api
- Spring MVC中使用Swagger生成API文档和完整项目示例Demo,swagger-server-api
- Spring MVC中使用Swagger生成API文档和完整项目示例Demo,swagger-server-api
- Spring MVC中使用Swagger生成API文档和完整项目示例Demo,swagger-server-api
- Spring MVC中使用Swagger生成API文档和完整项目示例Demo,swagger-server-api
- Spring MVC中使用Swagger生成API文档
- Spring3 MVC中使用Swagger生成API文档
- Swagger生成API文档
- Spring MVC 集成 Swagger,API文档自动生成~
- 在Spring中使用Springfox和swagger生成restful风格的API文档
- 使用Swagger,Swagger-UI生成REST API接口文档
- swagger ui和spring boot集成生成api文档
- 使用 swagger 自动生成 API 文档
- 如何使用 Grape-Swagger 生成 API 文档
- SpringMVC中使用swagger为api接口生成文档
- SpringBoot中使用Swagger生成RESTful规范API文档
- GCC编译选项
- Andoird 自定义ViewGroup实现竖向Viewpager
- Manacher's Algorithm ----马拉车算法(【USACO题库】1.3.3 Calf Flac)
- Java中测试数据库连接
- 第五题
- Spring MVC中使用Swagger生成API文档和完整项目示例Demo,swagger-server-api
- 并查集的应用举例
- java 反射
- PAT A1096. Consecutive Factors (20)
- Linux配置path
- master python for finnace 量化回测的案例
- struts2执行原理(执行流程)
- $(document).ready(function(){}) 的含义及其使用
- 菜鸟——数据结构算法2.1实现