Mybatis——拦截器Interceptor
本篇介绍Mybatis拦截器/插件相关知识,包括相关的类及作用、拦截器有哪几种、拦截器可以在Mybatis的执行过程中的哪些节点起作用、拦截器如何使用、相关的API,最后附上代码示例。
1. Mybatis拦截器是什么?一般用途?
MyBatis允许使用者在映射语句执行过程中的某一些指定的节点进行拦截调用,通过织入拦截器,在不同节点修改一些执行过程中的关键属性,从而影响SQL的生成、执行和返回结果,如:来影响Mapper.xml到SQL语句的生成、执行SQL前对预编译的SQL执行参数的修改、SQL执行后返回结果到Mapper接口方法返参POJO对象的类型转换和封装等。
根据上面的对Mybatis拦截器作用的描述,可以分析其可能的用途;最常见的就是Mybatis自带的分页插件PageHelper或Rowbound参数,通过打印实际执行的SQL语句,发现我们的分页查询之前,先执行了COUNT(*)语句查询数量,然后再执行查询时修改了SQL语句即在我们写的SQL语句后拼接上了分页语句LIMIT(offset, pageSize);
此外,实际工作中,可以使用Mybatis拦截器来做一些数据过滤、数据加密脱敏、SQL执行时间性能监控和告警等;既然要准备使用它,下面先来了解下其原理;
2. Mybatis执行过程
2.1 核心对象
从Mybatis关键代码的来看,MyBatis的主要的核心部件有以下几个:
- Configuration:初始化基础配置,比如MyBatis的别名等,一些重要的类型对象,如插件,映射器,ObjectFactory和typeHandler对象,MyBatis所有的配置信息都维持在Configuration对象之中。
- SqlSessionFactory:SqlSession工厂。
- SqlSession:作为MyBatis工作的主要顶层API,表示和数据库交互的会话,完成必要的数据库增删改查功能。
- Executor:MyBatis的内部执行器,它负责调用StatementHandler操作数据库,并把结果集通过ResultSetHandler进行自动映射,另外,它还处理二级缓存的操作。
- StatementHandler:MyBatis直接在数据库执行SQL脚本的对象。另外它也实现了MyBatis的一级缓存。
- ParameterHandler:负责将用户传递的参数转换成JDBC Statement所需要的参数。是MyBatis实现SQL入参设置的对象。
- ResultSetHandler:负责将JDBC返回的ResultSet结果集对象转换成List类型的集合。是MyBatis把ResultSet集合映射成POJO的接口对象。
- TypeHandler:负责Java数据类型和JDBC数据类型之间的映射和转换。
- MappedStatement:MappedStatement维护了一条<select|update|delete|insert>节点的封装。
- SqlSource :负责根据用户传递的parameterObject,动态地生成SQL语句,将信息封装到BoundSql对象中,并返回。
- BoundSql:表示动态生成的SQL语句以及相应的参数信息。
2.2 执行过程分析
详细的执行过程可以看数据加密(二)Mybatis拦截器中的3.2 Mybatis整体执行流程,或Mybatis执行流程及关键代码走读;先看下图:
问题:通过mybatis的<if>标签动态修改SQL语句,为什么不能通过ParameterHandler?
通过上面的图可以回答这个问题,在执行ParameterHandler之前,BoundSQL对象已经生成了,即预编译的SQL语句已经生成了;可见,BoundSql生成SQL语句的时机在于 statementHandler 的创建,由MappedStatementHandler.getBoundSql(Object parameterObject)函数解析动态标签,生成静态SQL语句,早于parameterHandler和ResultSetHandler的时机;因此,只能通过影响parameterObject(暂时先将其看成一个Map,键值分别为参数名和参数值)的值,来干预对Mapper.xml标签的解析过程,从而改变生成的BoundSql对象;
3. 如何使用Mybatis拦截器?(使用步骤)
自定义一个mybatis的拦截器步骤包含:
- 定义一个实现org.apache.ibatis.plugin.Interceptor接口的拦截器类,并实现其中的方法。
- 添加@Intercepts注解,写上需要拦截的对象和方法,以及方法参数。
- 在mybatis的全局配置xml中配置插件plugin;对于去xml的Spring工程,显示的注册这个拦截器Bean即可;
3.1 添加注解
MyBatis拦截器默认可以拦截的类型只有四种,即四种接口类型Executor、StatementHandler、ParameterHandler和ResultSetHandler。对于我们的自定义拦截器必须使用MyBatis提供的@Intercepts注解来指明我们要拦截的是四种类型中的哪一种接口。
3.1.1 @Signature注解
@Intercepts // 描述:标志该类是一个拦截器
@Signature // 描述:指明该拦截器需要拦截哪一个接口的哪一个方法
3.1.2 @Signature注解中的type属性
type; // 四种类型接口中的某一个接口,如Executor.class;
method; // 对应接口中的某一个方法名,比如Executor的query方法;
args; // 对应接口中的某一个方法的参数,比如Executor中query方法因为重载原因,有多个,args就是指明参数类型,从而确定是具体哪一个方法;
MyBatis拦截器默认会按顺序拦截以下的四个接口中的所有方法:
org.apache.ibatis.executor.Executor //拦截执行器方法
org.apache.ibatis.executor.statement.StatementHandler //拦截SQL语法构建处理
org.apache.ibatis.executor.parameter.ParameterHandler //拦截参数处理
org.apache.ibatis.executor.resultset.ResultSetHandler //拦截结果集处理
实际上,具体是拦截这四个接口对应的实现类:
org.apache.ibatis.executor.CachingExecutor
org.apache.ibatis.executor.statement.RoutingStatementHandler
org.apache.ibatis.scripting.defaults.DefaultParameterHandler
org.apache.ibatis.executor.resultset.DefaultResultSetHandler
这几个接口之间的关系大概是这样的:
3.2 实现org.apache.ibatis.plugin.Interceptor接口
实现Interceptor接口,主要是实现下面几个方法:intercept(Invocation invocation)、plugin(Object target) 、setProperties(Properties properties);
3.2.1 intercept方法
进行拦截的时候要执行的方法。该方法参数Invocation类中有三个字段:
private final Object target;private final Method method;private final Object[] args;
可通过这三个字段分别获取下面的信息:
Object target = invocation.getTarget(); //被代理对象
Method method = invocation.getMethod(); //代理方法
Object[] args = invocation.getArgs(); //方法参数
方法实现的结尾处,一般要真正调用被代理类的方法,即"return invocation.proceed();"
3.2.2 plugin方法
插件用于封装目标对象的,通过该方法我们可以返回目标对象本身,也可以返回一个它的代理,可以决定是否要进行拦截进而决定要返回一个什么样的目标对象,官方提供了示例:"return Plugin.wrap(target, this);";
Tips:可以在这个方法中提前进行拦截对象类型判断从而提高性能,如我们仅对Executor拦截,可以这么写:
@Overridepublic Object plugin(Object target) {// 只对要拦截制定类型的对象生成代理if(target instanceof Executor){// 调用插件return Plugin.wrap(target, this);}return target;}
MyBatis拦截器用到责任链模式+动态代理+反射机制;所有可能被拦截的处理类都会生成一个代理类,如果有N个拦截器,就会有N个代理,层层生成动态代理是比较耗性能的。而且虽然能指定插件拦截的位置,但这个是在执行方法时利用反射动态判断的,初始化的时候就是简单的把拦截器插入到了所有可以拦截的地方。所以尽量不要编写不必要的拦截器。另外我们可以在调用插件的地方添加判断,只要是当前拦截器拦截的对象才进行调用,否则直接返回目标对象本身,这样可以减少反射判断的次数,提高性能。
3.2.3 setProperties方法
如果我们拦截器需要用到一些变量参数,而且这个参数是支持可配置的,类似Spring中的@Value("${}")从application.properties文件获取自定义变量属性,这个时候我们就可以使用这个方法。
参考下方代码,在Mybatis配置文件中配置插件时可以设置参数,在setProperties函数中调用 Properties.getProperty("param1") 方法可以得到配置的值:
<plugins><plugin interceptor="com.xx.xx.xxxInterceptor"><property name="param1" value="value1"/></plugin>
</plugins>
实际上是解析XML,将XML中注册的拦截器的配置带过来;
3.3 代码示例
这里给一个拦截器的代码示例,如拦截Executor的查询和更新方法:
@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 ExecutorEncryptInterceptor implements Interceptor {/* ... */Properties properties = null;/*** 拦截方法逻辑* 这里主要是通过反射去获取要执行的SQL相关信息,然后进行操作*/@Overridepublic Object intercept(Invocation invocation) throws Throwable {Object target = invocation.getTarget(); //被代理对象Method method = invocation.getMethod(); //代理方法Object[] args = invocation.getArgs(); //方法参数MappedStatement mappedStatement = (MappedStatement) args[0];Object parameterObject = args[1];// do something ...方法拦截前执行代码块Object result = invocation.proceed();// do something ...方法拦截后执行代码块return result;}/*** 生成MyBatis拦截器代理对象*/@Overridepublic Object plugin(Object target) {if(target instanceof Executor){// 调用插件return Plugin.wrap(target, this);}return target;}/*** 设置插件属性(直接通过Spring的方式获取属性,所以这个方法一般也用不到)* 项目启动的时候数据就会被加载*/@Overridepublic void setProperties(Properties properties) {// 赋值成员变量,在其他方法使用this.properties = properties;}/* ... */}
参考:
MyBatis拦截器原理介绍 - 简书
MyBatis拦截器使用方法总结
Mybatis——拦截器Interceptor相关推荐
- Mybatis源码分析之(六)mybatis拦截器(Interceptor)的实现原理
文章目录 前言 InterceptorChain保存所有的Interceptor 创建四大对象都走Configuration InterceptorChain增强对象方法 Plugin封装动态代理,让 ...
- 真正理解mybatis拦截器以及Interceptor和Plugin作用
看了很多博客文章和,mybatis 的拦截器概念还是不能很好理解, 可能是因为自己基础不好或者理解方式和他人不同吧,所以决定自己花时间好好捋捋, 然后把理解后的总结记录下来,供他人参考,也许你们的理解 ...
- MySQL拦截器获取xml id_关于mybatis拦截器,有谁知道怎么对结果集进行拦截,将指定字段查询结果进行格式化...
用MyBatis结果集拦截器做过这样一个需求: 由于项目需求经常变动,项目MySQL数据库都是存放JSON字符串,例如:用户的基本信息随着版本升级可能会有变动 数据表 CREATE TABLE `ac ...
- list mybatis 接收 类型_基于mybatis拦截器实现的一款简易影子表自动切换插件
近期因工作需要,小编基于mybatis拦截器开发了一款简易影子表自动切换插件,可以根据配置实现动态修改表名,即将对原source table表的操作自动切换到对target table表的操作.该插件 ...
- 面试官:你能说说MyBatis拦截器原理吗?
点击上方"方志朋",选择"设为星标" 回复"666"获取新整理的面试资料 作者:Format cnblogs.com/fangjian042 ...
- 犯罪心理解读Mybatis拦截器
原文链接:"犯罪心理"解读Mybatis拦截器 Mybatis拦截器执行过程解析 文章写过之后,我觉得 "Mybatis 拦截器案件"背后一定还隐藏着某种设计动 ...
- MyBatis拦截器原理探究MyBatis拦截器原理探究
MyBatis拦截器介绍 MyBatis提供了一种插件(plugin)的功能,虽然叫做插件,但其实这是拦截器功能.那么拦截器拦截MyBatis中的哪些内容呢? 我们进入官网看一看: MyBatis拦截 ...
- MyBatis拦截器有哪些以及分析
MyBatis提供了一种插件(plugin)的功能,虽然叫做插件,但其实这是拦截器功能.那么拦截器拦截MyBatis中的哪些内容呢? 我们进入官网看一看: MyBatis 允许你在已映射语句执行过程中 ...
- Mybatis拦截器 mysql load data local 内存流处理
Mybatis 拦截器不做解释了,用过的基本都知道,这里用load data local主要是应对大批量数据的处理,提高性能,也支持事务回滚,且不影响其他的DML操作,当然这个操作不要涉及到当前所lo ...
- MyBatis拦截器原理探究
MyBatis拦截器介绍 MyBatis提供了一种插件(plugin)的功能,虽然叫做插件,但其实这是拦截器功能.那么拦截器拦截MyBatis中的哪些内容呢? 我们进入官网看一看: MyBatis 允 ...
最新文章
- 论机器学习领域的内卷:不读PhD,我配不配找工作?
- 小程序不同页面之间通讯的解决方案
- mysql默认排序规则_mysql 字符集与排序规则的简单了解
- 大数据在金融领域的应用及问题时
- [最全操作指南] 在线六个项目全部迁移Linux
- android 电池高温关机,Android 关机问题分析指南
- 华为PLC-IoT生态联盟成立,携手合作伙伴共赢智慧物联新时代
- 10.15 iptables filter表小案例;10.16—10.18 iptables nat
- 基于采样的路径规划算法总结
- Vue常用组件库集合---kalrry
- 戴尔电脑装ubuntu报ACPI错误解决过程
- Vue 视频音频播放
- 面试小纸条(MySQL第一弹)
- MR(混合现实)无绿幕拍摄
- 动环监控系统中B接口的实现
- 删除vlan 华为s5720_华为S5720系列交换机快速配置手册常用命令
- 微生物学期末复习重点
- kubernetes存储:local,openEBS,rook ceph
- k8s 介绍与基本使用
- 微前端 micro-app 源码研究-提前准备
热门文章
- html动画转换为桌面动态壁纸,怎么设置电脑动态壁纸-动态桌面,这个功能太好玩了...
- 汉王考勤 连接mysql_汉王考勤管理软件打开时出现:连接数据错误, 请确认数据库服务器信息是否有误.这样该怎样解决?, 大师请进来...
- 国产三维CAD/CAM软件SINOVATION10.2版本发布,亮点功能抢先看!
- python爬取链家二手房楼盘数据信息
- 婴幼儿体重在线计算机,宝宝身高体重标准计算器
- Python实验二——制作可视化标准计算器
- 通用的业务编码规则设计实现
- 大厂HR的新对手是Excel
- 数据解读 | 川菜出圈只靠辣?你太小瞧川菜了
- Win10系统隐藏磁盘