前言
在原始Mybatis
的应用中,应用Mybatis
时会先读取配置文件mybatis-config.xml
为字符流或者字节流,而后通过SqlSessionFactoryBuilder
基于配置文件的字符流或字节流来构建SqlSessionFactory
。本节将联合Mybatis
源码,对读取配置文件mybatis-config.xml
和构建SqlSessionFactory
的原理进行学习。
注释
原始Mybatis
读取配置文件mybatis-config.xml
和构建SqlSessionFactory
的一个示例如下。
InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
上述示例中的Resources
工具类提供了办法能够读取classpath下指定名字的文件为字符流或者字节流,这里是应用了其提供的getResourceAsStream()
办法将mybatis-config.xml
文件读取为字节流。SqlSessionFactoryBuilder
是一个建造者,其提供了共计9个重载的build()
办法用于构建SqlSessionFactory
,这9个build()
办法能够分为三类,概括如下。
- 基于配置文件字符流构建
SqlSessionFactory
; - 基于配置文件字节流构建
SqlSessionFactory
; - 基于
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类
XMLConfigBuilder parser = new XMLConfigBuilder(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) {
}
}
}
能够发现,配置文件的解析是产生在XMLConfigBuilder
的parse()
办法中,在查看parse()
办法前,先看一下XMLConfigBuilder
的类图,如下所示。
通过XMLConfigBuilder
的类图能够晓得,XMLConfigBuilder
解析配置文件是依附XPathParser
,而XPathParser
是Mybatis
提供的基于JAVA XPath
的解析器。同时,XMLConfigBuilder
外部保护了一个Configuration
,通过XPathParser
解析配置文件失去的配置属性均会丰盛到Configuration
中。
当初开始剖析XMLConfigBuilder
的parse()
办法,其实现如下所示。
public Configuration parse() {
if (parsed) {
throw new BuilderException("Each XMLConfigBuilder can only be used once.");
}
parsed = true;
parseConfiguration(parser.evalNode("/configuration"));
return configuration;
}
要了解parse()
办法,最好是和一个理论的配置文件进行对照,如下给出一个理论的配置文件。
<?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>
<settings>
<setting name="useGeneratedKeys" value="true"/>
</settings>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="com.mysql.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/test?characterEncoding=utf-8&serverTimezone=UTC&useSSL=false"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
<mappers>
<package name="com.mybatis.learn.dao"/>
</mappers>
</configuration>
所以在parse()
办法中,首先是获取配置文件的configuration节点(根节点),而后将configuration节点传入parseConfiguration()
办法,接着在parseConfiguration()
办法中会依据传入的configuration节点顺次获取子节点并读取子节点属性,最初将获取到的属性丰盛进Configuration
。parseConfiguration()
办法实现如下所示。
private void parseConfiguration(XNode root) {
try {
propertiesElement(root.evalNode("properties"));
Properties settings = 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) {
throw new BuilderException("Error parsing SQL Mapper Configuration. Cause: " + e, e);
}
}
最初parse()
办法会返回Configuration
,SqlSessionFactoryBuilder
会基于Configuration
创立DefaultSqlSessionFactory
并返回,如下所示。
public SqlSessionFactory build(Configuration config) {
return new DefaultSqlSessionFactory(config);
}
DefaultSqlSessionFactory
类图如下所示。
至此,读取配置文件mybatis-config.xml
和构建SqlSessionFactory
的基本原理曾经介绍结束。
总结
本篇文章是对Mybatis
读取配置文件并构建SqlSessionFactory
的一个整体流程进行了介绍,即通过Resources
工具类获取配置文件输出字符流或字节流,而后通过SqlSessionFactoryBuilder
创立DefaultSqlSessionFactory
,在SqlSessionFactoryBuilder
中是通过XMLConfigBuilder
来实现配置文件属性的读取并丰盛进Configuration
,SqlSessionFactoryBuilder
也是基于XMLConfigBuilder
返回的Configuration
创立的DefaultSqlSessionFactory
。实际上,对于Mybatis
配置文件的读取,最要害的局部在于如何注册映射文件/映射接口,该局部内容,会在前面的文章中进行学习。