MyBatis 中允许你在某一点拦截已映射语句执行的调用(称为“拦截器”)。默认情况下,MyBatis 允许使用插件来拦截以下方法调用:
Executor (update, query, flushStatements, commit, rollback, getTransaction, close, isClosed)
ParameterHandler (getParameterObject, setParameters)
ResultSetHandler (handleResultSets, handleOutputParameters)
StatementHandler (prepare, parameterize, batch, update, query)
怎样定义拦截器将在后续章节详细介绍,这里只介绍怎样使用 <plugins> 标签配置自定义插件/拦截器。
MyBatis 中,使用 <plugins> 标签用来配置自定义插件/拦截器。在使用该标签之前,我们先看看该标签 DTD 定义。如下:
<!ELEMENT plugins (plugin+)> <!ELEMENT plugin (property*)> <!ATTLIST plugin interceptor CDATA #REQUIRED >
其中,一个 <plugins> 标签内部至少拥有一个 <plugin> 标签,且 <plugin> 标签中允许使用多个 <property> 定义属性。
示例代码:
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd"> <configuration> <properties resource="database.properties"/> <!-- 定义自定义插件和拦截器 --> <plugins> <plugin interceptor="com.hxstrive.mybatis.interceptor.MyInterceptor"> <property name="someProperty" value="100"/> </plugin> </plugins> <!-- 忽略其他配置 --> </configuration>
上面使用 <property> 定义了一个 someProperty 属性值,我们可以在拦截器内部的 setProperties() 方法中获取到。