项目迭代中新老逻辑切换入口

前言

​ 日常我们在项目开发中经常会进行项目迭代,比如说开发初期设定的代码逻辑根据功能需求迭代逐渐发现越来越难用,或者改动是对整体较大时,往往会进行专项处理,对这个逻辑进行改造。

​ 那么就会涉及到原先被调用方切换接口等问题,这种情况我们为了让外部接口无感知,都是采用内部切流的方式进行外部无感知的。

那么我们来构造一个场景来看看如何进行切流和代码改造。

正文

我们有几个逻辑需要改造的接口

java 复制代码
@Service
public class ARepository {
    @Resource
    private AMapper aMapper;

    public AEntity query(long id){
      //原有的接口逻辑处理
    }
}

@Service
public class BRepository {

    @Resource
    private BMapper bMapper;

    public List<BEntity> query(long id){
      //原有的接口逻辑处理
    }
}

思路

  1. 以接口的维度来控制每一个接口是否要进行切流
  2. 新建一个同级别的新接口实现改造后的逻辑,避免新老逻辑在同一个文件里混杂
  3. 以配置的形式来判断是否需要切换,若出现问题可单独进行回溯

实现方式

apollo

我们创建一个可以随时改动的配置,我这里使用 apollo 进行配置以便随时改动和发布生效:

  1. 每一个 Repository 有唯一一个 key 值,然后去 value 里面找方法 key。

  2. 布尔值 false 表示走原逻辑、true 表示走改造后的逻辑。

json 复制代码
{
  "ARepository":{
    "query":false
  },
  "BRepository":{
    "query":false
  }
}

新逻辑

java 复制代码
@Service
public class NewARepository {
    @Resource
    private AMapper aMapper;

    public AEntity query(long id){
      //新的接口逻辑处理
    }
}

@Service
public class NewBRepository {

    @Resource
    private BMapper bMapper;

    public List<BEntity> query(long id){
      //新的接口逻辑处理
    }
}

切流控制

创建一个切流控制类,使用上面的 apollo 来判断是否需要执行新逻辑并返回。

我们构造一个泛型类,统一注入新逻辑类,在调用 switchHandler 是传入新逻辑函数,通过 apollo 判断是否需要执行

java 复制代码
@Slf4j
@Getter
@Component
public class MapperSwitchHandler {
  
    @Resource
    private NewARepository newARepository;
    @Resource
    private NewBRepository newARepository;

  	//lombok忽略此属性,不生成 get 方法
    @Getter(AccessLevel.NONE)
  	//获取 apollo 配置信息
    @ApolloJsonValue(namespace = "namespace", config = "config", key = "key")
    private JSONObject mapperSwitch;


    /**
     * @Author: zhou
     * @Description: 根据传入参数获取 apollo 配置的 boolean 值
     * @Date: 2024/5/27 11:38
     * @Param: className apollo 中类名--一级
     * @Param: methodName apollo 中方法名--二级
     * @return: boolean
     */
    private boolean switchResult(String className, String methodName) {
        if (mapperSwitch == null) {
            return false;
        }
        return Optional.ofNullable(mapperSwitch.getJSONObject(className))
            .map(item -> item.getBoolean(methodName))
            .orElse(false);
    }

    /**
     * @Author: zhou
     * @Description: 根据 apollo 配置的 boolean 值来判断是否执行传入的 action 函数,并获取结果
     * @Date: 2024/5/27 11:36
     * @Param: className apollo 中类名
     * @Param: methodName apollo 中方法名
     * @Param: action 待执行函数
     * @return: MapperSwitchHandler.Result<T>
     */
    public <T> Result<T> switchHandler(String className, String methodName, Supplier action) {
        Result<T> result = new Result<>();
        boolean flag = switchResult(className, methodName);
        log.info("className:{}, methodName:{}, mapper switch : {}", className, methodName, flag);
        result.setFlag(flag);
        if (result.isFlag()) {
            result.setData((T) action.get());
            log.info("new logic result :{}", JSONObject.toJSONString(result.getData()));
        } else {
            log.info("old logic start...");
        }
        return result;
    }

    @Slf4j
    @Data
    public static class Result<T> {
        /**
         * 逻辑标识
         */
        private boolean flag;

        /**
         * 获取的结果
         */
        private T data;
    }
}

这样我们就实现好了新逻辑的控制和改造,现在需要对原逻辑进行改造判断。

老逻辑改造

java 复制代码
@Service
public class ARepository {
    @Resource
    private AMapper aMapper;
  
  	//注入开关
    @Resource
    private MapperSwitchHandler mapperSwitchHandler;

    public AEntity query(long id){
        MapperSwitchHandler.Result<AEntity> result = mapperSwitchHandler.switchHandler(
            "ARepository",
            "query",
            () -> mapperSwitchHandler.getNewARepository().query(id)
        );
        // flag 判断是否走新 sql ,true 标识走新 sql,直接返回;false 标识走老逻辑
        if (result.isFlag()) {
            return result.getData();
        }
      
      //原有的接口逻辑处理
    }
}

@Service
public class BRepository {

    @Resource
    private BMapper bMapper;
  
  	//注入开关
    @Resource
    private MapperSwitchHandler mapperSwitchHandler;

    public List<BEntity> query(long id){
      MapperSwitchHandler.Result<List<BEntity>> result = mapperSwitchHandler.switchHandler(
            "BRepository",
            "query",
            () -> mapperSwitchHandler.getNewBRepository().query(id)
        );
        // flag 判断是否走新 sql ,true 标识走新 sql,直接返回;false 标识走老逻辑
        if (result.isFlag()) {
            return result.getData();
        }
      //原有的接口逻辑处理
    }
}

这样我们就实现了通过 apollo 配置来灵活的判断每一个接口层面的逻辑控制。待灰度完成或者新逻辑全部正确的时候我们有两种方式来进行代码清理:

  • 完全删掉老的类文件,原调用方只需要重新引用新的接口类
  • 只删除老逻辑,老接口的入口调用新逻辑即可。

尾言

​ 本文介绍了在进行代码改造进行逻辑切流失的逻辑操作,通过 apollo 配置来实时动态的判断各个接口的控制效果,通过统一的处理类避免了每一个需要改造的代码都需要引用新的逻辑类和开关配置。总体来说是一个比较不错的方案,第一次实现此场景,如果更好的建议可以交流一下。

相关推荐
向阳12186 分钟前
Dubbo负载均衡
java·运维·负载均衡·dubbo
懒惰才能让科技进步9 分钟前
从零学习大模型(十二)-----基于梯度的重要性剪枝(Gradient-based Pruning)
人工智能·深度学习·学习·算法·chatgpt·transformer·剪枝
DARLING Zero two♡13 分钟前
关于我、重生到500年前凭借C语言改变世界科技vlog.16——万字详解指针概念及技巧
c语言·开发语言·科技
Gu Gu Study16 分钟前
【用Java学习数据结构系列】泛型上界与通配符上界
java·开发语言
love_and_hope25 分钟前
Pytorch学习--神经网络--搭建小实战(手撕CIFAR 10 model structure)和 Sequential 的使用
人工智能·pytorch·python·深度学习·学习
Chef_Chen28 分钟前
从0开始学习机器学习--Day14--如何优化神经网络的代价函数
神经网络·学习·机器学习
芊寻(嵌入式)38 分钟前
C转C++学习笔记--基础知识摘录总结
开发语言·c++·笔记·学习
WaaTong39 分钟前
《重学Java设计模式》之 原型模式
java·设计模式·原型模式
m0_7430484439 分钟前
初识Java EE和Spring Boot
java·java-ee
AskHarries41 分钟前
Java字节码增强库ByteBuddy
java·后端