swagger版本:2.9.2
框架:springboot2.1.2
当没有使用
@ApiImplicitParam和response=Resp.class时,swagger会自动去显示接口入参对象的各属性,及响应的对象属性,如下图:



而如果加入@ApiImplicitParam和response=Resp.class时,则没有任务字段属性显示,如下:

所以建议,当接口的入参为几个字段属性时可以加上@ApiImplicitParam进行描述,如果是对象,则只要在该 VO对象用@ApiModel和@ApiModelProperty进行注解后,在接口方法上就不需要加@ApiImplicitParam了,swagger会自动进行解析。
博客介绍了Swagger 2.9.2与Spring Boot 2.1.2框架的使用情况。未使用@ApiImplicitParam和response=Resp.class时,Swagger会自动显示接口入参和响应对象属性;加入后则无字段属性显示。建议入参为几个字段时加@ApiImplicitParam,入参为对象时用注解解析。
1128

被折叠的 条评论
为什么被折叠?



