一、基本概要

参见mybatis官方文档：点击打开链接

1. 快速开发；

2. 插件原理实现的主要技术和思想；

3. 为什么插件只支持Executor、StatementHandler、ResultSetHandler、ParameterHandler四种类型？

二、快速开发

mybatis插件开发极易上手，参见第一节中mybatis官方文档中的demo，只需要明白几个概念即可快速开发。

1. 官方示例

@Intercepts({ @Signature(type = Executor.class, method = "update", args = {
		MappedStatement.class, Object.class }) })
public class ExamplePlugin implements Interceptor {
	public Object intercept(Invocation invocation) throws Throwable {
		return invocation.proceed();
	}

	public Object plugin(Object target) {
		return Plugin.wrap(target, this);
	}

	public void setProperties(Properties properties) {
	}
}

2. 快速开发步骤

1. 实现Interceptor接口；

2. @Interceptor注解中的注意事项：

a. type是Executor、StatementHandler、ResultSetHandler、ParameterHandler中的一个或多个；

b. method为上述四个类型中定义的方法名；

c. args为b中需要拦截的method的参数类型；

3. 最后，在mybatis-config.xml中声明自定义开发的插件即可；

<plugins>
	<plugin interceptor="xx.xx.Xxxx" />
</plugins>

3. 注意事项

mybatis插件开发会存在重复代理的情况，因此在做插件开发的时候，最好在Interceptor.plugin方法中使用Class.isAssignableFrom(Class)来进行判断，避免重复代理问题。

至于为什么会产生重复代理，后续源码阅读时候会进一步分析。

三、插件支持类型

如上文所述，mybatis插件开发只支持四种类型，Executor、StatementHandler、ResultSetHandler、ParameterHandler。之所以mybatis只支持上述四种类型，其关键在于一句源码：interceptorChain.pluginAll(executor)。以Executor源码为例，简要分析为什么mybatis只支持这四种类型。

1. 思想及源码

1. 当new SqlSessionFactoryBuilder().builder(InputStream)的时候，mybatis会将mybatis-config.xml配置文件中的内容解析成Configuration对象，以便于运行时获取；

2. 此时所有<plugins>标签中plugin会被实例化并注册到Configuration的属性InterceptorChain中，在InterceptorChain中实际上是一个ArrayList来保存拦截器；

3. 当Mybatis启动完成后，SqlSessionFactory.openSession()，此时会通过配置中心Configuration实例化相应的Executor，在实例化的同时完成相应代理的生成；

4. 上述步骤中，interceptor.plugin(Object target)实际上是需要我们来实现Interceptor接口的，在实现接口的plugin方法时，target为目标代理类，即四种类型之一，而plugin中的逻辑主要是通过Plugin.warp(target, interceptor)来完成，最终生成相应的JDK动态代理；