前言
我會一步一步帶你剖析MyBatis這個經典的半ORM框架的原始碼!
我是使用Spring Boot + MyBatis的方式進行測試,但並未進行整合,還是使用最原始的方式。
專案結構
匯入依賴:
-
mybatis:mybatis
-
mysql-connector-java:mysql-connector-java
Payment表:
Payment實體類:
@Data
public class Payment implements Serializable {
private Integer id;
private String serial;
}
PaymentMapper介面:
@Repository
public interface PaymentMapper {
// 根據Id查詢支付資訊
Payment getPaymentById(@Param("id") Integer id);
}
配置檔案目錄:
Payment.xml:
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.gzy.mybatistest.mapper.PaymentMapper">
<select id="getPaymentById" parameterType="integer" resultType="com.gzy.mybatistest.entity.Payment">
SELECT * FROM payment WHERE id = #{id}
</select>
</mapper>
database.properties:
# 配置資料庫資訊
driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/spring_cloud?serverTimezone=Asia/Shanghai
username=username
password=password
mybatis-config.xml:
<?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>
<!-- 匯入外部的資料庫Properties配置檔案 -->
<properties resource="database.properties"/>
<!-- 配置MyBatis的環境變數 -->
<environments default="dev">
<environment id="dev">
<!-- 配置事務管理器 -->
<transactionManager type="JDBC"></transactionManager>
<!-- 配置資料來源 -->
<dataSource type="POOLED">
<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>
</environment>
</environments>
<!-- 配置SQL對映檔案 -->
<mappers>
<mapper resource="Payment.xml"/>
</mappers>
</configuration>
測試類:
@SpringBootTest
class MybatisTestApplicationTests {
@Test
void contextLoads() {
InputStream inputStream = null;
try {
inputStream = Resources.getResourceAsStream("mybatis-config.xml");
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
SqlSession sqlSession = sqlSessionFactory.openSession();
Payment payment = sqlSession.selectOne("com.gzy.mybatistest.mapper.PaymentMapper.getPaymentById", 1);
System.out.println(payment);
} catch (IOException e) {
e.printStackTrace();
} finally {
if (inputStream != null) {
try {
inputStream.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}
}
}
相關元件
Configuration:MyBatis所有的配置資訊都儲存在Configuration物件之中,配置檔案中的大部分配置都會儲存到該類中。
SqlSession:作為MyBatis工作的主要頂層API,表示和資料庫互動時的會話,完成必要資料庫增刪改查功能。
Executor:MyBatis執行器,是MyBatis 排程的核心,負責SQL語句的生成和查詢快取的維護。
StatementHandler:封裝了JDBC Statement操作,負責對JDBC Statement的操作,如設定引數等。
ParameterHandler:負責對使用者傳遞的引數轉換成JDBC Statement所對應的資料型別。
ResultSetHandler:負責將JDBC返回的ResultSet結果集物件轉換成List型別的集合。
TypeHandler:負責Java資料型別和Jdbc資料型別(也可以說是資料表列型別)之間的對映和轉換。
MappedStatement:MappedStatement維護一條<select|update|delete|insert>節點的封裝。
SqlSource:負責根據使用者傳遞的ParameterObject,動態地生成SQL語句,將資訊封裝到BoundSql物件中並返回。
BoundSql:表示動態生成的SQL語句以及相應的引數資訊。
執行步驟
第一步
這一步的主要目的就是將MyBatis配置檔案載入進記憶體中。
InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
MyBatis的配置檔案主要有兩個:database.properties和mybatis-config.xml。database.properties用於配置資料庫的連線資訊,而mybatis-config.xml則是MyBatis的主配置檔案,mybatis-config.xml中引入了database.properties的資料庫連線資訊。
這裡MyBatis為我們封裝了一個資源讀取的工具類Resources,getResourceAsStream方法預設會使用系統類載入器(SystemClassLoader)從resources路徑下載入指定檔案並且返回一個輸入流。
// Resources類,從上至下依次呼叫
public static InputStream getResourceAsStream(String resource) throws IOException {
return getResourceAsStream(null, resource);
}
// getResourceAsStream過載方法
public static InputStream getResourceAsStream(ClassLoader loader, String resource) throws IOException {
// MyBatis在ClassLoader類基礎上封裝了一層ClassLoaderWrapper包裝類
// 我們可以指定所使用類載入,預設為null
InputStream in = classLoaderWrapper.getResourceAsStream(resource, loader);
if (in == null) {
throw new IOException("Could not find resource " + resource);
}
return in;
}
// ClassLoaderWrapper類
public InputStream getResourceAsStream(String resource, ClassLoader classLoader) {
return getResourceAsStream(resource, getClassLoaders(classLoader));
}
ClassLoader[] getClassLoaders(ClassLoader classLoader) {
return new ClassLoader[]{
classLoader, // null
defaultClassLoader, // null
Thread.currentThread().getContextClassLoader(), // SystemClassLoader
getClass().getClassLoader(), // SystemClassLoader
systemClassLoader}; // SystemClassLoader
}
// getResourceAsStream過載方法
InputStream getResourceAsStream(String resource, ClassLoader[] classLoader) {
for (ClassLoader cl : classLoader) {
if (null != cl) {
InputStream returnValue = cl.getResourceAsStream(resource);
if (null == returnValue) {
returnValue = cl.getResourceAsStream("/" + resource);
}
if (null != returnValue) {
return returnValue;
}
}
}
return null;
}
第二步
這一步的主要目的就是解析MyBatis的XML主配置檔案,然後將配置資訊存入Configuration類中,最後通過Configuration類建立一個SqlSessionFactory介面的實現類DefaultSqlSessionFactory。
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
MyBatis使用了建造者模式來建立一個SqlSessionFactory,在SqlSessionFactoryBuilder類中只有build方法(還包括多個過載方法),該方法會建立並返回一個SqlSessionFactory物件。
build方法裡面又會看到一個XMLConfigBuilder類,看名字就能知道它是通過XML主配置檔案來構建Configuration類。
最終build方法會返回一個SqlSessionFactory介面的實現類DefaultSqlSessionFactory,該類中儲存了之前解析出來的Configuration物件。
// SqlSessionFactoryBuilder類中的build方法
public SqlSessionFactory build(InputStream inputStream) {
return build(inputStream, null, null);
}
// SqlSessionFactoryBuilder類中的build過載方法
public SqlSessionFactory build(InputStream inputStream, String environment, Properties properties) {
try {
// 解析XML主配置檔案
XMLConfigBuilder parser = new XMLConfigBuilder(inputStream, environment, properties);
// 返回DefaultSqlSessionFactory物件
return build(parser.parse());
} catch (Exception e) {
throw ExceptionFactory.wrapException("Error building SqlSession.", e);
} finally {
// 清空ThreadLocal中儲存的ErrorContext
ErrorContext.instance().reset();
try {
inputStream.close();
} catch (IOException e) {
// Intentionally ignore. Prefer previous error.
}
}
}
// 通過解析後的Configuration物件建立DefaultSqlSessionFactory物件
public SqlSessionFactory build(Configuration config) {
return new DefaultSqlSessionFactory(config);
}
public class DefaultSqlSessionFactory implements SqlSessionFactory {
// 儲存了之前解析出來的Configuration物件
private final Configuration configuration;
public DefaultSqlSessionFactory(Configuration configuration) {
this.configuration = configuration;
}
@Override
public SqlSession openSession() {
return openSessionFromDataSource(configuration.getDefaultExecutorType(), null, false);
}
// 省略其他內容...
}
首先要做的是解析XML主配置檔案前的準備工作!
現在我們進入XMLConfigBuilder類的構造方法,多個過載構造方法層層呼叫,最終呼叫了父類BaseBuilder的構造方法。
ErrorContext類是用來記錄本次執行過程中相關上下文資訊,待發生Error時候其他元件就可以從本類例項中獲取到相關的上下文資訊,這對於排錯是非常有幫助的。
// 繼承了抽象類BaseBuilder
public class XMLConfigBuilder extends BaseBuilder {
private boolean parsed;
private final XPathParser parser;
private String environment;
private final ReflectorFactory localReflectorFactory = new DefaultReflectorFactory();
public XMLConfigBuilder(InputStream inputStream, String environment, Properties props) {
// 建立了一個XPahParser物件
this(new XPathParser(inputStream, true, props, new XMLMapperEntityResolver()), environment, props);
}
private XMLConfigBuilder(XPathParser parser, String environment, Properties props) {
// 呼叫父類的構造方法,同時初始化了一個Configuration物件
super(new Configuration());
ErrorContext.instance().resource("SQL Mapper Configuration");
this.configuration.setVariables(props);
// 表示當前還並未解析完成
this.parsed = false;
// 指定MyBatis所使用環境
this.environment = environment;
// 指定MyBatis所使用的XML解析器
this.parser = parser;
}
// 省略其他內容...
}
在BaseBuilder構造方法中建立了兩個物件:
- TypeAliasRegistry。
- TypeHandlerRegistry。
public abstract class BaseBuilder {
protected final Configuration configuration;
// 型別別名註冊中心
protected final TypeAliasRegistry typeAliasRegistry;
// 型別處理註冊中心
protected final TypeHandlerRegistry typeHandlerRegistry;
public BaseBuilder(Configuration configuration) {
this.configuration = configuration;
this.typeAliasRegistry = this.configuration.getTypeAliasRegistry();
this.typeHandlerRegistry = this.configuration.getTypeHandlerRegistry();
}
// 省略其他內容...
}
TypeAliasRegistry:看類名很容易知道它用於註冊一些預設的型別別名。這些別名全都儲存在一個名為typeAliases的Map集合中,全部都為小寫,包括基本資料型別、基本資料型別的包裝類、陣列類、集合類等。
public class TypeAliasRegistry {
// 儲存型別別名
private final Map<String, Class<?>> typeAliases = new HashMap<>();
//
public TypeAliasRegistry() {
registerAlias("string", String.class);
registerAlias("byte", Byte.class);
registerAlias("long", Long.class);
registerAlias("short", Short.class);
registerAlias("int", Integer.class);
registerAlias("integer", Integer.class);
registerAlias("double", Double.class);
registerAlias("float", Float.class);
registerAlias("boolean", Boolean.class);
// 省略其他內容...
}
// 別名的註冊方法,MyBatis預設註冊和我們自己註冊都是使用該方法
public void registerAlias(String alias, Class<?> value) {
if (alias == null) {
throw new TypeException("The parameter alias cannot be null");
}
// 設定別名為小寫字串
String key = alias.toLowerCase(Locale.ENGLISH);
// 如果別名已存在就丟擲異常
if (typeAliases.containsKey(key) && typeAliases.get(key) != null && !typeAliases.get(key).equals(value)) {
throw new TypeException("The alias '" + alias + "' is already mapped to the value '" + typeAliases.get(key).getName() + "'.");
}
// 將別名存入集合
typeAliases.put(key, value);
}
}
因此我們在XML對映檔案中可以直接使用這些預設別名:
TypeHandlerRegistry:看類名很容易知道它用於資料庫型別與Java型別之間的轉換(雙向轉換),以及與資料庫之間資料的傳送和獲取。例如在獲取結果時將資料庫中的VARCHAR型別轉換為Java的String型別、在傳送SQL時將Java的Double或double型別轉換為資料庫中的Double型別等。
型別轉換的原理也很簡單,就是使用原生JDBC ResultSet結果集中不同資料型別所對應的獲取方法和設定方法,例如getSring(String columnLabel)、setString(int parameterIndex, String x)、getByte(String columnLabel)等。
public class StringTypeHandler extends BaseTypeHandler<String> {
// 在向資料傳送SQL時由資料庫驅動將Java型別轉為對應的資料庫型別
@Override
public void setNonNullParameter(PreparedStatement ps, int i, String parameter, JdbcType jdbcType)
throws SQLException {
ps.setString(i, parameter);
}
// 在獲取結果時將資料庫型別轉換為對應的Java型別
@Override
public String getNullableResult(ResultSet rs, String columnName)
throws SQLException {
return rs.getString(columnName);
}
// 省略其他內容...
}
Configuration類非常簡單,就是用來儲存MyBatis所有配置資訊的類,例如所使用的資料庫環境、是否啟動駝峰對映、是否啟動主鍵生成策略、是否啟動一級快取等。
// 用於儲存MyBatis的配置資訊
public class Configuration {
protected Environment environment;
protected boolean safeRowBoundsEnabled;
protected boolean safeResultHandlerEnabled = true;
protected boolean mapUnderscoreToCamelCase;
protected boolean aggressiveLazyLoading;
protected boolean multipleResultSetsEnabled = true;
protected boolean useGeneratedKeys;
protected boolean useColumnLabel = true;
protected boolean cacheEnabled = true; //預設開啟一級快取
protected boolean callSettersOnNulls;
// 省略其他內容...
}
XMLConfigBuilder構造方法中建立了一個XML解析器,就是XPathParser,它的作用是通過XPath語言來解析XML主配置檔案。
XPath:是一門在XML文件中查詢資訊的語言。XPath可用來在XML文件中對元素和屬性進行遍歷,XPath是W3C XSLT標準的主要元素,並且XQuery和XPointer都構建於XPath表達之上。
可以看見在commonConstructor方法中通過XPathFactory類建立了一個XPath物件。
public class XPathParser {
private final Document document;
private boolean validation;
private EntityResolver entityResolver;
private Properties variables;
private XPath xpath;
// 構造方法
public XPathParser(InputStream inputStream,
boolean validation, Properties variables, EntityResolver entityResolver) {
commonConstructor(validation, variables, entityResolver);
// 根據XML主配置檔案輸入流建立Document物件
this.document = createDocument(new InputSource(inputStream));
}
private void commonConstructor(boolean validation,
Properties variables, EntityResolver entityResolver) {
this.validation = validation;
this.entityResolver = entityResolver;
this.variables = variables;
XPathFactory factory = XPathFactory.newInstance();
this.xpath = factory.newXPath();
}
// 省略其他內容...
}
InputSource:表示XML實體的單個輸入源。
Document:Document介面表示整個HTML或XML文件。從概念上講,它是文件樹的根,並提供對文件資料的基本訪問。
EntityResolver:這個介面主要用於處理本地的XML約束檔案(DTD或Schema),MyBatis中使用的是XMLMapperEntityResolver實現類。
XMLMapperEntityResolver類中指明瞭MyBatis本地的的DTD約束檔案路徑,並且提供了載入約束檔案的方法實現。
public class XMLMapperEntityResolver implements EntityResolver {
private static final String IBATIS_CONFIG_SYSTEM = "ibatis-3-config.dtd";
private static final String IBATIS_MAPPER_SYSTEM = "ibatis-3-mapper.dtd";
private static final String MYBATIS_CONFIG_SYSTEM = "mybatis-3-config.dtd";
private static final String MYBATIS_MAPPER_SYSTEM = "mybatis-3-mapper.dtd";
// MyBatis本地的DTD檔案路徑
private static final String MYBATIS_CONFIG_DTD = "org/apache/ibatis/builder/xml/mybatis-3-config.dtd";
private static final String MYBATIS_MAPPER_DTD = "org/apache/ibatis/builder/xml/mybatis-3-mapper.dtd";
// 省略其他內容...
}
準備工作完成後就開始真正的解析工作!
先說明一下,我們可以看出主配置檔案的最外層節點是<configuration>標籤,mybatis的初始化就是把這個標籤以及他的所有子標籤進行解析,把解析好的資料封裝在Configuration這個類中。
public SqlSessionFactory build(InputStream inputStream, String environment, Properties properties) {
try {
XMLConfigBuilder parser = new XMLConfigBuilder(inputStream, environment, properties);
// 真正地解析XML主配置檔案
return build(parser.parse());
} catch (Exception e) {
throw ExceptionFactory.wrapException("Error building SqlSession.", e);
} finally {
ErrorContext.instance().reset();
try {
inputStream.close();
} catch (IOException e) {
// Intentionally ignore. Prefer previous error.
}
}
}
我們進入到XPathBuilder類parse方法中,可以看到它會先進行一個判斷,判斷MyBatis的XML主配置檔案是否已經被解析過,這個parsed屬性預設為false。
parseConfiguration方法開始解析XML主配置檔案。該方法傳入的是一個XNode引數,這個XNode類其實是MyBatis對官方提供的Node類的一層封裝。
XNode引數的由來:XPathParser對XPath路徑表示式“/configuration”對之前儲存的Document物件(代表整個XML主配置檔案)進行解析,解析出一個代表著<Configuration>節點的Node,然後將Node封裝成XNode。
public Configuration parse() {
if (parsed) {
throw new BuilderException("Each XMLConfigBuilder can only be used once.");
}
parsed = true;
// 構建了一個XNode物件
parseConfiguration(parser.evalNode("/configuration"));
return configuration;
}
private void parseConfiguration(XNode root) {
try {
// issue #117 read properties first
// 這裡依次解析XML主配置檔案的各個標籤
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);
// read it after objectFactory and objectWrapperFactory issue #631
environmentsElement(root.evalNode("environments"));
databaseIdProviderElement(root.evalNode("databaseIdProvider"));
typeHandlerElement(root.evalNode("typeHandlers"));
mapperElement(root.evalNode("mappers"));
} catch (Exception e) {
throw new BuilderException("Error parsing SQL Mapper Configuration. Cause: " + e, e);
}
}
我們可以看出這個方法是對<configuration>的所有子標籤輪流解析。比如常在配置檔案中出現的settings屬性配置,在settings會配置快取,日誌之類的,還有typeAliases是配置別名,environments是配置資料庫連結和事務。這些子節點會被一個個解析並且把解析後的資料封裝在Configuration這個類中,可以看第二步方法的返回值就是Configuration物件。
在這裡我們重點分析的解析mappers這個子標籤,這個標籤裡面還會有一個個的mapper標籤去對映mapper所對應的mapper.xml,可以回頭看看主配置檔案。
這個方法一開始是一個迴圈,因為一個<mappers>節點下面可能會有很多<mapper>節點。在應用中肯定不止一個mapper.xml。所以他會去遍歷每一個<mapper>節點去解析該節點所對映的XML檔案。迴圈下面是一個判斷,它先判斷<mappers>下面的子節點是不是package節點,因為在實際開發中有很多的XML檔案,有時我們會乾脆用一個<package>節點去對映一個包下面的所有的XML檔案,這是多檔案對映。如果不是<package>節點那肯定就是<mapper>節點做單檔案對映。
我們看下面的三行程式碼,發現單檔案對映有三種方式:
-
第一種使用<mapper>節點的resource屬性直接對映XML檔案。
-
第二種是使用<mapper>節點url屬性對映網路或者磁碟路徑下的某個XML檔案。
-
第三種是使用<mapper>節點的class屬性直接對映某個mapper介面。
private void mapperElement(XNode parent) throws Exception {
if (parent != null) {
for (XNode child : parent.getChildren()) {
// 判斷是否為多檔案對映
if ("package".equals(child.getName())) {
String mapperPackage = child.getStringAttribute("name");
// 解析出要對映的包路徑並新增至Configuration物件中
configuration.addMappers(mapperPackage);
} else {
// 單檔案對映
// 先解析出三種對映方式的路徑
String resource = child.getStringAttribute("resource");
String url = child.getStringAttribute("url");
String mapperClass = child.getStringAttribute("class");
if (resource != null && url == null && mapperClass == null) { // resource的方式
ErrorContext.instance().resource(resource);
InputStream inputStream = Resources.getResourceAsStream(resource);
XMLMapperBuilder mapperParser = new XMLMapperBuilder(inputStream, configuration, resource, configuration.getSqlFragments());
mapperParser.parse();
} else if (resource == null && url != null && mapperClass == null) { // url的方式
ErrorContext.instance().resource(url);
InputStream inputStream = Resources.getUrlAsStream(url);
XMLMapperBuilder mapperParser = new XMLMapperBuilder(inputStream, configuration, url, configuration.getSqlFragments());
mapperParser.parse();
} else if (resource == null && url == null && mapperClass != null) { // mapper介面的方式
Class<?> mapperInterface = Resources.classForName(mapperClass);
configuration.addMapper(mapperInterface);
} else {
throw new BuilderException("A mapper element may only specify a url, resource or class, but not more than one.");
}
}
}
}
}
實際上對映XML的方式看原始碼可以得出有三種方式,我們先看resource方式。
第一行程式碼的意思是例項化一個錯誤上下文物件,我們回憶一下我們使用MyBatis的過程中如果出現錯誤會不會提示這個錯誤在哪個XML中,還提示這個錯誤在XML中的哪個SQL中。這個物件的作用就是把錯誤資訊封裝起來,如果出現錯誤就會呼叫這個物件的toString方法。
然後就跟一開始解析XML主配置檔案十分相似,使用流的形式讀取類路徑下的Mapper對映檔案,再XMLMapperBuilder類解析。而且XMLMapperBuilder類的構造和XMLConfigBuilder十分相似,只是多了一個用於儲存SQL片段XNode的Map集合。
if (resource != null && url == null && mapperClass == null) { // resource的方式
ErrorContext.instance().resource(resource);
InputStream inputStream = Resources.getResourceAsStream(resource);
XMLMapperBuilder mapperParser = new XMLMapperBuilder(inputStream, configuration, resource, configuration.getSqlFragments());
mapperParser.parse();
}
public class XMLMapperBuilder extends BaseBuilder {
private final XPathParser parser;
private final MapperBuilderAssistant builderAssistant;
private final Map<String, XNode> sqlFragments;
private final String resource;
// 省略其他內容...
}
我們再進入XMLMapperBuilder類的parse方法,一開始就判斷這個XML是否被解析過了。因為Configuration物件會維護一個String型別的Set集合loadedResources,這個集合中存放了所有已經被解析過的XML的名字。
如果還未解析過,就會獲取一個代表<mapper>節點的XNode物件,然後對<mapper>節點下的所有子節點輪流解析,比如常用的有<resultMap>節點、<sql>節點等。
public void parse() {
if (!configuration.isResourceLoaded(resource)) {
configurationElement(parser.evalNode("/mapper"));
configuration.addLoadedResource(resource);
bindMapperForNamespace();
}
parsePendingResultMaps();
parsePendingCacheRefs();
parsePendingStatements();
}
// 依次對mapper節點下的所有子節點進行解析
private void configurationElement(XNode context) {
try {
String namespace = context.getStringAttribute("namespace");
if (namespace == null || namespace.isEmpty()) {
throw new BuilderException("Mapper's namespace cannot be empty");
}
builderAssistant.setCurrentNamespace(namespace);
cacheRefElement(context.evalNode("cache-ref"));
cacheElement(context.evalNode("cache"));
parameterMapElement(context.evalNodes("/mapper/parameterMap"));
resultMapElements(context.evalNodes("/mapper/resultMap"));
sqlElement(context.evalNodes("/mapper/sql"));
// 根據select、insert、update和delete節點構建statement
buildStatementFromContext(context.evalNodes("select|insert|update|delete"));
} catch (Exception e) {
throw new BuilderException("Error parsing Mapper XML. The XML location is '" + resource + "'. Cause: " + e, e);
}
}
在末尾我們可以看到有一個buildStatementFromContext方法,它解析了<select>、<insert>、<update>、<delete>四個節點,構建了一個存有所有關聯了SQL語句節點的XNode集合。在buildStatementFromContext方法中,它會先判斷是否指定了所使用的資料庫。然後就是遍歷解析List集合,這個List集合裡裝的是XML中的所有SQL節點,比如“select insert update delete” ,每一個SQL是一個節點。
XMLStatementBuilder類是會話解析器,用於解析每個SQL節點。
private void buildStatementFromContext(List<XNode> list) {
if (configuration.getDatabaseId() != null) {
buildStatementFromContext(list, configuration.getDatabaseId());
}
buildStatementFromContext(list, null);
}
private void buildStatementFromContext(List<XNode> list, String requiredDatabaseId) {
// 遍歷存有SQL節點的集合
for (XNode context : list) {
final XMLStatementBuilder statementParser = new XMLStatementBuilder(configuration, builderAssistant, context, requiredDatabaseId);
try {
// 對SQL節點進行解析
statementParser.parseStatementNode();
} catch (IncompleteElementException e) {
configuration.addIncompleteStatement(statementParser);
}
}
}
```[]()