swagger2的怎么使用这里就不说了,搜索引擎出来就有一堆一堆的资料。
现在来说下我遇到的问题:
我需要将某个定义的参数隐藏(不想在api文档中展示),资料通过可以知道,注解
@ApiModelProperty 和
@ApiParam 里面都有一个属性叫做hidden,当时很兴奋(马上将这个属性设置为了true),然后又很郁闷(我日,不生效)。
源码解释都是这样的:
/**
* Hides the parameter from the list of parameters.
*/
boolean
hidden()
default false
;
啥情况,难道还有其他地方什么属性或者注解没有设置(郁闷)。
最后在issues 找到了相关资料
???
@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,功能已经可以使用了。
这里记录下,不要让后面的人再入坑!
参考资料: