Mybatis源码分析(四):构建sqlSessionFactory

4.1构建sqlSessionFactory流程

加载完资源文件,下一步就是构建sqlSessionFactory

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

SqlSessionFactoryBuilder类主要方法有下面两个:

public SqlSessionFactory build(InputStream inputStream, String environment, Properties properties) {
    try {
      //第一步,构建XMLConfigBuilder对象
      XMLConfigBuilder parser = new XMLConfigBuilder(inputStream, environment, properties);
      return build(parser.parse()/*第二步,生成Configuration对象*/)//第三步,生成DefaultSqlSessionFactory;
    } 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.
      }
    }
  }

  public SqlSessionFactory build(Configuration config) {
    return new DefaultSqlSessionFactory(config);
  }

构建sqlSessionFactory主要分3步:

第一步:根据配置文件、环境变量和properties构建XMLConfigBuilder对象。

第二步:.XMLConfigBuilder对象生成Configuration对象(parser.parse()方法)。

第三步:.根据Configuration对象生成DefaultSqlSessionFactory。

通过以上三步,文章开头的sqlSessionFactory的值等于一个DefaultSqlSessionFactory对象,构建sqlSessionFactory完成。下面我们对涉及到类和方法详细介绍。

4.2 SqlSessionFactoryBuilder

SqlSessionFactoryBuilder是一个构建sqlSessionFactory的工具类,提供了一些重载的方法,主要的方法就是上面介绍的两个。

4.3 BaseBuilder

XMLConfigBuilder是BaseBuilder的众多子类之一,XMLConfigBuilder扮演的是具体建造者的角色,BaseBuilder扮演的是抽象建造者的角色。BaseBuilder 中核心宇段的含义如下:

//Configuration MyBatis初始化过程的核心对象,MyBatis中几乎全部的配置信息会保存到Configuration对象中
  //Configuration对象是在MyBatis初始化过程中创建且是全局唯一的,也有人称它是一个“All-In-One ”配置对象 
  protected final Configuration configuration;
  //在 mybatis-config xml配置文件中可以使用<typeAliases>标签定义别名,这些定义的别名都会记录在TypeAliasRegistry对象中
  protected final TypeAliasRegistry typeAliasRegistry;
  //mybatis-config.xml配置文件中可以使用<typeHandlers>标签添加自定义TypeHandler完成数据库类型与Java类型的转换
  protected final TypeHandlerRegistry typeHandlerRegistry;

typeAliasRegistry与typeHandlerRegistry,都是从configuratioin中来,所以也是全局唯一的,从BaseBuilder的构造函数可以看出:

public BaseBuilder(Configuration configuration) {
    this.configuration = configuration;
    this.typeAliasRegistry = this.configuration.getTypeAliasRegistry();
    this.typeHandlerRegistry = this.configuration.getTypeHandlerRegistry();
  }

4.4 XMLConfigBuilder

XMLConfigBuilder主要负责解析mybatis-config.xml 配置文件,生成Configuration对象,代码如下:

private XMLConfigBuilder(XPathParser parser, String environment, Properties props) {
    super(new Configuration());
    ErrorContext.instance().resource("SQL Mapper Configuration");
    this.configuration.setVariables(props);
    this.parsed = false;
    this.environment = environment;
    this.parser = parser;
  }

  public Configuration parse() {
    if (parsed) {
      throw new BuilderException("Each XMLConfigBuilder can only be used once.");
    }
    parsed = true;
    parseConfiguration(parser.evalNode("/configuration"));
    return configuration;
  }

可以看到在XMLConfigBuilder的构造方法中new了一个Configuration对象,在parse()方法中通过parseConfiguration()方法解析xml文件,并赋值到configuration。其中parser.evalNode("/configuration")的作用是把/configuration节点封装成XNode对象,作为parseConfiguration()方法的参数

parseConfiguration()方法源代码如下:

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

可以看到这个方法是解析各个节点,并赋值到configuration对象。

下一节详细讲解各个节点的解析赋值。

原文 

https://segmentfault.com/a/1190000023278145

本站部分文章源于互联网,本着传播知识、有益学习和研究的目的进行的转载,为网友免费提供。如有著作权人或出版方提出异议,本站将立即删除。如果您对文章转载有任何疑问请告之我们,以便我们及时纠正。

PS:推荐一个微信公众号: askHarries 或者qq群:474807195,里面会分享一些资深架构师录制的视频录像:有Spring,MyBatis,Netty源码分析,高并发、高性能、分布式、微服务架构的原理,JVM性能优化这些成为架构师必备的知识体系。还能领取免费的学习资源,目前受益良多

转载请注明原文出处:Harries Blog™ » Mybatis源码分析(四):构建sqlSessionFactory

赞 (0)
分享到:更多 ()

评论 0

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址