SpringBoot реализует поддержку многоверсионности интерфейса API.

Java

1. Введение

В процессе итерации продукта одновременно может быть несколько версий одного и того же интерфейса, а URL-адреса интерфейса и параметры разных версий одинаковы, но внутренняя логика может отличаться. Особенно, когда один и тот же интерфейс должен поддерживать как старую версию, так и новую версию. Например, если приложение выпускает новую версию, некоторые пользователи могут не выбрать обновление. Это очень необходимо для управления версиями последнего интерфейса, который может быть сделано в зависимости от версии APP.Предоставляет различные версии интерфейса.

Во-вторых, реализация кода

Реализация кода в этой статье основана на выпуске SpringBoot 2.3.4.

1. Определите аннотации

  • ApiVersion
@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface ApiVersion {

    /**
     * 版本。x.y.z格式
     *
     * @return
     */
    String value() default "1.0.0";
}

Значение по умолчанию равно 1.0.0.

  • EnableApiVersion

    /**
 * 是否开启API版本控制
 */
@Target(ElementType.TYPE)
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Import(ApiAutoConfiguration.class)
public @interface EnableApiVersion {
}

    После добавления этой аннотации в класс запуска можно включить поддержку многоверсионности интерфейса. использоватьImportимпорт конфигурацииApiAutoConfiguration.

2. Абстрагируйте номер версии от класса ApiItem.

  • ApiItem
@Data
public class ApiItem implements Comparable<ApiItem> {
    private int high = 1;

    private int mid = 0;

    private int low = 0;

    public static final ApiItem API_ITEM_DEFAULT = ApiConverter.convert(ApiVersionConstant.DEFAULT_VERSION);

    public ApiItem() {
    }

    @Override
    public int compareTo(ApiItem right) {
        if (this.getHigh() > right.getHigh()) {
            return 1;
        } else if (this.getHigh() < right.getHigh()) {
            return -1;
        }

        if (this.getMid() > right.getMid()) {
            return 1;
        } else if (this.getMid() < right.getMid()) {
            return -1;
        }
        if (this.getLow() > right.getLow()) {
            return 1;
        } else if (this.getLow() < right.getLow()) {
            return -1;
        }
       
        return 0;
    }

}

Чтобы сравнить размер номеров версий, реализуйтеComparableинтерфейс и переопределениеcompareTo(), и сравните их последовательно от большего к меньшему.

  • ApiConverter

public class ApiConverter {

    public static ApiItem convert(String api) {
        ApiItem apiItem = new ApiItem();
        if (StringUtils.isBlank(api)) {
            return apiItem;
        }

        String[] cells = StringUtils.split(api, ".");
        apiItem.setHigh(Integer.parseInt(cells[0]));
        if (cells.length > 1) {
            apiItem.setMid(Integer.parseInt(cells[1]));
        }

        if (cells.length > 2) {
            apiItem.setLow(Integer.parseInt(cells[2]));
        }
        
        return apiItem;
    }

}

ApiConverterПредоставляет статический метод для преобразования строки вApiItem.

  • Постоянный класс, определяющий заголовки запросов и номера версий по умолчанию

public class ApiVersionConstant {
    /**
     * header 指定版本号请求头
     */
    public static final String API_VERSION = "x-api-version";

    /**
     * 默认版本号
     */
    public static final String DEFAULT_VERSION = "1.0.0";
}

3. Основное API-условие новыйApiConditionкласс, реализоватьRequestCondition, переписатьcombine,getMatchingCondition,compareToметод.

  • RequestCondition
public interface RequestCondition<T> {

 /**
  * 方法和类上都存在相同的条件时的处理方法
  */
 T combine(T other);

 /**
  * 判断是否符合当前请求，返回null表示不符合
  */
 @Nullable
 T getMatchingCondition(HttpServletRequest request);

 /**
  *如果存在多个符合条件的接口，则会根据这个来排序，然后用集合的第一个元素来处理
  */
 int compareTo(T other, HttpServletRequest request);

Выше приведено краткое описание RequestCondition, за которым следует подробный анализ исходного кода роли каждого метода.

  • ApiCondition

@Slf4j
public class ApiCondition implements RequestCondition<ApiCondition> {

    public static ApiCondition empty = new ApiCondition(ApiConverter.convert(ApiVersionConstant.DEFAULT_VERSION));

    private ApiItem version;

    private boolean NULL;

    public ApiCondition(ApiItem item) {
        this.version = item;
    }

    public ApiCondition(ApiItem item, boolean NULL) {
        this.version = item;
        this.NULL = NULL;
    }

    /**
     * <pre>
     *     Spring先扫描方法再扫描类，然后调用{@link #combine}
     *     按照方法上的注解优先级大于类上注解的原则处理，但是要注意如果方法上不定义注解的情况。
     *     如果方法或者类上不定义注解，我们会给一个默认的值{@code empty},{@link ApiHandlerMapping}
     * </pre>
     * @param other 方法扫描封装结果
     * @return
     */
    @Override
    public ApiCondition combine(ApiCondition other) {
        // 选择版本最大的接口
        if (other.NULL) {
            return this;
        }
        return other;
    }

    @Override
    public ApiCondition getMatchingCondition(HttpServletRequest request) {
        if (CorsUtils.isPreFlightRequest(request)) {
            return empty;
        }
        String version = request.getHeader(ApiVersionConstant.API_VERSION);
        // 获取所有小于等于版本的接口;如果前端不指定版本号，则默认请求1.0.0版本的接口
        if (StringUtils.isBlank(version)) {
            log.warn("未指定版本，使用默认1.0.0版本。");
            version = ApiVersionConstant.DEFAULT_VERSION;
        }
        ApiItem item = ApiConverter.convert(version);
        if (item.compareTo(ApiItem.API_ITEM_DEFAULT) < 0) {
            throw new IllegalArgumentException(String.format("API版本[%s]错误，最低版本[%s]", version, ApiVersionConstant.DEFAULT_VERSION));
        }
        if (item.compareTo(this.version) >= 0) {
            return this;
        }
        return null;
    }

    @Override
    public int compareTo(ApiCondition other, HttpServletRequest request) {
        // 获取到多个符合条件的接口后，会按照这个排序，然后get(0)获取最大版本对应的接口.自定义条件会最后比较
        int compare = other.version.compareTo(this.version);
        if (compare == 0) {
            log.warn("RequestMappingInfo相同，请检查！version:{}", other.version);
        }
        return compare;
    }

}

3. Настройте контейнер внедрения класса

  • ApiHandlerMapping

public class ApiHandlerMapping extends RequestMappingHandlerMapping {
    @Override
    protected RequestCondition<?> getCustomTypeCondition(Class<?> handlerType) {
        return buildFrom(AnnotationUtils.findAnnotation(handlerType, ApiVersion.class));
    }

    @Override
    protected RequestCondition<?> getCustomMethodCondition(Method method) {
        return buildFrom(AnnotationUtils.findAnnotation(method, ApiVersion.class));
    }

    private ApiCondition buildFrom(ApiVersion platform) {
        return platform == null ? getDefaultCondition() :
                new ApiCondition(ApiConverter.convert(platform.value()));
    }

    private ApiCondition getDefaultCondition(){
        return new ApiCondition(ApiConverter.convert(ApiVersionConstant.DEFAULT_VERSION),true);
    }
}
  • ApiAutoConfiguration
public class ApiAutoConfiguration implements WebMvcRegistrations {

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

}

ApiAutoConfigurationне использовалConfigurationАвтоматически вводить, вместо этого используйтеImportВведи, цель состоит в том, чтобы выборочно включать или не включать контроль версий в программе.

3. Принципиальный анализ

4. Резюме

В этой статье используетсяmdniceнабор текста

Категории