zoukankan      html  css  js  c++  java
  • MyBatis 学习记录7 一个Bug引发的思考

     

    主题

      这次学习MyBatis的主题我想记录一个使用起来可能会遇到,但是没有经验的话很不好解决的BUG,在特定情况下很容易发生.

    异常

    java.lang.IllegalArgumentException: Mapped Statements collection already contains value for com.xxx.package.ClassA.fun1

    这个错误非常非常常见,百度一下大部分问题都能解决.这个问题90%出现的原因是一个Mapper文件中有2个节点的id相同就会出现. 只要仔细检查下id就OK了. 

    可能很多问题Mybatis都会报这个错,id重复是其中之一,也是最常见的,这点上来说MyBatis的错误提示不够好.

    现在我来分享一种情况也会出现这个错误,但是不是id重复的情况.

    1.用MyBatis Generator自动生成Mapper和XML,并且

    <javaClientGenerator targetPackage="" targetProject="" type="MIXEDMAPPER"/>

    type="MIXEDMAPPER" 也就是自定生成的文件是混用注解和XML的时候有一定概率产生.

    这种生成下Mapper中的select语句有注解@ResultMap, 同时resultMap是定义在XML中的.

    2.因为一般项目自动生成的XML和自己手写的会分开,所以会有多个XML. 并且自己定义的XML中也有resultMap.

    3.一点点运气,这个和XML加载顺序有关系,在idea没有打成jar包,也就是文件是按文件名排序的时候不会有概率问题(开发debug加载顺序是确定的),但是mapper.XML被打成jar在jar里的时候加载顺序不是按照字母顺序,(发布打成jar发布到生产上的时候看起来是乱序)的时候就有一定概率发生(不是必现错误,需要看当时XML的加载顺序)

    原理

    正如之前文章分享的那样,MyBatis在启动的时候会读取Mapper XML去解析生产MapperedStatement.

    假设我有1个Mapper A, 对应XML1和XML2.  2个XML文件.

    A.fun1方法上有@ResultMap注解,在XML2中定义对应的resultMap.

    启动的时候如果先读取到了XML1这个XML. 这个时候会调用XMLMapperBuilder.parse方法去解析

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

    其中需要调用bindMapperForNamespace. 也就是解析namespace.这步操作会找到namespace对应的Mapper.如果Mapper没有被configuration加载过,就先去加载这个Mapper. 请注意没有被加载过的时候才回去加载这个Mapper.

    如上图, hasMapper方法如果检测到没有加载过就调用configuration.addMapper方法

    内部会调用mapperRegistry的addMapper方法.其中会调用MapperAnnotationBuilder去解析Mapper这个类.相当于解析你写的Mapper接口

    这个是做什么操作呢? 当解析到你的select方法上有@resultMap的时候MyBatis需要找到这个select是对应到了哪个resultMap?

    但是你的自定义的resultMap在XML2文件中,还没有加载.所以这个时候这个select方法会被添加到incompleteMethods中.相当于标记这个方法是没有解析完成的,因为目前信息不够.

    而parsePendingMethods就是会去检查所有的incompleteMethods,如果可以解析了.那就移除.

    也就是说新加载的Mapper结束的时候都会调用parsePendingMethods检查未完成Methods.

    那么这个BUG什么时候回发生呢? 就在于你的XML2这个文件是最后1个加载的Mapper XML.这个时候因为Mapper类在XML1的时候已经加载过了.所以不会进MapperRegistry的addMapper方法,也就不会做parsePendingMethods方法.而这个XML后面没有其他XML了..所以解析至此就结束了.那么XML里对应的Mapper中自定义@resultMap对应的那个select就回一直存在于incompleteMethods..mybatis初始化完成的时候尽管incompleteMethods的size不为0,但是这个时候还不会报错.

    那么是哪里报错的呢?

    是当你调用你的任意一个mapper.XXX方法的时候. 因为这个时候首先要生成MethodProxy. MethodProxy要生成MappedStatement.

    如上图,MappedStatement就相当于是你XML里select等节点的java表示. 首先hasStatement是要检查一下这个Mapper.XXX方法在XML里到底有没有对应的SQL.没有肯定不能做下去.因为找不到SQL.

    找到了就会调getMappedStatement. 这2个方法都会调用1个特殊的方法

     

    如上图所示, 看buildAllstatements的注释也能明白他是干嘛的.就是检查是否有未完成的配置,incompleteXXX中如果有对象,就调用他的resolve方法去做解析.

    这个时候因为所有配置加载完成了.所以之前没有解析的那个ClassA.fun1会被添加到mappedStatements中. 但是! incompleteMethods中的对象并没有清除. 这点我觉得很奇怪...resolve()以后不是应该清除对象吗..

    像初始化的各种parsePending方法中如果resolve了都会清除incompleteXXX中的对象的..但是这里却没有remove...不知道为什么(如下图)

    也就是说调用hasStatement的时候会向confioguration的mappedStatements中添加ClassA.fun1

    而调用getMappedStatement的时候又会添加一次

    而 mappedStatements在configuration中是这么声明的:

    protected final Map<String, MappedStatement> mappedStatements = new StrictMap<MappedStatement>

     

    如上图, 在重复添加key的时候就会报错了.

    怎么解决?

    第一.最简单的.把那个@ResultMap的select方法的SQL写道XML里而不是@Select写在类上.也就是说select语句和resultMap是一起加载的.

    或者

    第二.不要使用自定义resultMap..很多情况下可以被@ResultType代替. 

  • 相关阅读:
    向量杂谈
    对widget使用WM_SetCallback
    群延迟与广义线性相位
    采样的频域表示
    Oracle 表的连接方式(2)-----HASH JOIN的基本机制1
    Oracle 表的连接方式(1)-----Nested loop join和 Sort merge join
    Oracle 表的访问方式(2)-----索引扫描
    Oracle 表的访问方式(1) ---全表扫描、通过ROWID访问表
    11g RAC R2 之Linux DNS 配置
    11g RAC r2 的启停命令概述1
  • 原文地址:https://www.cnblogs.com/abcwt112/p/9954384.html
Copyright © 2011-2022 走看看