我遇到了一个问题,代码库的某个部分在某个控制器上使用@Api,而另一部分使用swagger/springfox的@ApiModel注解。
我不确定我应该为我的控制器使用哪一个。
我对这个主题的研究使我得出结论,我应该使用@ApiModel。因为@Api有一些不赞成使用的属性(参见javadoc @Api和javadoc @ApiModel),例如description
。
在我的理解中,我错过了什么大画面?
注意,我的依赖项包含swagger-annotations
、springfox-swagger2
和springfox-swagger-ui
1条答案
按热度按时间erhoui1w1#
我认为你应该使用OpenApi 3。当你使用它的时候,你不需要这个注解,因为你在一个yml文件中声明了你的文档。你也不需要2个依赖项,只要1个就可以解决你的问题。