spring-boot-starter-version-mapping: spring mvc 接口版本管理，路由扩展。通过注解方式实现rest的接口版本，以及根据客户端版本路由到不同处理方法的spring-boot组件

### 版本路由映射

- **@ApiVersion**
>* 通过此注解，自动为requestmappinginfo合并一个以版本号开头的路径；建议：大版本在类上配置，小版本可以通过配置在方法上，此时将替换类上面的大版本配置

- **@ClientVersion**
>* 通过此注解，可以通过接口header中的cv,terminal参数路由倒不同的处理方法（handler method，基于RequestMappingHandlerMapping中的getCustom**Condition方法扩展）；

- **@VersionMapping** 
>* 组合注解，实现了RequestMapping的功能，同时提供了上述两种注解的配置

业务场景：
- ApiVersion：替换之前的版本定义在路径中，导致的接口升级需要重新定义类或者在代码中做判断的问题
- ClientVersion：碰到客户端已经在使用的接口，区分对待的情况下，通过通过ClientVersion优雅的避免在代码中写大量版本判断逻辑的问题

```java

@RequestMapping("/t")
@RestController
@ApiVersion("4")
public class TController {
    //请求路径为/4/t/get
    @RequestMapping(value="/get")
    public String get1 (){
        return "旧接口";
    }

//请求路径为/4.1/t/get
    @RequestMapping(value= "/get",params = "data=tree")
    @ApiVersion("4.1")
    //method的apiversion会优先于class上的,方便升级小版本
    public String get2(){
        return "新数据";
    }

//以下三个请求路径都是/c，
    //通过header里的客户端类型（如果是从url参数取，修改TerminalVersionExpression即可）以及版本号路由到不同方法
    @GetMapping("/c")
    @ClientVersion(expression = {"1>6.0.0"})
    public String cvcheck1(){return "6.0.0以上版本的1类型";}

@GetMapping("/c")
    @ClientVersion({@TerminalVersion(terminals = 2,op= VersionOperator.GT,version = "6.0.0")})
    public String cvcheck2(){return "6.0.0以上版本的2类型";}

@GetMapping("/c")
    @ClientVersion({@TerminalVersion(terminals = 2,op= VersionOperator.LTE,version = "6.0.0")})
    public String cvcheck3(){return "6.0.0以下版本的2类型";}

public String c(){
        return "aaaa";
    }
}

```

```java
@RestController
@VersionMapping(value="/t",apiVersion = "4")
public class TController {
    @VersionMapping(value="a",terminalVersion = @TerminalVersion(terminals = 1,op = VersionOperator.EQ,version = "3.0"))
    public String t(){
        return "123";
    }
}
```

恋曲1990/spring-boot-starter-version-mapping

简介

发行版

贡献者

近期动态

恋曲1990/spring-boot-starter-version-mapping .gitee-modal { width: 500px !important; }

简介

发行版

开源评估指数源自 OSS-Compass 评估体系，评估体系围绕以下三个维度对项目展开评估：

贡献者

近期动态

搜索帮助

恋曲1990/spring-boot-starter-version-mapping