Swagger 获取不到参数,接口用对象接参,注解的使用等

时间:2025-03-17 07:38:12

初次使用Swagger 踩了不少坑,总结一下

牢记一点,Swagger全部是以JSON的格式向后台传参的

当使用Vo类接收参数,用@ApiModel标注Vo类,如果需要在Swagger页面展示出Vo的每个属性,把方法参数前的@RequestBody去掉,反之,则是以JSON对象的格式在Swagger页面输入参数

当使用多个变量接收参数,在方法的上部用
@ApiImplictParams({ @ApiImplictParam(name ="",value="",paramType ="query") })
即可,paramType决定你的Swagger传递的参数后台在哪里获取

在前后端分离的情况下我浪费了很多时间改swagger的备注,因为前端模块把数据封装成了对象去请求后端,而很多时候前后端的控制层都是复制过来的。。。一般前端模块为了调试需要把参数对象的属性都暴露出来,如果直接复制到后端就会导致参数映射不上,所以后端使用@RequestBody加Vo类获取数据