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对象

巴特西

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

最新文章

热门文章