使用springfox和Swagger2时,为什么v2/api-docs是默认URL？

Question

我刚开始按照这个指南开始使用招摇,但我发现了一些非常奇怪的东西对我来说毫无意义.

据我所知,当您拥有API版本号为2的文档时,应使用v2/api-docs.

所以,默认应该只是api-docs,但由于一些奇怪的原因,我发现默认是v2/api-docs.

检查库文档我发现了这个.

如何在不能使用v2的情况下覆盖该值？(当我的API将达到v2但我也想展示旧版文档).

或许我使用v2的概念是错误的？有人可以帮我弄这个吗？

Answer 1

该/v2/api-docsURL是SpringFox用于文档的默认值.该v2不是指你的API的文档版本(可在更改Docket配置),但所使用的扬鞭规范的版本.请查看此处的文档以自定义Swagger文档URL.简而言之,您需要修改环境属性以更改文档将显示的URL:

springfox.documentation.swagger.v2.path=/my/docs

这会将SpringFox Swagger文档的默认URL更改为/v2/api-docs您指定的任何内容.要实现此功能,请将以上属性添加到新的或现有的属性文件中,然后将其作为属性源添加到Springfox配置类中:

@PropertySource("classpath:swagger.properties")
@Configuration
public class SwaggerConfig {...}