酷应用

Spring整合MyBatis之底层原理

百家作者：51CTO技术栈 2022-11-14 23:41:18

作者 | 波哥

审校 | 孙淑娟

如果老铁们对Spring框架足够熟悉，整合MyBatis其实很容易理解，当然这里假定老铁们也已经熟悉了MyBatis框架。

在我们正常的应用开发过程中，使用MyBatis一般分为如下几个步骤：

1.在配置类上增加MapperScan注解，例如：@MapperScan(basePackages = {"com.test.dao"},annotationClass = Mapper.class)；

2.在basePackages指定的目录下创建待MyBatis读取的接口文件，例如：

@Mapper
public interface TestMapper {
......
}

3.在Service或者其他地方使用该Mapper来操作数据库。

使用起来是很简单的，但是有没有老铁想过，为什么做了这么一个简单的配置，这个Mapper就能操作数据库了？按理说这个Mapper是个接口，应该是不能被创建才对啊！如果你有这个疑问，证明你是个爱思考的好童鞋。

咱们直接进入主题。Spring要与MyBatis整合，简单来说只要解决如下两个问题：

Spring如何知道哪些类应该被管理？

要让Spring去管理Bean的生命周期，首先需要对应的类被Spring扫描到，并且生成DeanDefinition，然后基于BeanDefinition生成Bean。下面对Spring生成BeanDefinition的方式做个小总结：

包含Component、Configuration、ComponentScan、Import、ImportResource注解的类；
Import注解中指定的类、被Bean注解标注的方法所在的类；
实现了ImportBeanDefinitionRegistrar接口，并且在registerBeanDefinitions方法中调用registry直接注册的类；
实现了ImportSelector接口，并且在selectImports方法中返回的字符串对应的类；
直接调用register方法；
另外Spring还提供了一个扩展，可以让开发者自己指定需要被管理的类对应的类型：通过往includeFilters中添加注解类类型。

我们分析源码，第一步得找到它的入口，Spring整合MyBatis的入口，毫无疑问是MapperScan这个注解，在MapperScan注解上包含Import(MapperScannerRegistrar.class)注解，Spring整合MyBatis正是用了Import和ImportBeanDefinitionRegistrar的方式。我们先通过一张流程图来了解下整体流程，然后再慢慢品。

我们来看MapperScannerRegistrar这个类的继承关系图：

MapperScannerRegistrar是ImportBeanDefinitionRegistrar的实现类，Spring会去调用这个类的registerBeanDefinitions方法添加beanDefinition，这个方法中具体做了些什么呢：

获取MapperScan注解的配置信息，比如basePackages、annotationClass，basePackages表示需要扫描的路径，annotationClass则是指定了增加了这种注解类的类需要被Spring进行管理，比如增加了Mapper注解的类需要被Spring管理。
生成MapperScannerConfigurer这个类型的beanDefinition，并且把MapperScan注解的配置信息添加到该beanDefinition的属性集合中。

后续Spring就会基于这个MapperScannerConfigurer做一系列文章，看下它的继承关系：

它是BeanDefinitionRegistryPostProcessor的实现类，是一个BeanFactory后置处理器，Spring会调用该类的postProcessBeanDefinitionRegistry方法来添加beanDefinition的操作，MapperScannerConfigurer这个类中具体实现如下：

它定义了ClassPathMapperScanner这个扫描器，然后使用这个扫描器来扫描类，扫描哪些类呢？扫描有Mapper注解的类，看它的关系知道，它是ClassPathBeanDefinitionScanner的子类，而spring则是使用ClassPathBeanDefinitionScanner来进行扫描的。

为什么ClassPathMapperScanner能够扫描到带有Mapper注解的类呢？看上面代码，就是通过调用registerFilters方法来添加includeFilter（实际类型是：TypeFilter），这个就是Spring提供的扩展点，让咱们自己来指定需要被扫描的类，这里使用的是MappScan注解中annotationClass属性配置的注解类型，我们这里配置了Mapper，所以调用scan方法开启扫描后，Spring就会将包含Mapper注解的类扫描为BeanDefinition。注意这里的扫描能力还是调用Spring的扫描器来实现的，ClassPathMapperScanner并没有修改，只是当扫描完成后，ClassPathMapperScanner会对扫描出的BeanDefinition进行重新处理，主要是把原来的BeanClass修改成了MapperFactoryBean.class：

而这个MapperFactoryBean是FactoryBean的实现类，老铁们，FactoryBean这种Bean有什么特点？这个可是面试的高发点哦。

做个小小的总结：Spring扫描到有Mapper注解的类，生成BeanDefinition，并且将这一类BeanDefinition的BeanClass的值修改为MapperFactoryBean，也就是说它的类型不再是咱们自己编写的Mapper接口了，而是一个FactoryBean，这样Spring就能做妖了。

Mapper注解的类是接口

那如何实例化呢？

到这一步，其实老铁们也大概清楚了，Spring在实例化Mapper实例时，实际上首先会实例化MapperFactoryBean，然后再调用它的getObject方法。我们知道在Java里面接口是肯定不能被实例化的，那这个被实例化的对象只能是一个代理对象，所以我们有理由猜想这个getObject方法应该是用来创建代理对象的。要创建代理对象，得从以下两个方面着手：