初次使用Swagger 踩了不少坑,总结一下
牢记一点,Swagger全部是以JSON的格式向后台传参的
当使用Vo类接收参数,用@ApiModel标注Vo类,如果需要在Swagger页面展示出Vo的每个属性,把方法参数前的@RequestBody去掉,反之,则是以JSON对象的格式在Swagger页面输入参数
当使用多个变量接收参数,在方法的上部用@ApiImplictParams({ @ApiImplictParam(name ="",value="",paramType ="query") })
即可,paramType决定你的Swagger传递的参数后台在哪里获取
在前后端分离的情况下我浪费了很多时间改swagger的备注,因为前端模块把数据封装成了对象去请求后端,而很多时候前后端的控制层都是复制过来的。。。一般前端模块为了调试需要把参数对象的属性都暴露出来,如果直接复制到后端就会导致参数映射不上,所以后端使用@RequestBody加Vo类获取数据