app版本控制java后端接口版本管理

news2025/1/21 12:37:08

java api version 版本控制 java接口版本管理

1 自定义 AppVersionHandleMapping

自定义AppVersionHandleMapping实现RequestMappingHandlerMapping里面的方法
public class AppVersionHandleMapping extends RequestMappingHandlerMapping
{
    @Override
    protected RequestCondition<?> getCustomTypeCondition(Class<?> handlerType)
    {
        AppVersion annotation = handlerType.getAnnotation(AppVersion.class);
        return annotation == null ? null : new AppVersionCondition(new VersionItem(annotation.value()));
    }

    @Override
    protected RequestCondition<?> getCustomMethodCondition(Method method)
    {
        AppVersion annotation = method.getAnnotation(AppVersion.class);
        return annotation == null ? null : new AppVersionCondition(new VersionItem(annotation.value()));
    }
}

2 自定义注解

@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
public @interface AppVersion
{
    String value() default "1.0.0";
}

3 实现RequestCondition里面的方法

@Data
public class AppVersionCondition implements RequestCondition<AppVersionCondition> {
    private VersionItem versionItem;

    public AppVersionCondition(VersionItem versionItem) {
        this.versionItem = versionItem;
    }

    @Override
    public AppVersionCondition combine(AppVersionCondition other) {
        // 选择大版本
        return versionItem.compareTo(other.getVersionItem()) >= 0 ? new AppVersionCondition(this.getVersionItem()) : new AppVersionCondition(other.getVersionItem());
    }

    @Override
    public AppVersionCondition getMatchingCondition(HttpServletRequest request) {
        String appVersion = RequestUtil.getAppVersion(request);
        VersionItem item = new VersionItem(appVersion);
        // 获取所有小于等于版本的接口
        if (item.compareTo(this.versionItem) >= 0)
            return this;
        return null;
    }

    @Override
    public int compareTo(AppVersionCondition other, HttpServletRequest request) {
        // 获取最大版本对应的接口
        return other.getVersionItem().compareTo(this.versionItem);
    }

4 最后把自定义的AppVersionHandleMapping注入MVC管理

@Configuration
public class WebConfig implements WebMvcConfigurer, WebMvcRegistrations {

    @Override
    public RequestMappingHandlerMapping getRequestMappingHandlerMapping() {
        return new AppVersionHandleMapping();
    }

5 版本比对工具

@Data
public class VersionItem implements Comparable<VersionItem> {
    private String appVersion;

    public VersionItem(String appVersion) {
        // 截取前三位
        String[] split = appVersion.split("\\.");
        if (split.length > 3)
            appVersion = split[0] + "." + split[1] + "." + split[2];
        this.appVersion = appVersion;
    }

    @Override
    public int compareTo(@NotNull VersionItem o) {
        return compareVersion(o.getAppVersion());
    }

    /**
     * 判断版本
     *
     * @param version 版本
     */
    private int compareVersion(String version) {
        String[] version1 = appVersion.split("\\.");
        String[] version2 = version.split("\\.");
        int i1 = 0;
        int i2 = 0;
        int n1 = version1.length;
        int n2 = version2.length;
        for (int i = 0; i < Math.max(n1, n2); i++) {
            i1 = i < n1 ? Integer.parseInt(version1[i]) : 0;
            i2 = i < n2 ? Integer.parseInt(version2[i]) : 0;
            if (i1 != i2)
                return Integer.compare(i1, i2);
        }
        return 0;
    }