解析xml url_后端技术：Mybatis是如何解析配置文件的？

水深无声 2023-01-07 10:07 111阅读 0赞

关注“Java后端技术全栈”

回复“面试”获取全套面试资料

在以前文章中，我们把Mybatis源码阅读的整个流程梳理了一遍。今天，我们来详细聊聊，Mybatis是如何解析配置文件的。

这是今天分析的流程图：

![2de7a5061bcb9e5509d91db1ea47b3c4.png][]

还是从案例开始。

### demo案例 ###

public static void main(String[] args) {
         
            String resource = "mybatis-config.xml";
            InputStream inputStream = null;
            SqlSession sqlSession = null;
            try {
         
                inputStream = Resources.getResourceAsStream(resource);
                SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
                sqlSession = sqlSessionFactory.openSession();
    
                UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
                System.out.println(userMapper.selectById(1));
    
            } catch (Exception e) {
         
                e.printStackTrace();
            } finally {
         
                try {
         
                    inputStream.close();
                } catch (IOException e) {
         
                    e.printStackTrace();
                }
                sqlSession.close();
            }
        }

### 见证奇迹 ###

从`SqlSessionFactoryBuilder`开始。

#### SqlSessionFactoryBuilder类 ####

org.apache.ibatis.session.SqlSessionFactoryBuilder

该类里全是build方法各种重载。

![e919c26b089f964c4e00ccb454ea106c.png][]

//这个方法啥也没干  
    public SqlSessionFactory build(InputStream inputStream) {
         
        return build(inputStream, null, null);
     }

最终来到另外一个build方法里：

public SqlSessionFactory build(InputStream inputStream, String environment, Properties properties) {
         
        try {
         
          //创建一个XMLConfigBuilder对象  
          XMLConfigBuilder parser = new XMLConfigBuilder(inputStream, environment, properties);
          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.
          }
        }
      }

#### XMLConfigBuilder类 ####

该类的构造方法重载：

![b4f2de50f6c599e14ff846f76e151cfc.png][]

首先进入：

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

build(parser.parse());中的parser.parse()；

#### mybatis-config.xml在哪里解析的呢？ ####

请看下面这个方法：

//该方法返回一个Configuration对象
    public Configuration parse() {
         
      if (parsed) {
         
        throw new BuilderException("Each XMLConfigBuilder can only be used once.");
      }
      parsed = true;
      //关键点
      parseConfiguration(parser.evalNode("/configuration"));
      return configuration;
    }

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

终于看到开始解析配置文件了:

![d0b31fed0db2c27012c876d4f914ba7a.png][]

进入方法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);
        }
      }

这里就是把mybatis-config.xml内容解析，然后设置到Configuration对象中。

#### 那么我们定义的Mapper.xml是在哪里解析的呢？ ####

我们的Mapper.xml在mybatis-config.xml中的配置是这样的：

![6c52a44dae8082fa85d65203456f08c0.png][]

``使用方式有以下四种：

//1使用类路径
    <mappers>
        <mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
          <mapper resource="org/mybatis/builder/BlogMapper.xml"/>
       <mapper resource="org/mybatis/builder/PostMapper.xml"/>
    mappers>
    //2使用绝对url路径
    <mappers>
       <mapper url="file:///var/mappers/AuthorMapper.xml"/>
       <mapper url="file:///var/mappers/BlogMapper.xml"/>
       <mapper url="file:///var/mappers/PostMapper.xml"/>
    mappers>
    //3使用java类名
    <mappers>
       <mapper class="org.mybatis.builder.AuthorMapper"/>
       <mapper class="org.mybatis.builder.BlogMapper"/>
       <mapper class="org.mybatis.builder.PostMapper"/>
    mappers>
    
    //4自动扫描包下所有映射器
    <mappers>
       <package name="org.mybatis.builder"/>
    mappers>

继续源码分析，我们在上面mybatis-config.xml解析中可以看到：

![3fa6d141ffc7b8e58a77270be25be657.png][]

我们不妨进入这个方法看看：

private void mapperElement(XNode parent) throws Exception {
         
        if (parent != null) {
         
          for (XNode child : parent.getChildren()) {
         
            //自动扫描包下所有映射器
            if ("package".equals(child.getName())) {
         
              String mapperPackage = child.getStringAttribute("name");
              //放  
              configuration.addMappers(mapperPackage);
            } else {
         
              String resource = child.getStringAttribute("resource");
              String url = child.getStringAttribute("url");
              String mapperClass = child.getStringAttribute("class");
              //使用java类名
              if (resource != null && url == null && mapperClass == null) {
         
                ErrorContext.instance().resource(resource);
                 //根据文件存放目录，读取XxxMapper.xml
                InputStream inputStream = Resources.getResourceAsStream(resource);
                 //映射器比较复杂，调用XMLMapperBuilder
                //注意在for循环里每个mapper都重新new一个XMLMapperBuilder，来解析
                XMLMapperBuilder mapperParser = new XMLMapperBuilder(inputStream, configuration, resource, configuration.getSqlFragments());
                mapperParser.parse();
              //使用绝对url路径
              } else if (resource == null && url != null && mapperClass == null) {
         
                ErrorContext.instance().resource(url);
                InputStream inputStream = Resources.getUrlAsStream(url);
                //映射器比较复杂，调用XMLMapperBuilder
                XMLMapperBuilder mapperParser = new XMLMapperBuilder(inputStream, configuration, url, configuration.getSqlFragments());
                mapperParser.parse();
              //使用类路径    
              } else if (resource == null && url == null && mapperClass != null) {
         
                Class> mapperInterface = Resources.classForName(mapperClass);
                //直接把这个映射加入配置
                configuration.addMapper(mapperInterface);
              } else {
         
                throw new BuilderException("A mapper element may only specify a url, resource or class, but not more than one.");
              }
            }
          }
        }
      }

这里刚刚和我们的上面说的``使用的方式完全是一模一样的。

到这里，配置文件mybatis-config.xml和我们定义映射文件XxxMapper.xml就全部解析完成。

#### 回到SqlSessionFactoryBuilder类 ####

前面讲到了XMLConfigBuilder中的parse方法，并返回了一个Configuration对象。

`build(parser.parse());`

这个build方法就是传入一个Configuration对象，然后构建一个DefaultSqlSession对象。

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

继续回到我们的demo代码中这一行代码里：

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

这一行代码就相当于：

SqlSessionFactory sqlSessionFactory = new new DefaultSqlSessionFactory();

到这里，我们的整个流程就搞定了。

IT技术分享社区

个人博客网站：https://programmerblog.xyz

![7eba17ec9c9dcd01ef399e55ff006f7a.png][]

文章推荐 程序员效率：画流程图常用的工具 程序员效率：整理常用的在线笔记软件 远程办公：常用的远程协助软件，你都知道吗？ 51单片机程序下载、ISP及串口基础知识 硬件：断路器、接触器、继电器基础知识

[2de7a5061bcb9e5509d91db1ea47b3c4.png]: /images/20221119/69f1df1626eb44db8dda3a1689250224.png
[e919c26b089f964c4e00ccb454ea106c.png]: /images/20221119/1af3ac8335eb420ab428d8c365f7dcab.png
[b4f2de50f6c599e14ff846f76e151cfc.png]: /images/20221119/0b56edf04e384d039e622b4d302faef5.png
[d0b31fed0db2c27012c876d4f914ba7a.png]: /images/20221119/afaf08684c7c4bc68fe2d54a418c2bd7.png
[6c52a44dae8082fa85d65203456f08c0.png]: https://img-blog.csdnimg.cn/img_convert/6c52a44dae8082fa85d65203456f08c0.png
[3fa6d141ffc7b8e58a77270be25be657.png]: https://img-blog.csdnimg.cn/img_convert/3fa6d141ffc7b8e58a77270be25be657.png
[7eba17ec9c9dcd01ef399e55ff006f7a.png]: https://img-blog.csdnimg.cn/img_convert/7eba17ec9c9dcd01ef399e55ff006f7a.png