Why is v2/api-docs the default URL when using springfox and Swagger2?(为什么使用 springfox 和 Swagger2 时 v2/api-docs 是默认 URL?)
问题描述
I'm just starting using swagger following this guide, but I found out something very weird that makes no sense for me.
As far as I remember , the v2/api-docs should be used for when you have docs of the version number 2 of your API.
So, the default should be only api-docs, but for some strange reason I found that the default is v2/api-docs.
Checking the library doc I found this.
How do I override that value without later not being able to use v2? (when my API will reach a v2 but I will also want to show the legacy docs).
Or maybe my concept of using v2 is wrong? Can someone help me with this?
The /v2/api-docs URL is the default that SpringFox uses for documentation. The v2 does not refer to your API's documentation version (which can be changed in the Docket configuration), but the version of the Swagger specification being used. Take a look at the documentation here for customizing the Swagger documentation URL. In short, you need to modify an environment property to change the URL your documentation will appear at:
springfox.documentation.swagger.v2.path=/my/docs
This will change the default URL for the SpringFox Swagger documentation from /v2/api-docs to whatever you specify. To implement this, add the above property to a new or existing properties file, and then add it as a property source in your Springfox configuration class:
@PropertySource("classpath:swagger.properties")
@Configuration
public class SwaggerConfig {...}
这篇关于为什么使用 springfox 和 Swagger2 时 v2/api-docs 是默认 URL?的文章就介绍到这了,希望我们推荐的答案对大家有所帮助,也希望大家多多支持编程学习网!
本文标题为:为什么使用 springfox 和 Swagger2 时 v2/api-docs 是默认 URL?
基础教程推荐
- 如何在相机中应用自定义滤镜 [Surfaceview 预览]. 2022-01-01
- Java ECDSAwithSHA256 签名长度不一致 2022-01-01
- 控制台应用程序中的 Java 键盘输入解析 2022-01-01
- JPA惰性列表上的流 2022-01-01
- 在springboot中如何给mybatis加拦截器 2023-04-29
- doFilter()是在servlet的工作完成之前还是之后执行的? 2022-01-01
- Maven:无效的目标版本:10 2022-01-01
- 在java中使用xpath和selenium解析HTML表格数据 2022-01-01
- 将 double 转换为 Int,向下舍入 2022-01-01
- 将 Windows 证书导入 Java 2022-01-01
