我刚开始使用swagger遵循这一指南,但我发现了一些非常奇怪的东西,对我来说没有意义。
/v2/api-docs
URL是SpringFox用于文档的默认URL。v2
并不引用API的文档版本(可以在docket
配置中更改),而是使用的Swagger规范的版本。请查看这里的文档,以自定义Swagger文档URL。简而言之,您需要修改环境属性以更改文档将显示在的URL:
springfox.documentation.swagger.v2.path=/my/docs
这将把SpringFox Swagger文档的默认URL从/v2/api-docs
更改为您指定的任何URL。要实现这一点,请将上述属性添加到新的或现有的属性文件中,然后将其作为属性源添加到您的Springfox配置类中:
@PropertySource("classpath:swagger.properties")
@Configuration
public class SwaggerConfig {...}
问题内容: 我只是按照本指南开始使用swagger ,但是我发现一些非常奇怪的东西对我来说毫无意义。 据我所记得,当您拥有API版本号2的文档时,应使用v2 / api-docs。 因此,默认值仅应为api-docs,但出于某些奇怪的原因,我发现默认值为v2 / api-docs。 检查库文档,我发现了这一点。 如何覆盖该值,而以后又无法使用v2?(当我的API达到v2,但我也想显示旧版文档时)。
我有一个带有springfox swagger 2.9.2的springboot应用程序,对于我的一个微服务,在swagger文档中生成的swagger基url在末尾添加了“/v2/api-docs”,似乎没有明显的原因。 下面是我的应用程序属性文件的样子 我有一种感觉,我错过了一些愚蠢的东西。
首先,我的声明是: 我的主要活动获取编号和文本: 我的Activity2应该得到数字和文本: 文本很受欢迎,但数值始终为0。
我尝试使用@api和@apimodel来重命名我的api引用,但似乎什么都不起作用。它总是使用类名。Im使用swagger2+springfox 2.4+Springboot。
为什么springfox-swagger2 UI告诉我据我所知,我使用的是典型的Swagger spring-boot配置。 正如您在屏幕截图中看到的,支持UI的swagger-fox url是example.com/api。注意:当我导航到:https://localhost:9600/api/v2/api-docs/时,会得到一个标准的Spring。我怀疑这是问题的根源?我没有看到Spring
我如何访问生成的swagger-ui.html?或者index.html我似乎在我的项目中找不到这个文件。啊啊!