在Ubuntu上Swagger API如何版本管理

在Ubuntu上使用Swagger进行API版本管理，可以参考以下步骤：

1. 添加Swagger依赖：首先，需要在你的项目中添加Swagger的依赖。如果你使用的是Spring Boot项目，可以在pom.xml文件中添加Swagger的依赖项。

2. 创建Swagger配置类：接下来，创建一个Swagger配置类，用于定义不同版本的API文档。在这个配置类中，可以使用Docket实例来定义每个版本的API文档，并通过groupName方法为每个版本指定一个组名。

例如：

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket apiV1() {
        return new Docket(DocumentationType.SWAGGER_2)
                .groupName("v1")
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.example.controller"))
                .paths(PathSelectors.ant("/api/v1/**"))
                .build();
    }

    @Bean
    public Docket apiV2() {
        return new Docket(DocumentationType.SWAGGER_2)
                .groupName("v2")
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.example.controller"))
                .paths(PathSelectors.ant("/api/v2/**"))
                .build();
    }
}

3. 在控制器中添加版本信息：在控制器中，为每个API接口添加相应的版本信息。可以通过@RequestMapping注解来指定每个版本的API路径。

例如：

@RestController
@RequestMapping("/api/v1")
public class ApiControllerV1 {
    @GetMapping("/hello")
    public String hello() {
        return "Hello from API v1!";
    }
}

@RestController
@RequestMapping("/api/v2")
public class ApiControllerV2 {
    @GetMapping("/hello")
    public String hello() {
        return "Hello from API v2!";
    }
}

4. 访问Swagger UI：启动你的Spring Boot应用程序后，访问Swagger UI（通常是http://localhost:8080/swagger-ui.html），你将看到两个版本的API文档，分别位于/api/v1和/api/v2路径下。

通过这种方式，你可以在Ubuntu上使用Swagger来管理API的不同版本，并且可以轻松地切换不同版本的API文档。