swagger2 隐藏请求参数失败问题

时间:2022-05-01 06:48:35
swagger2的怎么使用这里就不说了,搜索引擎出来就有一堆一堆的资料。
现在来说下我遇到的问题:
我需要将某个定义的参数隐藏(不想在api文档中展示),资料通过可以知道,注解 @ApiModelProperty 和 @ApiParam 里面都有一个属性叫做hidden,当时很兴奋(马上将这个属性设置为了true),然后又很郁闷(我日,不生效)。
源码解释都是这样的:
/**
* Hides the parameter from the list of parameters.
*/
boolean hidden() default false ;  

啥情况,难道还有其他地方什么属性或者注解没有设置(郁闷)。
最后在issues 找到了相关资料
swagger2 隐藏请求参数失败问题
??? @modelatrribute 对这个spring注解目前还不支持,额,我就是想用这个注解怎么弄,哈哈,不要急往下看issues,大神已经开始解决这个问题了 https://github.com/springfox/springfox/pull/1470

需要提出的是当时我使用的是2.4.0版本,在2.6.0已经支持了 @modelatrribute 修饰参数实体使用的@ApiParam中的hidden。
ok,既然要更新,那找找最新的版本是多少吧。 http://mvnrepository.com/artifact/io.springfox/springfox-swagger2
我更新到2.7.0,功能已经可以使用了。

这里记录下,不要让后面的人再入坑! 

参考资料: