怎么编写一个MyBatis插件给所有SQL自动加上更新人_拦截ParameterHandler实战

风静君_3959

风静君_3959

2026-03-21

186人浏览

原创

应拦截 statementhandler——它持有最终拼好的 sql,可在 prepare 阶段通过 metaobject 修改 boundsql.sql 并同步补全 parametermapping,确保 sql 重写与参数注入一致,且无需改动 xml。

怎么编写一个mybatis插件给所有sql自动加上更新人_拦截parameterhandler实战

MyBatis 插件该拦截 ParameterHandler 还是 Executor?

直接拦 ParameterHandler 是错的——它只负责把参数塞进 PreparedStatement,不碰 SQL 字符串本身。你想“给所有 SQL 自动加上更新人”,本质是改 SQL 文本(比如在 UPDATE 语句末尾追加 , update_by = ?),必须在 SQL 渲染完成、但还没执行前动手。真正该拦的是 StatementHandler,它持有最终拼好的 SQL 和参数映射。

怎么在 StatementHandler#prepare 阶段安全修改 SQL?

MyBatis 的 StatementHandler 默认实现是 RoutingStatementHandler,它内部委托给 PreparedStatementHandler。我们得在 prepare 方法返回前,拿到它的 boundSql.sql 并重写。关键点有三个:

  • 用 MetaObject 反射拿到 boundSql,再取 sql 字段(它是只读 final,所以得用 set 强制覆盖)
  • 只对 UPDATE 类型语句操作,用正则判断 sql.trim().toUpperCase().startsWith("UPDATE")
  • 避免重复添加字段:检查原 SQL 是否已含 update_by(比如用 Pattern.compile("(?i)update_by\s*=\s*\?"))

示例片段:

String sql = boundSql.getSql();<br>if (sql.trim().toUpperCase().startsWith("UPDATE") && !hasUpdateBy(sql)) {<br>  sql = sql.replaceFirst("(?i);?$", ", update_by = ?");<br>  metaObject.setValue("boundSql.sql", sql);<br>}

更新人参数怎么塞进 ParameterHandler 不丢?

SQL 改了,就得同步补一个参数,否则执行时报 Parameter index out of range。不能自己 new 个 ArrayList 替换 boundSql.parameterMappings——MyBatis 后续会校验类型。正确做法是:

  • 从 boundSql.parameterMappings 复制一份新列表
  • 构造一个新的 ParameterMapping,指定 property 为 "_updateBy"(注意下划线前缀,避免和业务参数冲突)
  • 把新 mapping 加到列表末尾
  • 用 new BoundSql(...) 重建 boundSql,并用 metaObject.setValue("boundSql", newBoundSql) 替换

别忘了在插件的 intercept 里,把当前用户 ID 存进 MappedStatement 的 additionalParameters(或用 ThreadLocal 透传),否则 ParameterHandler 拿不到值。

为什么不能在 MyBatis-Plus 的 MetaObjectHandler 里做?

MetaObjectHandler 只管实体类字段自动填充(比如 updateTime),它完全不接触 SQL 字符串。你加的 update_by 如果只设在实体上,MyBatis-Plus 会按字段名找列,但前提是你的 XML 或注解 SQL 里已经显式写了 update_by = #{updateBy}。插件方案是无侵入的,连 XML 都不用动——这点最容易被忽略,很多人卡在“为什么填了实体但 SQL 没变”上。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
mybatis一级缓存和二级缓存
mybatis一级缓存和二级缓存

在MyBatis中,一级缓存和二级缓存是两种不同级别的缓存机制,它们都可以用来提高性能。本专题提供mybatis一级缓存和二级缓存相关文章,大家可以免费阅读。

2023.08.21

583

4

ibatis和mybatis有什么区别
ibatis和mybatis有什么区别

ibatis和mybatis的区别:1、基本信息不同;2、开发时间不同;3、功能与易用性;4、配置文件;5、入参类型与出参类型;6、返回结果集接受方式;7、语法差异;8、数据库方言支持;9、插件支持;10、社区活跃度;11、全球化支持。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

2522

5

mybatis如何配置数据库连接
mybatis如何配置数据库连接

mybatis配置数据库连接的方法:1、指定数据源;2、配置事务管理器;3、配置类型处理器和映射器;4、使用环境元素;5、配置别名。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

446

5

mybatis工作原理及流程是什么
mybatis工作原理及流程是什么

mybatis工作原理及流程:1、配置文件;2、接口与映射;3、sql解析与生成;4、执行计划;5、结果处理;6、动态sql;7、缓存机制;8、插件;9、事务管理;10、日志与监控;11、扩展性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

292

4

hibernate和mybatis有哪些区别
hibernate和mybatis有哪些区别

hibernate和mybatis的区别:1、实现方式;2、性能;3、对象管理的对比;4、缓存机制。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

302

5

Java MyBatis框架
Java MyBatis框架

本专题专注于Java主流ORM框架MyBatis的应用,系统讲解SQL映射、动态SQL、结果映射、分页查询、缓存机制与多表关联等核心内容,并结合企业管理系统、电商平台和后台管理项目实战,帮助学员全面掌握高效的数据库持久层开发技能。

2025.08.26

5769

22

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

2026.10.16

20

10

OpenJDK怎么配置Java开发环境
OpenJDK怎么配置Java开发环境

怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

2026.10.16

0

10

OpenJDK怎么部署Java应用
OpenJDK怎么部署Java应用

Java项目开发完成后,怎样部署到目标环境并正常运行?本专题介绍OpenJDK应用部署流程,涵盖运行环境准备、版本兼容检查、应用打包、启动参数配置和日志查看,帮助你理清部署前后的操作顺序,减少环境差异造成的运行问题。

2026.10.16

0

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.7万人学习