Mybatis源码分析(一)：xml解析部分

最新推荐文章于 2024-09-23 13:05:48 发布

西部落酋长

最新推荐文章于 2024-09-23 13:05:48 发布

阅读量362

点赞数

分类专栏： Mybatis 文章标签： Mybatis 源码

本文链接：https://blog.csdn.net/a913858/article/details/100104831

版权

本文主要分析Mybatis的源码，关注xml配置文件的解析过程。首先，从XMLConfigBuilder开始，解析环境变量和Mapper部分。接着，详细讲解了数据源解析，包括environmentsElement、dataSourceElement和property标签的处理。然后，转向Mapper映射文件的解析，通过mapperElement和mapperParser.parse()操作。最后，深入解析sql语句，包括buildStatementFromContext、parseStatementNode和XMLLanguageDriver的parseScriptNode与parseDynamicTags，实现了#{}和${}的替换。下篇将继续探讨sql执行部分。

摘要由CSDN通过智能技术生成

前言
针对源码总结分为二部分来看，一部分解析环境变量部分和mapper部分，另一部分为执行sql部分。先来看第一部分，xml解析的源码。

例子
一个简单的configuration配置文件和mapper文件，结合这个来看源码
config.xml

<configuration>
    <!-- mybatis 数据源环境配置 -->
    <environments default="dev">
        <environment id="dev">
            <!-- 配置数据源信息 -->
            <dataSource type="DBCP">
                <property name="driver" value="com.mysql.jdbc.Driver"></property>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis"></property>
                <property name="username" value="root"></property>
                <property name="password" value="root"></property>
            </dataSource>
        </environment>
    </environments>

    <!-- 映射文件加载 -->
    <mappers>
        <!-- resource指定映射文件的类路径 -->
        <mapper resource="mapper/UserMapper.xml"></mapper>
    </mappers>
</configuration>

UserMapper.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="user">
	<select id="findUserById" parameterType="com.mybatis.vo.User"
			resultType="com.mybatis.vo.User" statementType="prepared">
		SELECT * FROM user WHERE id = #{id}
	</select>
</mapper>

入口
XMLConfigBuilder 看这个类的名字我们可以看出来用来解析config配置文件，那我们来看源码部分

/**
   * 解析XML配置文件
   * @return
   */
  public Configuration parse() {
    if (parsed) {
      throw new BuilderException("Each XMLConfigBuilder can only be used once.");
    }
    parsed = true;
    // parser.evalNode("/configuration")：通过XPATH解析器，解析configuration根节点,
    //也就是<configuration></configuration>这个估计大家没有看到过，因为spring结合mybatis封装好了。
    // 从configuration根节点开始解析，最终将解析出的内容封装到Configuration对象中
    parseConfiguration(parser.evalNode("/configuration"));
    return configuration;
  }

通过parseConfiguration(parser.evalNode("/configuration"))方法来看下一方法

private void parseConfiguration(XNode root) {
    try {
      。。。。
      //这个里面有好多的方法，着重看这两个
      // 根据方法名顾名思义解析 数据源环境配置例如datasour解析就在这部分
      environmentsElement(root.evalNode("environments"));
      // 这个方法用来解析我们mappers标签，每个mappers里面有对应的子mapper的映射
      mapperElement(root.evalNode("mappers"));
    } catch (Exception e) {
      throw new BuilderException("Error parsing SQL Mapper Configuration. Cause: " + e, e);
    }
  }

这块来分层来看一下
1.数据源解析入口
environmentsElement(root.evalNode(“environments”))

private void environmentsElement(XNode context) throws Exception {
    if (context != null) {
      if (environment == null) {
      	//结合我们例子xml，如果为空取默认的属性，解析这块可以看个人Dom4j解析xml内容
        environment = context.getStringAttribute("default");
      }
      //获取子标签的属性
      for (XNode child : context.getChildren()) {
        String id = child.getStringAttribute("id");
        if (isSpecifiedEnvironment(id)) {
          //事务部分
          TransactionFactory txFactory = transactionManagerElement(child.evalNode("transactionManager"));
          //数据源部分，解析出来的数据源放入configuration对象中。这块使用了构建者模式
          DataSourceFactory dsFactory = dataSourceElement(child.evalNode("dataSource"));
          DataSource dataSource = dsFactory.getDataSource();
          //最终configuration封装