mall学习教程官网:macrozheng.com 作者:uzong来源:juejin.cn/post/7294844864020430902 在掘金看到一篇文章,让我产生了想要分享的欲望。 讲述的是面对同一个需求,一个工作经验不到两年的小鲜肉和一个工作六年的老司机给出的两个不同技术方案的实现落地。 先是小鲜肉写了一版实现,然后老司机在审查代码的时候觉得应该有更优雅的落地解决方案,于是又按照自己的思路重构了一版。 一、历史背景那天下午,看到了令我终生难忘的代码,那一刻破防了...... 故事还得从半年前数据隔离的那个事情说起...... 1.1 数据隔离预发,灰度,线上环境共用一个数据库。 每一张表有一个 env 字段,环境不同值不同。 特别说明:env 字段即环境字段。 如下图所示:
1.2 隔离之前插曲:一开始只有 1 个核心表有 env 字段,其他表均无该字段;有一天预发环境的操作影响到客户线上的数据。为了彻底隔离,剩余的二十几个表均要添加上环境隔离字段。 当时二十几张表已经大量生产数据,隔离需要做好兼容过渡,保障数据安全。 1.3 隔离改造其他表历史数据很难做区分,于是新增加的字段 env 初始化 all ,表示预发线上都能访问。以此达到历史数据的兼容。 每一个环境都有一个自己独立标志;从 application.properties 中读该字段;最终到数据库执行的语句如下: SELECT XXX FROM tableName WHERE env = ${环境字段值} and ${condition} 1.4 隔离方案最拉胯的做法:每一张表涉及到的 DO、Mapper、XML等挨个添加 env 字段。但我指定不能这么干!!! 具体方案:自定义 mybatis 拦截器进行统一处理。 通过这个方案可以解决以下几个问题:
1.5 最终落地在 mybatis 拦截器中, 通过改写 SQL。新增时填充环境字段值,查询时添加环境字段条件,真正实现改一处即可。 考虑历史数据过渡,将 env = SELECT xxx FROM ${tableName} WHERE env in (${当前环境},'all') AND ${其他条件} 具体实现逻辑如下图所示: 1.其中 env 字段是从 application.properties 配置获取,全局唯一,只要环境不同,env 值不同 借助 JSqlParser 开源工具,改写 sql 语句,修改重新填充、查询拼接条件即可。
思路:自定义拦截器,填充环境参数,修改 sql 语句,下面是部分代码示例: @Intercepts( 一气呵成,完美上线。 二、发展演变2.1 业务需求随着业务发展,出现了以下需求: 1.上下游合作,我们的 PRC 接口在匹配环境上与他们有差异,需要改造 SELECT * FROM ${tableName} WHERE bizId = ${bizId} and env in (?,'all') 2.有一些环境的数据相互相共享,比如预发和灰度等 3.开发人员的部分后面,希望在预发能纠正线上数据等 2.2 初步沟通这个需求的落地交给了来了快两年的小鲜肉。 在开始做之前,他也问我该怎么做。我简单说了一些想法,比如可以跳过环境字段检查,不拼接条件;或者拼接所有条件,这样都能查询;亦或者看一下能不能注解来标志特定方法,你想一想如何实现...... 年纪大了需要给年轻人机会。 2.3 勤劳能干小鲜肉,没多久就实现了。 不过有一天下午他遇到了麻烦。他填充的环境字段取出来为 null,看来很久没找到原因,让我帮他看看。 但是不久前也还教过他 Arthas 如何使用呢,这种问题应该不在话下吧? 2.4 具体实现大致逻辑:在需要跳过环境条件判断的方法前后做硬编码处理,同环切面逻辑, 一加一删。 填充颜色部分为小鲜肉的改造逻辑。 大概逻辑就是:将 env 字段填充所有环境。条件过滤的忽略的目的。 SELECT * FROM ${tableName} WHERE env in ('pre','gray','online','all') AND ${其他条件} 2.5 错误原因经过排查是因为 API 里面有多处对 threadLoal 进行处理的逻辑,方法之间存在调用。 简化举例:A 和 B 方法都是独立的方法, A 在调用 B 的过程,B 结束时把上下文环境字段删除, A 在获取时得到 null。 具体如下: 2.6 五味杂陈当我看到代码的一瞬间,彻底破防了...... queryProject 方法里面调用 findProjectWithOutEnv, 在两个方法中,都有填充处理 env 的代码。 2.7 遍地开花然而,这三行代码,随处可见,在业务代码中遍地开花....... // 1. 变量保存 oriFilterEnv 改了个遍,很勤劳...... 2.8 灵魂开问难道真的就只能这么做吗,当然还有......
大量魔法值,单行字符超 500,方法长度拖几个屏幕也都睁一眼闭一只眼了,但整这一出,还是破防...... 内心涌动,我觉得要重构一下。 三、重构一下3.1 困难之处在 mybatis intercept 中不能直接精准地获取到 service 层的接口调用。只能通过栈帧查询到调用链。 3.2 问题列表
3.3 实现分析
同一份代码,在多个环境运行,不管如何,一定要考虑线上数据安全性。 3.4 使用案例采用了自定义注解的方式:@InvokeChainSkipEnvRule 其使用案例如下:
案例说明:project 表在预发环境校验跳过。 使用的方式就是在调用入口处添加该注解: @SneakyThrows 3.5 具体实现
@Target({ElementType.METHOD}) 3.6 不足之处
那还要不要完善一下,还有什么没有考虑到的点呢? 拿起手机看到快 12 点的那一刻,我还是选择先回家了...... 四、总结思考4.1 隔离总结这是一个很好参考案例:在应用中既做了数据隔离,也做了数据共享。通过自定义拦截器做数据隔离,通过自定注解切面实现数据共享。 4.2 编码总结同样的代码写两次就应该考虑重构了
4.3 场景总结简单梳理,自定义注解 + AOP 的场景 自定义注解很灵活,应用场景广泛,可以多多挖掘。 4.4 反思总结
4.5 最后感想在这个只讲业务结果,不讲技术氛围的环境里,突然有一些伤感。身体已经开始吃不消了,好像也过了那个对技术较真死抠的年纪。
Github上 标星60K 的电商实战项目mall,全套 视频教程(2023最新版) 已更新完毕!全套教程约40小时,共113期 ,通过这套教程你可以拥有一个涵盖主流Java技术栈的完整项目经验 ,同时提高自己独立开发一个项目的能力 ,下面是项目的整体架构图,感兴趣的小伙伴可以点击链接 mall视频教程 加入学习。整套 视频教程 的内容还是非常完善的,涵盖了mall项目最佳学习路线、整体框架搭建、业务与技术实现全方位解析、线上Docker环境部署、微服务项目学习等内容,具体大纲可以参考下图,你也可以点击链接 mall视频教程 了解更多内容。 推荐阅读
上一篇:【前端】成都知道创宇信息技术有限公司 下一篇:GitHub上最励志的计算机自学教程:8个月,从中年Web前端到亚马逊百万年薪软件工程师 | 中文版 |