MyBatis-Plus 中 Mapper 重载踩坑指南
共 2648字,需浏览 6分钟
·
2021-08-23 02:29
前言
近期在 Mapper 中写了个方法重载,然后死活查不到正确结果,最终灵机一动,想到是不是因为重载,然后我 Shift + F6
把重载方法名字改了一下!结果,显而易见,重载的那个方法也一块改了。再次躺坑!
1
背景
以下为模式测试数据
MySQL 表
Mapper
如果看到这里,已经发现了问题,并知道原因,那可以直接跳过,进行三连即可。
当然,在 Mapper.xml 这么写,会提示错误(插件功能)
Junit
执行结果是:
sum=1500 sumWithTime=1500
这就神奇了,没有报错,结果竟然是相同的
。
版本依赖
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.1.2</version>
</dependency>
mybatis-plus-boot-starter 3.1.2 对应的是 mybatis:3.5.1 和 mybatis-spring:2.0.1
3
深入排查
MyBatis-Plus
两个结果相同,那就断点断到第二个上面,debug 进去,看看执行过程。
F7 进入!这里直接进到 com.baomidou.mybatisplus.core.override.MybatisMapperProxy#invoke
这里都是 mybatis-plus 的代理。
进入跟进,进入到 com.baomidou.mybatisplus.core.override.MybatisMapperMethod#execute
这里相当于执行
Object result = sqlSession.selectOne("com.liuzhihang.demo.mapper.TransOrderMapper.sumOrderAmount", param);
后面就是进入 Mybatis 的环节了。
在这里会进入 Mybatis 的 slectList 方法(org.apache.ibatis.session.defaults.DefaultSqlSession#selectList
)。
从 configuration
中生成所有的 mappedStatements,然后从 statements 中获取根据 id,也就是方法的全路径,获取当前的 statements。
先看看 mappedStatements 里面都有啥?
mappedStatements 是一个 Map 结构! 其中 key 是方法名,value 是一个 MappedStatement
所以这里的意思是根据方法的全路径名称,获取一个 MappedStatement, 而 com.liuzhihang.demo.mapper.TransOrderMapper.sumOrderAmount
在这里面只有一个。
所以最终执行的 sql 是 select ifnull(sum(order_amount),0) from trans_order where user_id = ? ;
。这也是为什么两个方法执行的结果是相同的了。
究其原因,则是因为 configuration 中就没有重载方法的 MappedStatement
而根本原因则是在 com.baomidou.mybatisplus.core.MybatisConfiguration#addMappedStatement
中写了一段代码!
如果已经存在,则直接忽略,同时会打印日志。
mapper[xxx] is ignored, because it exists, maybe from xml file
MyBatis
那如果使用原生 MyBatis 呢?
其实会在启动阶段就报错,服务直接启动失败。
其中异常是:
java.lang.IllegalArgumentException: Mapped Statements collection already contains value xxx
进入源码,org.apache.ibatis.session.Configuration#addMappedStatement
在这里会创建 mappedStatements,调用的是 Map 的 put 方法。
Configuration.StrictMap#put 继承了 HashMap 具体内容不细看。
其中 key 的结构是方法的方法全路径
。比如 com.liuzhihang.demo.mapper.TransOrderMapper.sumOrderAmount
而第二次重载方法,来的时候就会抛出异常。
3
总结
在 MyBatis-Plus 中 Mapper 重载并不会出现异常,但是查询结果都是相同的。因为 MyBatis-Plus 的 MybatisConfiguration 继承重写了 MyBatis Configuration 的 addMappedStatement 方法。 在 MyBatis-Plus 中发现该 MappedStatement 已经存在,则不进行添加。 而在 MyBatis 中如果 MappedStatement 如果 key 存在,则直接抛出异常,服务启动失败。
以上就是我经历的一个小坑,也是因为个人图省事,写了个重载。虽然记得不能重载,但是看启动没问题,就觉得 ok。
- <End /> -
历史文章 | 相关推荐