手写MyBatis第56弹：动态代理与责任链的完美结合MyBatis插件架构

最新推荐文章于 2025-09-11 23:50:21 发布

程序员扣棣

最新推荐文章于 2025-09-11 23:50:21 发布

阅读量1.4k

点赞数 39

CC 4.0 BY-SA版权

分类专栏：手写MyBatis框架文章标签： mybatis java tomcat

本文链接：https://blog.csdn.net/weixin_67874152/article/details/151334829

手写MyBatis框架专栏收录该内容

59 篇文章

订阅专栏

#王者杯·14天创作挑战营·第5期#

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

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

🔥🔥🔥（源码 + 调试运行 + 问题答疑）🔥🔥🔥 有兴趣可以联系我

🔥🔥🔥 文末有往期免费源码，直接领取获取（无删减，无套路）

MyBatis插件机制深度解析：从原理到实战应用
手写实现MyBatis插件系统：揭秘拦截器背后的设计哲学
MyBatis插件开发全攻略：原理剖析与最佳实践
深入理解MyBatis插件架构：动态代理与责任链的完美结合
MyBatis拦截器机制详解：如何优雅扩展框架功能

正文

MyBatis作为一款优秀的持久层框架，其强大的插件机制为开发者提供了极大的灵活性。插件机制允许我们在不修改框架源码的情况下，对MyBatis的核心组件进行功能扩展和增强。本文将深入剖析MyBatis插件机制的核心原理、实现细节以及实际应用场景。

一、MyBatis插件机制概述

MyBatis插件机制基于动态代理和责任链模式实现，通过拦截器（Interceptor）对四大核心组件（Executor、StatementHandler、ParameterHandler、ResultSetHandler）的方法进行拦截和增强。这种设计使得开发者可以非侵入式地扩展MyBatis功能，实现了开闭原则的良好实践。

二、核心组件详解

1. Interceptor接口

Interceptor是插件机制的核心接口，所有自定义插件都必须实现此接口。它定义了三个方法：

 public interface Interceptor {
   Object intercept(Invocation invocation) throws Throwable;
   Object plugin(Object target);
   void setProperties(Properties properties);
 }

intercept：执行拦截逻辑的核心方法
plugin：用于包装目标对象，返回代理对象
setProperties：设置插件属性

2. @Intercepts和@Signature注解

这两个注解用于定义插件的拦截规则：

 @Intercepts({
   @Signature(
     type = StatementHandler.class,
     method = "prepare",
     args = {Connection.class, Integer.class}
   )
 })

@Intercepts：标识该类是一个拦截器，包含多个@Signature
@Signature：定义具体的拦截点，包括拦截的类、方法和方法参数

3. InterceptorChain责任链

InterceptorChain维护了所有已配置的拦截器，负责按顺序执行这些拦截器：

public class InterceptorChain {
   private final List<Interceptor> interceptors = new ArrayList<>();
   
   public Object pluginAll(Object target) {
     for (Interceptor interceptor : interceptors) {
       target = interceptor.plugin(target);
     }
     return target;
   }
 }

4. Plugin代理包装工具

Plugin类是MyBatis提供的工具类，基于JDK动态代理实现，用于创建代理对象：

 public class Plugin implements InvocationHandler {
   private final Object target;
   private final Interceptor interceptor;
   private final Map<Class<?>, Set<Method>> signatureMap;
   
   public static Object wrap(Object target, Interceptor interceptor) {
     // 创建代理对象逻辑
   }
 }

5. Invocation调用上下文

Invocation封装了被代理方法的调用信息，提供了 proceed() 方法用于执行原始方法：

 public class Invocation {
   private final Object target;
   private final Method method;
   private final Object[] args;
   
   public Object proceed() throws InvocationTargetException, IllegalAccessException {
     return method.invoke(target, args);
   }
 }

三、插件生效流程

MyBatis插件的生效过程可以分为以下几个步骤：

配置解析阶段：MyBatis解析配置文件中的<plugins>标签，实例化拦截器并设置属性
拦截器注册：将拦截器添加到InterceptorChain中
对象包装阶段：在创建四大核心组件时，调用InterceptorChain.pluginAll()方法
代理调用阶段：当调用被代理对象的方法时，触发Plugin.invoke()方法
精确拦截判断：检查当前方法是否匹配@Signature定义的规则
责任链执行：按顺序执行所有匹配的拦截器，最后执行原始方法

四、插件开发实践

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 PerformanceInterceptor implements Interceptor {
   private static final Logger logger = LoggerFactory.getLogger(PerformanceInterceptor.class);
   private long threshold = 1000; // 默认阈值1秒
   
   @Override
   public Object intercept(Invocation invocation) throws Throwable {
     long start = System.currentTimeMillis();
     Object result = invocation.proceed();
     long end = System.currentTimeMillis();
     long time = end - start;
     
     if (time > threshold) {
       Object[] args = invocation.getArgs();
       MappedStatement ms = (MappedStatement) args[0];
       String methodName = ms.getId();
       logger.warn("方法 {} 执行耗时: {} ms", methodName, time);
     }
     
     return result;
   }
   
   @Override
   public Object plugin(Object target) {
     return Plugin.wrap(target, this);
   }
   
   @Override
   public void setProperties(Properties properties) {
     String thresholdStr = properties.getProperty("threshold");
     if (thresholdStr != null) {
       this.threshold = Long.parseLong(thresholdStr);
     }
   }
 }