浅析MyBatis的配置加载流程

前言


在原始MyBatis的使用中,使用MyBatis时会先读取配置文件mybatis-config.xml为字符流或者字节流,然后通过SqlSessionFactoryBuilder基于配置文件的字符流或字节流来构建SqlSessionFactory

本篇文章将结合MyBatis源码,对读取配置文件mybatis-config.xml和构建SqlSessionFactory的原理进行学习。

正文


原始MyBatis读取配置文件mybatis-config.xml和构建SqlSessionFactory的一个示例如下。

InputStreaminputStream= Resources.getResourceAsStream("mybatis-config.xml");
SqlSessionFactorysqlSessionFactory=newSqlSessionFactoryBuilder().build(inputStream);
复制代码

上述示例中的Resources工具类提供了方法可以读取classpath下指定名字的文件为字符流或者字节流,这里是使用了其提供的getResourceAsStream() 方法将mybatis-config.xml 文件读取为字节流。SqlSessionFactoryBuilder是一个建造者,其提供了共计9个重载的build() 方法用于构建SqlSessionFactory,这9个build() 方法可以分为三类,概括如下。

  1. 基于配置文件字符流构建SqlSessionFactory

  1. 基于配置文件字节流构建SqlSessionFactory

  1. 基于Configuration类构建SqlSessionFactory

实际上,基于配置文件字符流和基于配置文件字节流构建的方式,最终都是将字符流或字节流解析并生成Configuration类,然后基于Configuration类构建SqlSessionFactory

下面以基于配置文件字节流构建SqlSessionFactory的过程为例,对整个读配置文件的流程进行说明。上面的示例中调用的build() 方法如下所示。

public SqlSessionFactory build(InputStream inputStream) {
    return build(inputStream, null, null);
}
复制代码

上面被调用的重载的build() 方法如下所示。

public SqlSessionFactory build(InputStream inputStream, String environment, Properties properties) {
    try {
        // XMLConfigBuilder会解析配置文件并生成Configuration类XMLConfigBuilderparser=newXMLConfigBuilder(inputStream, environment, properties);
        // 调用入参为Configuration的build()方法构建SqlSessionFactory并返回return build(parser.parse());
    } catch (Exception e) {
        throw ExceptionFactory.wrapException("Error building SqlSession.", e);
    } finally {
        ErrorContext.instance().reset();
        try {
            inputStream.close();
        } catch (IOException e) {

        }
    }
}
复制代码

可以发现,配置文件的解析是发生在XMLConfigBuilderparse() 方法中,在查看parse() 方法前,先看一下XMLConfigBuilder的类图,如下所示。

通过XMLConfigBuilder的类图可以知道,XMLConfigBuilder解析配置文件是依靠XPathParser,而XPathParserMyBatis提供的基于JAVA XPath的解析器。同时,XMLConfigBuilder内部维护了一个Configuration,通过XPathParser解析配置文件得到的配置属性均会丰富到Configuration中。

现在开始分析XMLConfigBuilderparse() 方法,其实现如下所示。

public Configuration parse() {
    if (parsed) {
        thrownewBuilderException("Each XMLConfigBuilder can only be used once.");
    }
    parsed = true;
    parseConfiguration(parser.evalNode("/configuration"));
    return configuration;
}
复制代码

要理解parse() 方法,最好是和一个实际的配置文件进行对照,如下给出一个实际的配置文件。

<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE configurationPUBLIC"-//mybatis.org//DTD Config 3.0//EN""http://mybatis.org/dtd/mybatis-3-config.dtd"><configuration><settings><settingname="useGeneratedKeys"value="true"/></settings><environmentsdefault="development"><environmentid="development"><transactionManagertype="JDBC"/><dataSourcetype="POOLED"><propertyname="driver"value="com.mysql.cj.jdbc.Driver"/><propertyname="url"value="jdbc:mysql://localhost:3306/test?characterEncoding=utf-8&amp;serverTimezone=UTC&amp;useSSL=false"/><propertyname="username"value="root"/><propertyname="password"value="root"/></dataSource></environment></environments><mappers><packagename="com.mybatis.learn.dao"/></mappers></configuration>复制代码

所以在parse() 方法中,首先是获取配置文件的configuration节点(根节点),然后将configuration节点传入parseConfiguration() 方法,接着在parseConfiguration() 方法中会根据传入的configuration节点依次获取子节点并读取子节点属性,最后将获取到的属性丰富进ConfigurationparseConfiguration() 方法实现如下所示。

privatevoidparseConfiguration(XNode root) {
    try {
        propertiesElement(root.evalNode("properties"));
        Propertiessettings= settingsAsProperties(root.evalNode("settings"));
        loadCustomVfs(settings);
        loadCustomLogImpl(settings);
        typeAliasesElement(root.evalNode("typeAliases"));
        pluginElement(root.evalNode("plugins"));
        objectFactoryElement(root.evalNode("objectFactory"));
        objectWrapperFactoryElement(root.evalNode("objectWrapperFactory"));
        reflectorFactoryElement(root.evalNode("reflectorFactory"));
        settingsElement(settings);
        // 丰富environments标签及其子标签的属性到Configuration中
        environmentsElement(root.evalNode("environments"));
        databaseIdProviderElement(root.evalNode("databaseIdProvider"));
        typeHandlerElement(root.evalNode("typeHandlers"));
        // 丰富mappers标签的属性到Configuration中
        mapperElement(root.evalNode("mappers"));
    } catch (Exception e) {
        thrownewBuilderException("Error parsing SQL Mapper Configuration. Cause: " + e, e);
    }
}
复制代码

最后parse() 方法会返回ConfigurationSqlSessionFactoryBuilder会基于Configuration创建DefaultSqlSessionFactory并返回,如下所示。

public SqlSessionFactory build(Configuration config) {
    returnnewDefaultSqlSessionFactory(config);
}
复制代码

DefaultSqlSessionFactory类图如下所示。

至此,读取配置文件mybatis-config.xml和构建SqlSessionFactory的基本原理已经介绍完毕。

总结


本篇文章对MyBatis读取配置文件并构建SqlSessionFactory的一个整体流程进行了介绍,可以概括如下。

  1. Resources工具类获取配置文件输入字符流或字节流;

  1. 创建SqlSessionFactoryBuilder

  1. SqlSessionFactoryBuilder中会创建XMLConfigBuilder来解析配置文件得到全局唯一Configuration

  1. 基于Configuration创建DefaultSqlSessionFactory

实际上,关于MyBatis配置文件的读取,最关键的部分在于如何注册映射文件/映射接口,该部分内容,会在后面的文章中进行学习。

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值