在linux上使用swagger进行api版本管理可以通过以下几种方式实现：
1. 使用SpringFox和Swagger3进行API版本管理
如果你使用的是Spring Boot项目，可以通过SpringFox库来集成Swagger并实现版本控制。
添加依赖
在你的pom.xml文件中加入SpringFox的依赖：
io.springfox springfox-boot-starter 3.0.0
配置Swagger
在Spring Boot配置类中设置Swagger，启用版本控制：
@Configuration
@EnableSwagger2
public class SwaggerConfig {
@Bean
public Docket api() {
return new Docket(DocumentationType.OAS_30)
.groupName("v1.0")
.select()
.apis(RequestHandlerSelectors.withMethodAnnotation(ApiVersion.class, "1.0".equals(v.value())))
.build()
.apiInfo(apiInfo());
}
private ApiInfo apiInfo() {
return new ApiInfoBuilder()
.title("我的API")
.description("我的API描述")
.version("1.0")
.build();
}
}版本控制
在控制器中使用@ApiExplorerSettings注解来标记不同版本的API：
@RestController
@RequestMapping("/api/v1")
@ApiExplorerSettings(groupName = "V1")
public class V1Controller {
// V1版本的API
}
@RestController
@RequestMapping("/api/v2")
@ApiExplorerSettings(groupName = "V2")
public class V2Controller {
// V2版本的API
}2. 使用OpenAPI Generator进行API版本管理
你可以使用OpenAPI Generator根据你的OpenAPI规范文件生成API文档和客户端库。
安装OpenAPI Generator
wget https://repo1.maven.org/maven2/io/swagger/openapi-generator-cli/2.4.21/openapi-generator-cli-2.4.21.jar -O openapi-generator.jar
生成API文档
java -jar openapi-generator.jar generate -i openapi.yaml -l java -o ./generated-api
3. 使用Swagger Editor和Swagger UI进行API版本管理
你可以下载并安装Swagger Editor和Swagger UI来管理和查看API文档。
dmSOBC SHOP网店系统由北京时代胜腾信息技术有限公司（http://www.webzhan.com）历时6个月开发完成，本着简单实用的理念，商城在功能上摒弃了外在装饰的一些辅助功能，尽可能的精简各项模块开发，做到有用的才开发，网店V1.0.0版本开发完成后得到了很多用户的使用并获得了好评，公司立即对网店进行升级，其中包括修正客户提出的一些意见和建议，现对广大用户提供免费试用版本，如您在使用
安装Swagger Editor
wget https://github.com/swagger-api/swagger-editor/archive/refs/tags/v4.6.0.tar.gz tar -xvf v4.6.0.tar.gz cd swagger-editor-4.6.0 npm install nohup npm start &
访问Swagger Editor
通过浏览器访问 https://www.php.cn/link/0ceed3b289e76c7f6ac4cdd6083a0966 即可使用Swagger Editor。
安装Swagger UI
wget https://repo1.maven.org/maven2/io/springfox/springfox-swagger-ui/2.9.2/springfox-swagger-ui-2.9.2.html unzip springfox-swagger-ui-2.9.2.html sudo mv springfox-swagger-ui-2.9.2 /var/www/html/swagger-ui
配置Swagger UI
编辑 /var/www/html/swagger-ui/index.html 文件，找到并修改以下内容：
script window.onload function () {
const ui SwaggerUIBundle({
url: "http://petstore.swagger.io/v2/api-docs",
dom_id: '#swagger-ui',
deepLinking: true,
presets: [SwaggerUIBundle.presets.apis, SwaggerUIStandalonePreset],
plugins: [SwaggerUIBundle.plugins.DownloadUrl],
layout: "StandaloneLayout"
});
}启动Web服务器
sudo a2ensite default.conf sudo systemctl restart apache2
访问Swagger UI
通过浏览器访问 https://www.php.cn/link/0ceed3b289e76c7f6ac4cdd6083a0966 即可使用Swagger UI。
通过以上方法，你可以在Linux上利用Swagger有效地进行API版本管理。选择适合你项目需求的工具，可以大大简化API文档的维护和管理过程。
