当前位置：首页 > ai >正文

手写MyBatis第53弹： @Intercepts与@Signature注解的工作原理

ai 2025/9/7 6:08:46

🥂(❁´◡`❁)您的点赞👍➕评论📝➕收藏⭐是作者创作的最大动力🤞

💖📕🎉🔥 支持我：点赞👍+收藏⭐️+留言📝欢迎留言讨论

🔥🔥🔥（源码 + 调试运行 + 问题答疑）

🔥🔥🔥 有兴趣可以联系我。

我们常常在当下感到时间慢，觉得未来遥远，但一旦回头看，时间已经悄然流逝。对于未来，尽管如此，也应该保持一种从容的态度，相信未来仍有许多可能性等待着我们。

正文

一、MyBatis插件机制概述

二、@Intercepts和@Signature注解详解

2.1 注解定义与作用

2.2 为什么需要args属性？

三、注解的工作原理

3.1 注册与发现机制

3.2 拦截点匹配算法

四、实战：自定义插件开发

4.1 基本拦截器实现

4.2 复杂场景：参数修改插件

五、高级应用与最佳实践

5.1 多方法拦截策略

5.2 性能优化考虑

六、常见问题与解决方案

6.1 拦截器不生效的可能原因

6.2 调试技巧

七、总结

MyBatis拦截器核心原理解析：@Intercepts和@Signature注解的深度剖析
精准拦截的艺术：MyBatis插件开发中@Signature注解的完整指南
从源码角度理解MyBatis拦截器：为什么需要args属性来精确匹配方法？
MyBatis插件开发实战：使用注解实现方法级精确拦截的技巧与最佳实践
超越基础：深入MyBatis拦截器机制与自定义注解的高级用法

正文

在MyBatis的插件机制中，@Intercepts和@Signature两个注解扮演着至关重要的角色。它们就像是插件系统的"导航系统"，精确指导框架应该拦截哪个类的哪个方法。本文将深入剖析这两个注解的工作原理、实现机制以及实际应用场景。

一、MyBatis插件机制概述

MyBatis的插件机制是基于Java动态代理实现的拦截器模式，允许用户在已映射语句执行过程中的某些点进行拦截和自定义处理。这种设计遵循了开闭原则，使得我们可以增强MyBatis的功能而不需要修改其核心代码。

在MyBatis的架构中，四个核心组件可以被拦截：

Executor (update, query, flushStatements, commit, rollback, getTransaction, close, isClosed)
ParameterHandler (getParameterObject, setParameters)
ResultSetHandler (handleResultSets, handleOutputParameters)
StatementHandler (prepare, parameterize, batch, update, query)

二、@Intercepts和@Signature注解详解

2.1 注解定义与作用

@Intercepts注解用于声明一个类作为MyBatis拦截器，并包含一个或多个@Signature注解：

 @Documented@Retention(RetentionPolicy.RUNTIME)@Target(ElementType.TYPE)public @interface Intercepts {Signature[] value();}

@Signature注解则用于精确指定要拦截的方法：

@Documented@Retention(RetentionPolicy.RUNTIME)@Target({})public @interface Signature {Class<?> type();String method();Class<?>[] args();}

2.2 为什么需要args属性？

这是本文要解答的核心问题。args属性的存在是为了精确匹配方法重载。在Java中，方法签名由方法名和参数类型列表共同决定，仅仅使用方法名无法唯一确定一个方法。

考虑以下场景：

class Example {public void process(String arg) {}public void process(String arg1, String arg2) {}public void process(Integer arg) {}}

如果我们只想拦截process(String arg)方法，而不拦截其他重载版本，就必须使用args属性来指定参数类型列表。没有args属性，拦截器将无法区分这些重载方法，可能导致错误的拦截或不必要的性能开销。

三、注解的工作原理

3.1 注册与发现机制

MyBatis在启动过程中会扫描所有配置的拦截器，并通过反射读取其上的@Intercepts和@Signature注解信息。这个过程主要包括以下步骤：

配置解析：解析mybatis-config.xml中的plugin配置
实例化拦截器：创建拦截器实例
注解解析：通过反射获取拦截器类上的注解信息
方法签名映射：建立方法签名与拦截器的映射关系
代理对象创建：为目标对象创建代理，插入拦截逻辑

3.2 拦截点匹配算法

当MyBatis执行一个方法时，拦截器系统会执行以下匹配算法：

获取目标对象的类和方法名
获取方法参数类型列表
遍历所有已注册的拦截器签名
比对类型、方法名和参数类型是否完全匹配
如果匹配成功，则按顺序执行拦截器链

四、实战：自定义插件开发

4.1 基本拦截器实现

下面是一个简单的SQL执行时间统计插件示例：

 @Intercepts({@Signature(type = Executor.class, method = "update", args = {MappedStatement.class, Object.class}),@Signature(type = Executor.class, method = "query", args = {MappedStatement.class, Object.class, RowBounds.class, ResultHandler.class})})public class SqlExecuteTimeInterceptor implements Interceptor {@Overridepublic Object intercept(Invocation invocation) throws Throwable {long start = System.currentTimeMillis();Object result = invocation.proceed();long end = System.currentTimeMillis();System.out.println("SQL执行耗时: " + (end - start) + "ms");return result;}@Overridepublic Object plugin(Object target) {return Plugin.wrap(target, this);}@Overridepublic void setProperties(Properties properties) {// 可接收配置参数}}

4.2 复杂场景：参数修改插件

在某些场景下，我们可能需要修改SQL参数，下面是一个参数加密插件：

 @Intercepts({@Signature(type = ParameterHandler.class, method = "setParameters", args = {PreparedStatement.class})})public class ParameterEncryptInterceptor implements Interceptor {@Overridepublic Object intercept(Invocation invocation) throws Throwable {ParameterHandler parameterHandler = (ParameterHandler) invocation.getTarget();// 通过反射获取parameterObjectField parameterObjectField = parameterHandler.getClass().getDeclaredField("parameterObject");parameterObjectField.setAccessible(true);Object parameterObject = parameterObjectField.get(parameterHandler);// 对参数进行加密处理if (parameterObject != null) {Object encryptedParams = encryptParameters(parameterObject);parameterObjectField.set(parameterHandler, encryptedParams);}return invocation.proceed();}private Object encryptParameters(Object parameterObject) {// 实现参数加密逻辑return parameterObject;}// plugin和setProperties方法省略}

五、高级应用与最佳实践

5.1 多方法拦截策略

当一个插件需要拦截多个不相关的方法时，可以采用策略模式来组织拦截逻辑：

 @Intercepts({@Signature(type = Executor.class, method = "update", args = {...}),@Signature(type = StatementHandler.class, method = "prepare", args = {...}),@Signature(type = ResultSetHandler.class, method = "handleResultSets", args = {...})})public class MultiPurposeInterceptor implements Interceptor {private Map<String, InterceptionStrategy> strategies;public MultiPurposeInterceptor() {strategies = new HashMap<>();strategies.put("Executor.update", new ExecutorUpdateStrategy());strategies.put("StatementHandler.prepare", new StatementPrepareStrategy());strategies.put("ResultSetHandler.handleResultSets", new ResultSetHandleStrategy());}@Overridepublic Object intercept(Invocation invocation) throws Throwable {String key = invocation.getMethod().getDeclaringClass().getSimpleName() + "." + invocation.getMethod().getName();InterceptionStrategy strategy = strategies.get(key);if (strategy != null) {return strategy.execute(invocation);}return invocation.proceed();}// 策略接口和实现类省略}