Mybatis源码-XXXmapper.xml中的select|insert|update|delete标签解析过程

前提:上次讲过一篇《Mybatis源码-XXXmapper.xml中的resultMap标签解析过程》,现在就在上篇文章基础上讲一讲Mybatis是如何解析XXXmapper.xml文件中的select|insert|update|delete标签的,由于这几种标签的方式是一致的,下面我将以update标签为例,介绍一下update标签的解析过程。

在这里还是先贴一下需要解析的updateByPrimaryKeySelective方法:

mapper的xml转java代码 mapper.xml update_元素节点

1. 首先进入select|insert|update|delete解析入口:XMLMapperBuilder#configurationElement。

mapper的xml转java代码 mapper.xml update_元素节点_02

2. XMLStatementBuilder#parseStatementNode是负责解析单前的select|insert|update|delete节点,主要就是拿到节点属性去XMLLanguageDriver#createSqlSource中解析节点的子节点属性,解析完拿到SqlSource对象,将SqlSource注册到大管家中。

public void parseStatementNode() {
	// 拿到当前update标签的id属性:updateByPrimaryKeySelective
    String id = context.getStringAttribute("id");
	// 标签上配置的数据源databaseId
    String databaseId = context.getStringAttribute("databaseId");
	// requiredDatabaseId为当前默认的数据源id,只有这二个id相等后才能正确的去解析该标签
    if (!databaseIdMatchesCurrent(id, databaseId, this.requiredDatabaseId)) {
      return;
    }

	// 标签上配置的parameterType属性:cn.edu.his.pay.model.entity.Admin
    String parameterType = context.getStringAttribute("parameterType");
	// 反射拿到该类的反射Clas对象
    Class<?> parameterTypeClass = resolveClass(parameterType);
    String resultType = context.getStringAttribute("resultType");

	// 拿到nodeName就是对应的是什么标签,如update,insert等等,sqlCommandType非常重要,其实就是确定是那一类操作
    String nodeName = context.getNode().getNodeName();
    SqlCommandType sqlCommandType = SqlCommandType.valueOf(nodeName.toUpperCase(Locale.ENGLISH));
    // 显然现在是解析update标签而不是Select,false
	boolean isSelect = sqlCommandType == SqlCommandType.SELECT;

    // *** 重点-这里会进一步展开来看
    SqlSource sqlSource = langDriver.createSqlSource(configuration, context, parameterTypeClass);
    String resultSets = context.getStringAttribute("resultSets");
    String keyProperty = context.getStringAttribute("keyProperty");
    String keyColumn = context.getStringAttribute("keyColumn");
    // 在insert语句中我们可以在Insert标签下定义一个<selectKey>标签用于生成主键id,同样也可以自己生成 
	KeyGenerator keyGenerator;
    String keyStatementId = id + SelectKeyGenerator.SELECT_KEY_SUFFIX;
    keyStatementId = builderAssistant.applyCurrentNamespace(keyStatementId, true);
    if (configuration.hasKeyGenerator(keyStatementId)) {
      keyGenerator = configuration.getKeyGenerator(keyStatementId);
    } else {
      keyGenerator = context.getBooleanAttribute("useGeneratedKeys",
          configuration.isUseGeneratedKeys() && SqlCommandType.INSERT.equals(sqlCommandType))
          ? Jdbc3KeyGenerator.INSTANCE : NoKeyGenerator.INSTANCE;
    }

	// 将解析后的SqlSource封装到大管家中
    builderAssistant.addMappedStatement(id, sqlSource, statementType, sqlCommandType,
        fetchSize, timeout, parameterMap, parameterTypeClass, resultMap, resultTypeClass,
        resultSetTypeEnum, flushCache, useCache, resultOrdered, 
        keyGenerator, keyProperty, keyColumn, databaseId, langDriver, resultSets);
  }

3. 上图代码中介绍了SqlSource的重要性,现在就更加深入的SqlSource是怎么产生的,这个时候就来到了XMLScriptBuilder#parseScriptNode方法,即就是解析当前的update标签的重点,可以看出如下的context就是当前需要解析的update类型的节点。

mapper的xml转java代码 mapper.xml update_sql_03

接着拿到update节点的信息调用XMLScriptBuilder#parseDynamicTags来解析这个节点,解析的时候主要就是判断当前节点下的属性类型,哪些是TEXT_NODE(文本节点),哪些是ELEMENT_NODE(元素节点)。当为文本节点是就直接往contents(负责封装节点信息)集合中加入一个StaticTextSqlNode。否则继续解析元素节点,并调用对于元素节点的处理类递归的去解析。

mapper的xml转java代码 mapper.xml update_子节点_04

mapper的xml转java代码 mapper.xml update_mapper的xml转java代码_05

mapper的xml转java代码 mapper.xml update_元素节点_06

4. 这里就不再贴出set元素节点的效果图了,就是通过子节点的循环,拿到子节点信息,判断是什么类型的子节点后通过对应的子节点处理器进行解析,解析的方法就是通过反复递归调用parseDynamicTags方法来完成的,如下是Mybatis的节点处理器类图。

mapper的xml转java代码 mapper.xml update_sql_07

5. 通过所有的解析过后会得到一个最外层的SqlNode集合contents,并将contents包装到MixedSqlNode对象中个,如下是整个MixedSqlNode结构图。

mapper的xml转java代码 mapper.xml update_mapper的xml转java代码_08

通过如上结构图发现,就一个简单的update标签,通过配置文件的解析后,会得到一个三个等级的封装,对应XXXmapper.xml中的update标签如下:

mapper的xml转java代码 mapper.xml update_mapper的xml转java代码_09

6. 最后附上包装的整体类图关系

mapper的xml转java代码 mapper.xml update_元素节点_10