快捷導(dǎo)航

Java?Mybatis的初始化之Mapper.xml映射文件的詳解

更新時間：2022年08月18日 11:34:08 作者：周杰倫本人???????

這篇文章主要介紹了Java?Mybatis的初始化之Mapper.xml映射文件的詳解，解析完全局配置文件后接下來就是解析Mapper文件了，它是通過XMLMapperBuilder來進行解析的

解析Mapper文件入口

XMLMapperBuilder的parse()方法：

public void parse() {
    if (!configuration.isResourceLoaded(resource)) {
      configurationElement(parser.evalNode("/mapper"));
      configuration.addLoadedResource(resource);
      bindMapperForNamespace();
    }

    parsePendingResultMaps();
    parsePendingCacheRefs();
    parsePendingStatements();
  }

當前Mapper文件沒有加載過就調(diào)用configurationElement()方法解析Mapper文件
添加到Configuration.loadedResources集合中，防止重復(fù)加載
獲取Mapper文件對應(yīng)的Mapper接口并注冊
處理解析失敗的<resultMap>標簽
處理解析失敗的<cache-ref>標簽
處理解析失敗的SQL語句

重點看一下XMLMapperBuilder類的configurationElement()方法

解析Mapper文件

MLMapperBuilder類的configurationElement()方法：

private void configurationElement(XNode context) {
    try {
      String namespace = context.getStringAttribute("namespace");
      if (namespace == null || namespace.isEmpty()) {
        throw new BuilderException("Mapper's namespace cannot be empty");
      }
      builderAssistant.setCurrentNamespace(namespace);
      cacheRefElement(context.evalNode("cache-ref"));
      cacheElement(context.evalNode("cache"));
      parameterMapElement(context.evalNodes("/mapper/parameterMap"));
      resultMapElements(context.evalNodes("/mapper/resultMap"));
      sqlElement(context.evalNodes("/mapper/sql"));
      buildStatementFromContext(context.evalNodes("select|insert|update|delete"));
    } catch (Exception e) {
      throw new BuilderException("Error parsing Mapper XML. The XML location is '" + resource + "'. Cause: " + e, e);
    }
  }

解析Mapper文件的namespace屬性
解析<cache-ref>標簽，這個標簽是用來引用別的Cache緩存
解析<cache>標簽，這個標簽是用來啟用Mybatis的二級緩存的，一級緩存是默認開啟的，在這個方法里解析到MapperBuilderAssistant類完成Cache的創(chuàng)建，保存在Configuration.caches的集合中，集合的key是namespace，值是Cache對象
解析<parameterMap>標簽，這個標簽已經(jīng)廢棄了，一般使用parameterType 來定義參數(shù)的類名
解析<resultMap>標簽，這個標簽是結(jié)果映射，它標簽下的所有子標簽解析后保存在ResultMap對象中，具體會解析先獲取resultMap中的type，type是結(jié)果集映射成的java對象，然后解析resultMap標簽的子標簽，包括<constructor>、<id>、<result>、<collection>等標簽，這些標簽生成ResultMapping對象，然后獲取id extends等屬性，構(gòu)建ResultMapResolver對象，創(chuàng)建ResultMap對象保存到Configuration.resultMaps集合中
解析sql標簽，這個標簽是用來定義重復(fù)的sql片段的，解析出保存在Configuration.sqlFragments中
解析<select>、<insert>、<update>、<delete>等SQL節(jié)點，這些標簽大家肯定就熟悉了，就是我們的增刪改查的sql語句，通過XMLStatementBuilder來進行解析，它會先解析<include>標簽，然后解析<selectKey>標簽，保存到Configuration.keyGenerators集合中，最后通過LanguageDriver.createSqlSource()方法創(chuàng)建SqlSource對象，構(gòu)建MappedStatement對象，MappedStatement的sqlSource記錄sql語句，sqlCommandType記錄SQL語句的類型，保存在Configuration.mappedStatements集合中