Mybaits源码分析六之XMLConfigBuilder类 environments标签解析

根据mybatis配置加载流程 

private void parseConfiguration(XNode root) {
    try {
      //解析子节点的properties文件
      propertiesElement(root.evalNode("properties"));
      //加载用户自定义配置
      Properties settings = settingsAsProperties(root.evalNode("settings"));
      //加载vfs虚拟文件系统配置
      loadCustomVfs(settings);
     // 解析子节点typeAliases 别名
      typeAliasesElement(root.evalNode("typeAliases"));
      //解析子节点plugins 插件
      pluginElement(root.evalNode("plugins"));
      //解析子节点objectFactory mybatis为结果创建对象时都会用到objectFactory
      objectFactoryElement(root.evalNode("objectFactory"));
      //解析子节点的封装对象
      objectWrapperFactoryElement(root.evalNode("objectWrapperFactory"));
      reflectorFactoryElement(root.evalNode("reflectorFactory"));
      //解析settings标签的文件配置
      settingsElement(settings);
      //配置运行环境
      environmentsElement(root.evalNode("environments"));
      //解析子节点配置数据库供应商
      databaseIdProviderElement(root.evalNode("databaseIdProvider"));
      //解析对象类型处理器，处理Java的pojo类型与数据库类型的映射
      typeHandlerElement(root.evalNode("typeHandlers"));
      //解析子节点的mappers
      mapperElement(root.evalNode("mappers"));
    } catch (Exception e) {
      throw new BuilderException("Error parsing SQL Mapper Configuration. Cause: " + e, e);
    }
  }

environmentsElement(root.evalNode("environments"));主要处理连接数据库配置，在mybatis配置文件中的写法为：

<!--默认为development 环境，通过此配置会寻找 id="development"配置-->
<environments default="development">
       <!--当前运行环境-->
        <environment id="development">
          <!--指定任务管理器-->
            <transactionManager type="JDBC"/>
          <!--指定数据源-->
            <dataSource type="POOLED">
                <property name="driver" value="${jdbc.driver}"/>
                <property name="url" value="${jdbc.url}"/>
                <property name="username" value="${jdbc.username}"/>
                <property name="password" value="${jdbc.password}"/>
            </dataSource>
        </environment>
    </environments>

任务管理器 <transactionManager type="JDBC"/>中type属性有两个值分别是 JDBC，MANAGED。type也可以自定义实现事务管理

JDBC是指 JdbcTransactionFactory 生成的 JdbcTransaction 对象实现。它是以 JDBC 的方式对数据库的提交和回滚进行操作
MANAGED 使用 ManagedTransactionFactory 生成的 ManagedTransaction 对象实现。它的提交和回滚方法不用任何操作，而是把事务交给容器处理。在默认情况下，它会关闭连接，然而一些容器并不希望这样，因此需要将 closeConnection 属性设置为 false 来阻止它默认的关闭行为。

数据源配置形式 <dataSource type="POOLED"> 中type的属性值分别为JNDI，POOLED，UNPOOLED
UNPOOLED 采用非数据库池的管理方式，每次请求都会打开一个新的数据库连接，所以创建会比较慢。基于UnpooledDataSourceFactory实现
POOLED数据源 POOLED 利用“池”的概念将 JDBC 的 Connection 对象组织起来，它开始会有一些空置，并且已经连接好的数据库连接，所以请求时，无须再建立和验证，省去了创建新的连接实例时所必需的初始化和认证时间。它还控制最大连接数，避免过多的连接导致系统瓶颈。是基于PooledDataSourceFactory实现
JNDI数据源 JNDI 的实现是为了能在如 EJB 或应用服务器这类容器中使用，容器可以集中或在外部配置数据源，然后放置一个 JNDI 上下文的引用。是基于JndiDataSourceFactory实现

environmentsElement方法为：

  private void environmentsElement(XNode context) throws Exception {
    if (context != null) {
      if (environment == null) {
        environment = context.getStringAttribute("default");
      }
      for (XNode child : context.getChildren()) {
      //获取environment配置ID值
        String id = child.getStringAttribute("id");
    //判断指定的环境ID与各子节点的环境ID是否一致
        if (isSpecifiedEnvironment(id)) {
      //加载事务管理器
          TransactionFactory txFactory = transactionManagerElement(child.evalNode("transactionManager"));
      //加载数据源
          DataSourceFactory dsFactory = dataSourceElement(child.evalNode("dataSource"));
          DataSource dataSource = dsFactory.getDataSource();
          Environment.Builder environmentBuilder = new Environment.Builder(id)
              .transactionFactory(txFactory)
              .dataSource(dataSource);
          configuration.setEnvironment(environmentBuilder.build());
        }
      }
    }
  }

isSpecifiedEnvironment(id)方法为：

 private boolean isSpecifiedEnvironment(String id) {
    if (environment == null) {
      throw new BuilderException("No environment specified.");
    } else if (id == null) {
      throw new BuilderException("Environment requires an id attribute.");
    } else if (environment.equals(id)) {
      return true;
    }
    return false;
  }

transactionManagerElement方法为

private TransactionFactory transactionManagerElement(XNode context) throws Exception {
    if (context != null) {
      String type = context.getStringAttribute("type");
   //获取子节点
      Properties props = context.getChildrenAsProperties();
   //根据type参数获取事务管理器实例
      TransactionFactory factory = (TransactionFactory) resolveClass(type).newInstance();
      factory.setProperties(props);
      return factory;
    }

dataSourceElement数据源加载

private DataSourceFactory dataSourceElement(XNode context) throws Exception {
    if (context != null) {
      String type = context.getStringAttribute("type");
      Properties props = context.getChildrenAsProperties();
      DataSourceFactory factory = (DataSourceFactory) resolveClass(type).newInstance();
      factory.setProperties(props);
      return factory;
    }
    throw new BuilderException("Environment declaration requires a DataSourceFactory.");
  }