MyBatis源码分析-2 SqlSessionFactoryBuilder源码解析

快来打我* 2022-11-19 09:41 252阅读 0赞

**                                                                                                                                                                                                                                                                                                                       作者：田超凡**

**                                                                                                                                                                                                                                                                                                       版权所有，严禁复制转载**

1 SqlSessionFactoryBuilder顾名思义，是MyBatis会话工厂的构造器，也是整个MyBatis容器运行的基本前提，**负责读取MyBatis配置信息并解析和装载Mapper映射器、映射文件中的SQL，统一封装成DTO便于容器在其他地方获取和使用。**

2 **SqlSessionFactoryBuilder是线程不安全的**，但是无须担心，因为内部限制了SqlSessionFactoryBuilder的build()方法只能被调用一次。SqlSessionFactoryBuilder的**作用域是request级别的(用完即销毁)，当且仅当MyBatis容器第一次启动初始化的时候才会调用。**

3 SqlSessionFactoryBuilder核心处理逻辑都封装到了该方法中，说白了SqlSessionFactoryBuilder只做3件事：

**(1) 读取MyBatis核心配置文件并注册为Configuration**

**(2) 根据MyBatis核心配置文件中的配置解析Mapper映射器接口和映射文件，建立ORM映射**，保存映射器接口和映射文件的关联关系、映射器接口方法和映射文件SQL id，便于后续容器直接取用，这是一种饿汉模式的实现策略，这样做的好处是：容器启动时消耗时间把所有地方需要引用的配置和SQL都注册好，调用的时候直接按需取用即可，这是一种容器化的集中式管理思想，加载容器速度慢，获取配置和执行SQL速度快，当然这个执行SQL速度快是相对的，这里的快是指调用Mapper接口中的方法执行SQL语句的时候，方法对应的SQL语句已经在启动时就注册存好了，直接获取即可进行下一步执行，而不需要在每次调用方法的时候都去解析对应的映射文件和SQL，这样效率就大大提高。

**(3) 创建会话工厂SqlSessionFactory**

4 容器化集中式管理配置和依赖的缺陷也很明显，那就是容器启动性能很低，如果扫描的映射器接口和映射文件数量比较多，体积比较大的情况下，那么性能会大打折扣，典型的时间换空间。

1 读取mybatis-config.xml核心配置文件，获取对应的输入流Reader对象。

reader = Resources.getResourceAsReader(resources);

2 使用SqlSessionFactoryBuilder获取SqlSessionFactory源码分析

SqlSessionFactory sqlMapper = new SqlSessionFactoryBuilder().build(reader);

**源码分析：**

**2.1 断点调试，进入到build方法，在build方法里面会创建XMLConfigBuilder这个类，这个类用来基于XPath解析XML文件并将配置项封装为Configuration，将解析的SQL映射文件中的SQL和对应的映射器接口方法封装为MappedStatement，建立映射器接口和映射文件的关联关系映射**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDU2MzQx_size_16_color_FFFFFF_t_70][]

2.2 调用XMLConfigBuilder的parse方法，开始解析XML文件并装载配置

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDU2MzQx_size_16_color_FFFFFF_t_70 1][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDU2MzQx_size_16_color_FFFFFF_t_70 2][]

2.3 在XPathParser的构造函数中实现对XML文件的解析

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDU2MzQx_size_16_color_FFFFFF_t_70 3][]

2.4 初始化XPathParser之后，继续执行XMLConfigBuilder的构造器，会先调用父类BaseBuilder的构造函数初始化基础配置，Configuration对于所有构造器是全局共享的，因为MyBatis全局配置只会解析和加载一次，所以也只会封装一次Configuration和初始化

![20210121231722175.png][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDU2MzQx_size_16_color_FFFFFF_t_70 4][]

2.5 默认当前还没有解析所有需要加载和注册的Mapper映射文件及其绑定接口，所以parsed默认是false。注意，SqlSessionFactoryBuilder的build方法只能执行一次，因为该方法封装了解析所有Mapper配置的代码，默认MyBatis启动时只会加载和注册一次Mapper映射文件和接口

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDU2MzQx_size_16_color_FFFFFF_t_70 5][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDU2MzQx_size_16_color_FFFFFF_t_70 6][]

2.6 正式开始基于XPath解析MyBatis的核心配置文件，将解析到的配置信息都注入到BaseBuilder的Configuration里面

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDU2MzQx_size_16_color_FFFFFF_t_70 7][]

parseConfiguration解析MyBatis核心配置文件中的配置项代码解析：

\# 解析<properties>配置的全局变量

propertiesElement(root.evalNode("properties"));

\# 解析<settings>全局配置中的日志插件，基于适配器模式初始化MyBatis日志系统

Properties settings = settingsAsProperties(root.evalNode("settings"));

loadCustomVfs(settings);

loadCustomLogImpl(settings);

\# 解析<typeAliases>全局POJO别名配置

typeAliasesElement(root.evalNode("typeAliases"));

\# 解析<plugins>配置的第三方插件

pluginElement(root.evalNode("plugins"));

\#解析<objectFactory>、<objectWrapperFactory>、<reflectorFactory>配置的自定义MyBatis实例工厂

objectFactoryElement(root.evalNode("objectFactory"));

objectWrapperFactoryElement(root.evalNode("objectWrapperFactory"));

reflectorFactoryElement(root.evalNode("reflectorFactory"));

\# 解析<settings>全局配置中除了日志系统外的其他配置

settingsElement(settings);

\# 解析<environments>配置的数据源和事务管理器

environmentsElement(root.evalNode("environments"));

\# 多数据源配置的情况下，解析主数据源配置

databaseIdProviderElement(root.evalNode("databaseIdProvider"));

\# 解析和注册自定义类型转换器TypeHandlers

typeHandlerElement(root.evalNode("typeHandlers"));

\# 解析需要扫描的Mapper映射文件目录并注册Mapper映射器接口的代理工厂MapperProxyFactory

mapperElement(root.evalNode("mappers"));

2.7 mapperElement解析Mapper映射文件，加载绑定的Mapper接口并建立ORM映射

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDU2MzQx_size_16_color_FFFFFF_t_70 8][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDU2MzQx_size_16_color_FFFFFF_t_70 9][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDU2MzQx_size_16_color_FFFFFF_t_70 10][]

2.8 SqlSessionFactioryBuilder对MyBatis配置文件和MyBatis映射文件解析完毕，返回封装好的Configuration

![20210121231913855.png][]

2.9 基于解析的Configuration创建默认的会话工厂，DefaultSqlSessionFactory全局单例

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDU2MzQx_size_16_color_FFFFFF_t_70 11][]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDU2MzQx_size_16_color_FFFFFF_t_70]: /images/20221119/d041f8b22f884b1780a78b55d154318b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDU2MzQx_size_16_color_FFFFFF_t_70 1]: /images/20221119/e99eb7d67d804c00b0ef75d734384ddf.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDU2MzQx_size_16_color_FFFFFF_t_70 2]: /images/20221119/4375e05491d54c2f8525f97f251d88a4.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDU2MzQx_size_16_color_FFFFFF_t_70 3]: /images/20221119/925dadd194ca4065b90538d0df2af95f.png
[20210121231722175.png]: /images/20221119/ff713e0d9e154efcad1b1c6f5d597217.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDU2MzQx_size_16_color_FFFFFF_t_70 4]: /images/20221119/d6d7fb064da94194b3d900bc53d58414.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDU2MzQx_size_16_color_FFFFFF_t_70 5]: /images/20221119/f6fad887b4644139b9e8240894dba0bd.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDU2MzQx_size_16_color_FFFFFF_t_70 6]: /images/20221119/e45f728c3d2341d1b41a1659d55e578c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDU2MzQx_size_16_color_FFFFFF_t_70 7]: /images/20221119/daca243d01c943089748223825fdcd82.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDU2MzQx_size_16_color_FFFFFF_t_70 8]: /images/20221119/f421640d372a47f2984fdcc7abe2bb29.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDU2MzQx_size_16_color_FFFFFF_t_70 9]: /images/20221119/e563999beb684bcd98db1b6670e332eb.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDU2MzQx_size_16_color_FFFFFF_t_70 10]: /images/20221119/26d49987bedf422f8f46cbc7a2a2bfb5.png
[20210121231913855.png]: /images/20221119/6df6e4595f4d4a26872efa0f37abd0b3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDU2MzQx_size_16_color_FFFFFF_t_70 11]: https://img-blog.csdnimg.cn/20210121231924466.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMwMDU2MzQx,size_16,color_FFFFFF,t_70