带你学习Mybatis之拦截器

mybatis拦截器

mybatis拦截器也叫做插件,mybatis允许开发者自定义拦截器对SQL语句执行过程中的某一个点进行拦截。默认mybatis允许拦截Mybatis中的四大核心对象:Executor中的方法、ParameterHandler的方法、ResultSetHandler的方法以及StatementHandler中的方法

  • Executor中的update()、query()、flushStatements()、commit()、rollback()、getTransaction()、close()、isClose()方法,拦截执行器的方法
  • ParameterHandler中的getParameterObject()、setParameters()方法,拦截参数的处理
  • ResultSetHandler中的handlerResultSets()、handlerOutputParameters()方法,拦截结果集的处理
  • StatementHandler中的prepare()、parameterize()、batch()、update()、query()方法,拦截sql语句的构建

通过动态代理,为需要拦截的接口生成代理对象以实现接口方法拦截功能,当执行所拦截的方法时,就会进入拦截方法

Interceptor接口

mybatis使用拦截器需要实现Interceptor接口

public interface Interceptor {
   // 覆盖所拦截对象的原有方法,执行拦截逻辑的方法
    Object intercept(Invocation var1) throws Throwable;
  // target为被拦截对象,作用是给被拦截对象生成一个代理对象
    default Object plugin(Object target) {
      // Plugin实现了InvocationHandler接口,wrap方法就是执行Proxy.newProxyInstance(type.getClassLoader(),interfaces,new Plugin(target, interceptor, signatureMap))
       //使用JDK的动态代理,给target对象创建一个delegate代理对象,以此来实现方法拦截和增强功能,它会回调intercept()方法,使用当前拦截器来包装目标对象
      // 调用一次wrap方法产生一个代理对象,如果有第二个插件,会将第一个带对象传递给wrap方法,生成第二个代理对象,再调用Invocation.proceed会从最后一个代理对象的invoke方法运行到第一个代理对象的invoke方法,直至真实方法
        return Plugin.wrap(target, this);
    }
  // 根据配置初始化Interceptor对象,只在插件初始化的时候调用一次
    default void setProperties(Properties properties) {
    }
}

@Intercepts注解

自定义的拦截器除了实现Interceptor接口,还需要使用@Intercepts和@Signature注解进行标识

@Intercepts注解中指定了一个@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();
}
使用示例
@Intercepts(
        @Signature(type = StatementHandler.class,method = "prepare",args = {})
)

如何进行拦截的

就是在创建对象实例时生成代理类,采用责任链模式,由interceptorChain来进行生成代理对象并返回

// Configuration 类中的方法

// 创建ParameterHandler
public ParameterHandler newParameterHandler(MappedStatement mappedStatement, Object parameterObject, BoundSql boundSql) {
  ParameterHandler parameterHandler = mappedStatement.getLang().createParameterHandler(mappedStatement, parameterObject, boundSql);
  parameterHandler = (ParameterHandler) interceptorChain.pluginAll(parameterHandler);
  return parameterHandler;
}

// 创建ResultSetHandler
public ResultSetHandler newResultSetHandler(Executor executor, MappedStatement mappedStatement, RowBounds rowBounds, ParameterHandler parameterHandler,
    ResultHandler resultHandler, BoundSql boundSql) {
  ResultSetHandler resultSetHandler = new DefaultResultSetHandler(executor, mappedStatement, parameterHandler, resultHandler, boundSql, rowBounds);
  resultSetHandler = (ResultSetHandler) interceptorChain.pluginAll(resultSetHandler);
  return resultSetHandler;
}

// 创建StatementHandler
public StatementHandler newStatementHandler(Executor executor, MappedStatement mappedStatement, Object parameterObject, RowBounds rowBounds, ResultHandler resultHandler, BoundSql boundSql) {
  StatementHandler statementHandler = new RoutingStatementHandler(executor, mappedStatement, parameterObject, rowBounds, resultHandler, boundSql);
  statementHandler = (StatementHandler) interceptorChain.pluginAll(statementHandler);
  return statementHandler;
}

// 创建Executor
public Executor newExecutor(Transaction transaction, ExecutorType executorType) {
  executorType = executorType == null ? defaultExecutorType : executorType;
  executorType = executorType == null ? ExecutorType.SIMPLE : executorType;
  Executor executor;
  if (ExecutorType.BATCH == executorType) {
    executor = new BatchExecutor(this, transaction);
  } else if (ExecutorType.REUSE == executorType) {
    executor = new ReuseExecutor(this, transaction);
  } else {
    executor = new SimpleExecutor(this, transaction);
  }
  if (cacheEnabled) {
    executor = new CachingExecutor(executor);
  }
  executor = (Executor) interceptorChain.pluginAll(executor);
  return executor;
}

工具类MetaObject

在编写插件的时候经常会使用到Mybatis提供的一个工具类MetaObject,可以有效地读取或修改一些重要对象的属性

// 获取对象属性值,支持OGNL
 public Object getValue(String name)
// 修改对象属性值,支持OGNL
 public void setValue(String name, Object value)

https://zhhll.icu/2020/框架/mybatis/组件分析/11.mybatis拦截器/

本文由mdnice多平台发布

相关推荐
魔道不误砍柴功2 小时前
Java 中如何巧妙应用 Function 让方法复用性更强
java·开发语言·python
NiNg_1_2342 小时前
SpringBoot整合SpringSecurity实现密码加密解密、登录认证退出功能
java·spring boot·后端
闲晨2 小时前
C++ 继承:代码传承的魔法棒,开启奇幻编程之旅
java·c语言·开发语言·c++·经验分享
测开小菜鸟3 小时前
使用python向钉钉群聊发送消息
java·python·钉钉
P.H. Infinity4 小时前
【RabbitMQ】04-发送者可靠性
java·rabbitmq·java-rabbitmq
生命几十年3万天4 小时前
java的threadlocal为何内存泄漏
java
caridle5 小时前
教程:使用 InterBase Express 访问数据库(五):TIBTransaction
java·数据库·express
^velpro^5 小时前
数据库连接池的创建
java·开发语言·数据库
苹果醋35 小时前
Java8->Java19的初步探索
java·运维·spring boot·mysql·nginx
秋の花5 小时前
【JAVA基础】Java集合基础
java·开发语言·windows