API 版本控制小技巧
在 Spring 项目的控制器中,有 2 个 Rest API 方法。例如
- 获取用户接口:/user/getUserInfo
- 获取权限接口:/role/getRoleList
一个客户端正在通过 /api/v1进行访问
现在想更新其中一种方法。即/user/getRoleList;因此新方法的版本将为 / api/v2 。但是 v1 的方法没有变化,即 /api/v1 。
如何在同一项目中使用两个版本处理其余方法呢?
意思是 /user/getUserInfo 接口应该同时支持 /api/v1 和 /api/v2。并且 /role/getRoleList 也应该应该支持两个版本,但是功能不同。简单的说
/user/getUserInfo 将有1个方法同时支持两个版本
每个版本的 /role/getRoleList 将有2个方法
如果要对两个版本使用单独的方法,可以通过在 @RequestMapping 中定义不同的值
# 方案一:使用两个接口
```
@RequestMapping(value = "/v1/role/getRoleList",
method = RequestMethod.GET,
produces = MediaType.APPLICATION_JSON_VALUE)
```
和
```
@RequestMapping(value = "/v2/role/getRoleList",
method = RequestMethod.GET,
produces = MediaType.APPLICATION_JSON_VALUE)
```
如果要使用相同的方法来处理,则可以使用方案二
# 方案二:使用@PathVariable
```
@RequestMapping(value = "/{version}/role/getRoleList",
method = RequestMethod.GET,
produces = MediaType.APPLICATION_JSON_VALUE)
public returnType methodName(@PathVariable("version") String version){
// code to check version
}
```
# 方案三:使用@RequestHeader
```
@RequestMapping(value = "/role/getRoleList",
method = RequestMethod.GET,
produces = MediaType.APPLICATION_JSON_VALUE)
public returnType methodName(@RequestHeader("version") String version){
// code to check version
}
```
一般更喜欢在类级别使用 @RequestMapping 单独的控制器中进行管理
# 方案四:使用两个类进行单独映射
```
@RestController@RequestMapping("/v1")
public class RoleV1Controller {
@RequestMapping(value = "/role/getRoleList",
method = RequestMethod.GET,
produces = MediaType.APPLICATION_JSON_VALUE)
public returnType methodName(){
}
}
@RestController@RequestMapping("/v2")
public class RoleV2Controller {
@RequestMapping(value = "/role/getRoleList",
method = RequestMethod.GET,
produces = MediaType.APPLICATION_JSON_VALUE)
public returnType methodName(){
}
}
```
- STM32属于哈佛结构还是冯诺依曼结构?
- windows10使用docker搭建开发环境
- Java 基础 一文搞懂泛型
- Mybatis(一)Porxy动态代理和sql解析替换
- IOS Widget(1):概述
- BLE链路层空中包格式
- SpringMVC请求参数解析
- 数栈产品分享:简析数据中台如何通过DataAPI实现数据共享
- 手把手教你SonarQube入门安装与使用
- HarmonyOS 2.0.0.51 Beta3 开发者版本申请流程指南
- WebAssembly + Dapr = 下一代云原生运行时?
- UI - [事件响应链] -响应链以及不能响应的控件什么时候抛弃事件
- Windows server2019部署DHCP服务器
- 机器学习基础——详解机器学习损失函数之交叉熵
- Python爬虫提取神器,正则表达式(re模块),全程干货!
- 数据结构——30行代码实现栈和模拟递归
- 七个Python的GUI库
- 修改MDT VBS脚本, 解决OSD识别Surface Pro 7+ 硬件类别出错
- [干货]手把手教你写一个安卓app
- C#如何优雅的多表读取