mybatis源码分析之02配置文件解析

该篇正式开始学习mybatis的源码，本篇主要学习mybatis是如何加载配置文件mybatis-config.xml的，先从测试代码入手。

public class V1Test {

    public static void main(String[] args) {

        try (InputStream is = Resources.getResourceAsStream("mybatis-config.xml")) {

            SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);

            SqlSession sqlSession = sqlSessionFactory.openSession(true);

            FemaleMapper femaleMapper = sqlSession.getMapper(FemaleMapper.class);

            Female female = femaleMapper.getFemaleById(1);

            System.out.println(female);

        } catch (Exception e) {

            e.printStackTrace();

        }

    }

}

1. 加载mybatis配置文件mybatis-config.xml

InputStream is = Resources.getResourceAsStream("mybatis-config.xml")

很显然，这句代码就是在加载mybatis-config.xml文件，mybatis框架封装了一个Resources类，通过它将xml文件解析成了BufferedInputStream流。

2. 生成SqlSessionFactory 实例

 SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);

看代码就知道，创建了一个SqlSessionFactoryBuilder实例，然后通过这个实例去构建一个SqlSessionFactory实例

SqlSessionFactoryBuilder实注解上面有这样一句“Builds {@link SqlSession} instances.” ，说明它与SqlSession是有个关系的。当然，我们主要是看它的build()方法，很容易看到下面这段代码。

public SqlSessionFactory build(InputStream inputStream, String environment, Properties properties) {

    try {

      XMLConfigBuilder parser = new XMLConfigBuilder(inputStream, environment, properties);

　　　　// 解析mybatis-config.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.

      }

    }

  }

接着parser.parse() 干的事

public Configuration parse() {

    if (parsed) {

      throw new BuilderException("Each XMLConfigBuilder can only be used once.");

    }

    parsed = true;

    parseConfiguration(parser.evalNode("/configuration"));

    return configuration;

  }

（1） parser.evalNode("/configuration") 解析获取到 mybatis-config.xml文件中configuration节点（底层其实是用的Xpath解析的）。

（2）parseConfiguration（configuration）解析configuration节点里面的内容，源码代码如下

  private void parseConfiguration(XNode root) {

    try {

      //issue #117 read properties first

      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);

    }

  }

再对比一下项目中的mybatis-config.xml文件，就很容易理解parseConfiguration(XNode configration) 方法中每行代码的意思了。

下面，我们重点分析 mapperElement(root.evalNode("mappers")) 这句代码，很明显它就是解析configuration节点下面的mappers节点的内容，下图的红框节点。

进入XMLConfigBuilder#mapperElement(), 咱们可以debug看一下具体情况，

哈哈，是不是跟上面加载mybatis-config.xml一样一样的，通过类加载器去加载xml文件，然后又构造了一个XMLMapperBuilder对象去解析这个xml文件流。

不过，与前面解析mybatis-config.xml文件不同，前面解析mybatis-config.xml文件是为了获取configuration节点下面的子节点; 而此处解析mapper节点，又干啥了呢，咱们接着往下看代码，进入mapperParser.parse()即可。

  public void parse() {

    if (!configuration.isResourceLoaded(resource)) {

      configurationElement(parser.evalNode("/mapper"));

      configuration.addLoadedResource(resource);

      bindMapperForNamespace();

    }

    parsePendingResultMaps();

    parsePendingCacheRefs();

    parsePendingStatements();

  }

parse()方法就是解析具体mapper.xml文件，里面的每一个方法都很重要。

（1） configurationElement(parser.evalNode("/mapper"))

　　解析mapper节点内容，源码如下

 private void configurationElement(XNode context) {

    try {

      String namespace = context.getStringAttribute("namespace");

      if (namespace == null || namespace.equals("")) {

        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"));

      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(context.evalNodes("select|insert|update|delete"))，这行代码就是对 CRUD的解析。

debug走起。。。。。。

因为我们的FemaleMapper.xml只有select操作，所以这里的list也只有一个元素。

接下来就是对select语句的具体操作了，具体可见XMLStatementBuilder#parseStatementNode() 方法

这段解析操作超级复杂，比如解析sql的入参类型，返回值类型，构造该sql的id（namespace+id），还有诸如是否使用cache，sql拼接等。。。

不过，这所有的一切都会封装在一个MappedStatement对象中，而这个MappedStatement 缓存在Configuration类上的名为mappedStatements的Map<String, MappedStatement>中，该mappedStatements的key就是namespace+id, value就是MappedStatement对象。

下面debug看一下

请注意，这个mappedStatements仅仅只是Configuration的一个属性呀！

至此，XMLMapperBuilder#parse()方法内的 configurationElement(parser.evalNode("/mapper"))就说完了，它主要是解析mapper.xml的文件中的mapper节点及其子节点内容，

并且将解析完的内容封装到一个MappedStatement对象上。

（2）configuration.addLoadedResource(resource)

　　这句代码简单，就是将FemaleMapper.xml缓存到Configuration类中的loadedResources属性中， loadedResources是一个HashSet

(3) bindMapperForNamespace()

　　该方法中主要完成了两件事，第1是通过namespace找到对应的mapper接口类，第2是将找到的mapper接口缓存到Configuration上。

我们主要是看看addMapper(boundType)方法，这里mybatis并不是像常规缓存那样，直接用个Map去存储起来。在这儿，mybatis又引入了一个MapperRegistry类,Configuration持有一个MapperRegistry实例，而mapper接口是缓存在MapperRegistry类中一个名为knownMappers的HashMap中，而且，缓存的也不是Mapper接口对象，而是该Mapper接口类对应的代理工厂类。

代码如下：

这个MapperProxyFactory类很重写，我们在调用FemaleMapper#getFemaleById(id)方法时，就是靠这个类生成代理对象，不然，FemaleMapper单单一个接口，毛用没有！

上面这一波操作完之后，我们就再次回来下面这段代码了，parser.parse()的全部逻辑就跑完了，返回一个Configuration实例。

public SqlSessionFactory build(InputStream inputStream, String environment, Properties properties) {

    try {

      XMLConfigBuilder parser = new XMLConfigBuilder(inputStream, environment, properties);

　　　　// 解析mybatis-config.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.

      }

    }

  }

build(parser.parse()) 就相当于 build(configuration)返回 SqlSessionFactory，源码如下：

public SqlSessionFactory build(Configuration config) {

    return new DefaultSqlSessionFactory(config);

  }

而DefaultSqlSessionFactory主要就是与数据库打交道了，咱们下次再说。

最后，总结一下：

1. MyBatis 通过 Resources类去读取xml配置文件，底层是是通classLoader来实现的

2. 具体解析xml文件是通过 XMLConfigBuilder类，底层是通过Xpath来实现的

3. 通过XMLMapperBuilder类来解析XxxMapper.xml配置文件中mapper节点及其子节点

4. 通过MappedStatement封装mapper节点及其子节点的内容，同时将MappedStatement对象缓存到Configuration对象中

5. 通过MapperRegistry缓存mapper接口对应的MapperProxyFactory

6. 总之，Mybatis将xml内容解析出来，通过Configuration类进行了封装

7. 最后SqlSessionFactory通过解析出来的Configuration来创建SqlSession对象，最终操作数据库。

8. 大体流程如下图

巴特西

mybatis源码分析之02配置文件解析

最新文章

热门文章