Spring Boot：实现API 多版本控制

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.PathMatchConfigurer;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
 
@Configuration
public class WebConfig implements WebMvcConfigurer {
 
    @Override
    public void configurePathMatch(PathMatchConfigurer configurer) {
        configurer.addPathPrefix("/api/v1", c -> c.isAnnotationPresent(ApiVersion1.class));
        configurer.addPathPrefix("/api/v2", c -> c.isAnnotationPresent(ApiVersion2.class));
    }
 
    @Bean
    public CurrentApiVersionInterceptor currentApiVersionInterceptor() {
        return new CurrentApiVersionInterceptor();
    }
}
 
// 自定义注解，标记API版本1的资源
@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface ApiVersion1 {
}
 
// 自定义注解，标记API版本2的资源
@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface ApiVersion2 {
}
 
// 拦截器，记录当前请求所对应的API版本
public class CurrentApiVersionInterceptor extends HandlerInterceptorAdapter {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
        HandlerMethod handlerMethod = (HandlerMethod) handler;
        ApiVersion1 apiVersion1 = AnnotationUtils.findAnnotation(handlerMethod.getMethod(), ApiVersion1.class);
        ApiVersion2 apiVersion2 = AnnotationUtils.findAnnotation(handlerMethod.getMethod(), ApiVersion2.class);
 
        // 记录当前API版本
        request.setAttribute("currentApiVersion", apiVersion1 != null ? "v1" : "v2");
        return true;
    }
}

这个代码示例展示了如何在Spring Boot中配置API的多版本控制。通过自定义注解@ApiVersion1和@ApiVersion2，并在WebConfig配置类中使用configurePathMatch方法来指定不同版本的路径前缀，同时注册了一个自定义拦截器CurrentApiVersionInterceptor来记录当前请求所对应的API版本。这样，开发者可以根据不同版本进行相应的代码处理。