起源:https://www.cnblogs.com/chenp…
背景
对于 Mybatis 插件,大部分人都晓得,也都应用过,但很多时候,咱们仅仅是停留在表面上,晓得 Mybatis 插件能够在 DAO 层进行拦挡,如打印执行的 SQL 语句日志,做一些权限管制,分页等性能;但对其外部实现机制,波及的软件设计模式,编程思维往往没有深刻的了解。
本篇案例将帮忙读者对 Mybatis 插件的应用场景,实现机制,以及其中波及的编程思维进行一个小结,心愿对当前的编程开发工作有所帮忙。
注:本案例以 mybatis 3.4.7-SNAPSHOT 版本为例。
PS:文章是挺久之前写的,过后花了一些心理,存到电脑的 word 里,明天正好看到,就是外面的源码都是图片,哈哈哈,凑合着看吧。
Mybatis 插件典型实用场景
分页性能
mybatis 的分页默认是基于内存分页的(查出所有,再截取),数据量大的状况下效率较低,不过应用 mybatis 插件能够扭转该行为,只须要拦挡 StatementHandler 类的 prepare 办法,扭转要执行的 SQL 语句为分页语句即可;
公共字段对立赋值
个别业务零碎都会有创建者,创立工夫,批改者,批改工夫四个字段,对于这四个字段的赋值,实际上能够在 DAO 层对立拦挡解决,能够用 mybatis 插件拦挡 Executor 类的 update 办法,对相干参数进行对立赋值即可;
性能监控
对于 SQL 语句执行的性能监控,能够通过拦挡 Executor 类的 update, query 等办法,用日志记录每个办法执行的工夫;
其它
其实 mybatis 扩展性还是很强的,基于插件机制,基本上能够管制 SQL 执行的各个阶段,如执行阶段,参数解决阶段,语法构建阶段,后果集解决阶段,具体能够依据我的项目业务来实现对应业务逻辑。
Mybatis 插件介绍
什么是 Mybatis 插件
与其称为 Mybatis 插件,不如叫 Mybatis 拦截器,更加合乎其功能定位,实际上它就是一个拦截器,利用代理模式,在办法级别上进行拦挡。
反对拦挡的办法
- 执行器 Executor(update、query、commit、rollback 等办法);
- 参数处理器 ParameterHandler(getParameterObject、setParameters 办法);
- 后果集处理器 ResultSetHandler(handleResultSets、handleOutputParameters 等办法);
- SQL 语法构建器 StatementHandler(prepare、parameterize、batch、update、query 等办法);
拦挡阶段
那么这些类上的办法都是在什么阶段被拦挡的呢?为了解这个问题,咱们先看段简略的代码(摘自 mybatis 源码中的单元测试 SqlSessionTest 类),来理解下典型的 mybatis 执行流程,如下代码所示:
以上代码次要实现以下性能:
- 读取 mybatis 的 xml 配置文件信息
- 通过 SqlSessionFactoryBuilder 创立 SqlSessionFactory 对象
- 通过 SqlSessionFactory 获取 SqlSession 对象
- 执行 SqlSession 对象的 selectList 办法,查问后果
- 敞开 SqlSession
如下是时序图,在整个时序图中,波及到 mybatis 插件局部已标红,基本上就是体现在上文中提到的四个类上,对这些类上的办法进行拦挡。
Mybatis 插件实现机制
插件配置信息的加载
先来看下 mybatis 是如何加载插件配置的,对应的 xml 配置信息如下:
对应的解析代码如下,次要做以下工作:
- 依据解析到的类信息创立 Interceptor 对象;
- 调用 setProperties 办法设置属性变量;
- 增加到 Configuration 的 interceptorChain 拦截器链中;
以上逻辑对应的时序图如下:
代理对象的生成
Mybatis 插件的实现机制次要是基于动静代理实现的,其中最为要害的就是代理对象的生成,所以有必要来理解下这些代理对象是如何生成的。
Executor 代理对象
ParameterHandler 代理对象
ResultSetHandler 代理对象
StatementHandler 代理对象
察看源码,发现这些可拦挡的类对应的对象生成都是通过 InterceptorChain 的 pluginAll 办法来创立的,进一步察看 pluginAll 办法,如下:
遍历所有拦截器,调用拦截器的 plugin 办法生成代理对象,留神生成代理对象从新赋值给 target,所以如果有多个拦截器的话,生成的代理对象会被另一个代理对象代理,从而造成一个代理链条,执行的时候,顺次执行所有拦截器的拦挡逻辑代码;
接下来看一下咱们在编写拦截器的时候,一个典型的 plugin 办法实现形式,如下:
再进一步查看 wrap 办法,如下:
典型的动静代理实现,调用的是 Proxy.newProxyInstance 办法来生成代理对象。
以上逻辑对应的时序图如下,这里咱们假如申明了两个拦截器,那么在创立 target 代理对象的时候,最终返回的代理对象 proxy2,实际上代理了 proxy1,而 proxy1 又代理了 target,:
拦挡逻辑的执行
因为真正去执行 Executor、ParameterHandler、ResultSetHandler 和 StatementHandler 类中的办法的对象是代理对象(倡议将代理对象转为 class 文件,反编译查看其构造,帮忙了解),所以在执行办法时,首先调用的是 Plugin 类(实现了 InvocationHandler 接口)的 invoke 办法,如下:
首先依据执行办法所属类获取拦截器中申明须要拦挡的办法汇合;
判断以后办法需不需要执行拦挡逻辑,需要的话,执行拦挡逻辑办法(即 Interceptor 接口的 intercept 办法实现),不须要则间接执行原办法。
能够关注下 Interceptor 接口的 intercept 办法实现,个别须要用户自定义实现逻辑,其中有一个重要参数,即 Invocation 类,通过改参数咱们能够获取执行对象,执行办法,以及执行办法上的参数,从而进行各种业务逻辑实现,个别在该办法的最初一句代码都是 invocation.proceed()(外部执行 method.invoke 办法),否则将无奈执行下一个拦截器的 intercept 办法。
以上逻辑对应的时序图如下,这里咱们以执行 executor 对象的 query 办法为例,且假如有两个拦截器存在:
Mybatis 插件开发例子
这里以分页插件为例,来理解下个别 mybatis 插件的编写规定,如下所示:
次要须要实现三个办法
- intercept: 在此实现本人的拦挡逻辑,可从 Invocation 参数中拿到执行办法的对象,办法,办法参数,从而实现各种业务逻辑, 如下代码所示,从 invocation 中获取的 statementHandler 对象即为被代理对象,基于该对象,咱们获取到了执行的原始 SQL 语句,以及 prepare 办法上的分页参数,并更改 SQL 语句为新的分页语句,最初调用 invocation.proceed() 返回后果。
- plugin:生成代理对象;
- setProperties:设置一些属性变量;
小结
简略的说,mybatis 插件就是对 ParameterHandler、ResultSetHandler、StatementHandler、Executor 这四个接口上的办法进行拦挡,利用 JDK 动静代理机制,为这些接口的实现类创立代理对象,在执行办法时,先去执行代理对象的办法,从而执行本人编写的拦挡逻辑,所以真正要用好 mybatis 插件,次要还是要相熟这四个接口的办法以及这些办法上的参数的含意;
另外,如果配置了多个拦截器的话,会呈现层层代理的状况,即代理对象代理了另外一个代理对象,造成一个代理链条,执行的时候,也是层层执行;
对于 mybatis 插件波及到的设计模式和软件思维如下:
- 设计模式:代理模式、责任链模式;
- 软件思维:AOP 编程思维,升高模块间的耦合度,使业务模块更加独立;
一些注意事项:
- 不要定义过多的插件,代理嵌套过多,执行办法的时候,比拟耗性能;
- 拦截器实现类的 intercept 办法里最初不要忘了执行 invocation.proceed() 办法,否则多个拦截器状况下,执行链条会断掉;
近期热文举荐:
1.1,000+ 道 Java 面试题及答案整顿 (2022 最新版)
2. 劲爆!Java 协程要来了。。。
3.Spring Boot 2.x 教程,太全了!
4. 别再写满屏的爆爆爆炸类了,试试装璜器模式,这才是优雅的形式!!
5.《Java 开发手册(嵩山版)》最新公布,速速下载!
感觉不错,别忘了顺手点赞 + 转发哦!