mybatis源码解析3---XMLConfigBuilder解析

1.XMLConfigBuilder

XMLConfigBuilder类位于Mybatis包的org.apache.ibatis.builder.xml目录下，继承于BaseBuilder类，关于BaseBuilder类后续再看。

XMLConfigBuilder看名字能猜到是关于mybatis的XML配置的构造类，负责构造mybatis的XML配置的。

XMLConfigBuilder共有四个属性，代码如下：

 private boolean parsed;//解析标识,因为Configuration是全局变量，只需要解析创建一次即可，true表示已经解析创建过,false则表示没有
 private XPathParser parser;
 private String environment;//环境参数
 private ReflectorFactory localReflectorFactory = new DefaultReflectorFactory();

XMLConfigBuilder共有6个public构造方法和一个private的构造方法，如下：

  public XMLConfigBuilder(Reader reader) {
     this(reader, null, null);
   }

   public XMLConfigBuilder(Reader reader, String environment) {
     this(reader, environment, null);
   }

   public XMLConfigBuilder(Reader reader, String environment, Properties props) {
     this(new XPathParser(reader, true, props, new XMLMapperEntityResolver()), environment, props);
   }

   public XMLConfigBuilder(InputStream inputStream) {
     this(inputStream, null, null);
   }

   public XMLConfigBuilder(InputStream inputStream, String environment) {
     this(inputStream, environment, null);
   }

   public XMLConfigBuilder(InputStream inputStream, String environment, Properties props) {
     this(new XPathParser(inputStream, true, props, new XMLMapperEntityResolver()), environment, props);
   }

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

很显然6个public的构造方法都是根据mybatis的配置文件流创建一个XPathParser对象，然后最终都调用了私有的构造方法，而私有的构造方法先是调用了父类BaseBuilder的构造方法，然后分别根据参数给四个属性赋值。

而上一篇文章提到了SqlSessionFactoryBuilder中是通过创建一个XMLConfigBuilder对象，然后调用了对象的parse()方法获取到一个Configuration对象。接下来就先看看XMLConfigBuilder的parse方法，如下：、

 public Configuration parse() {
     if (parsed) {//判断Configuration是否解析过，Configuration是全局变量，只需要解析创建一次即可
       throw new BuilderException("Each XMLConfigBuilder can only be used once.");
     }
     parsed = true;
     parseConfiguration(parser.evalNode("/configuration"));//调用下面的方法,parser.evalNode("/configuration")解析XML配置的configuration节点的内容，得到XNode对象
     return configuration;
   }
   //根据root中存储的是configuration节点的内容
   private void parseConfiguration(XNode root) {
     try {
       Properties settings = settingsAsPropertiess(root.evalNode("settings"));//设置settings配置
       //issue #117 read properties first
       propertiesElement(root.evalNode("properties"));//设置properties配置
       loadCustomVfs(settings);
       typeAliasesElement(root.evalNode("typeAliases"));//设置typeAliases配置
       pluginElement(root.evalNode("plugins"));//设置plugins配置
       objectFactoryElement(root.evalNode("objectFactory"));//设置objectFactory配置
       objectWrapperFactoryElement(root.evalNode("objectWrapperFactory"));//设置objectWrapperFactory配置
       reflectorFactoryElement(root.evalNode("reflectorFactory"));//设置reflectFactory配置
       settingsElement(settings);
       // read it after objectFactory and objectWrapperFactory issue #631
       environmentsElement(root.evalNode("environments"));//设置environments配置
       databaseIdProviderElement(root.evalNode("databaseIdProvider"));//设置databaseIdProvider配置
       typeHandlerElement(root.evalNode("typeHandlers"));//设置typeHandlers配置
       mapperElement(root.evalNode("mappers"));//设置mappers配置
     } catch (Exception e) {
       throw new BuilderException("Error parsing SQL Mapper Configuration. Cause: " + e, e);
     }
   }

可以看出parse的作用是解析mybatis-config.xml的configuration节点的内容，然后挨个赋值给configuration对象的属性；

而XMLConfigBuilder的其他私有方法都是给根据XNode对象（XML配置的configuration节点内容）来给全局配置变量configuration的属性进行赋值，关于Configuration类的解析下一章会解析

总结:XMLConfigBuilder类的作用是根据全局配置文件mybatis-config.xml的流文件进行解析,解析xml中的各个节点，然后创建一个Configuration对象，并将xml中的节点属性赋值给Configuration对象