Mybatis的Mapper中的方法为什么不能重载?
目录
前言 环境配置 错误示范 为什么不能重载? 如何找到XML中对应的SQL? 总结
前言
在初入门 Mybatis
的时候可能都犯过一个错误,那就是在写Mapper
接口的时候都重载过其中的方法,但是运行起来总是报错,那时候真的挺郁闷的,但是自己也查不出来原因,只能默默的改了方法名,哈哈,多么卑微的操作。今天就写一篇文章从源码角度为大家解惑为什么 Mybatis
中的方法不能重载?
环境配置
本篇文章讲的一切内容都是基于 Mybatis3.5
和SpringBoot-2.3.3.RELEASE
。
错误示范
举个栗子:假设现在有两个需求,一个是根据用户的id筛选用户,一个是根据用户的性别筛选,此时在Mapper中重载的方法如下:
public interface UserMapper {
List<UserInfo> selectList(@Param("userIds") List<String> userIds);
List<UserInfo> selectList(Integer gender);
}
这个并没有什么错误,但是启动项目,报出如下的错误:
Caused by: org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'sqlSessionFactory' defined in class path resource [org/mybatis/spring/boot/autoconfigure/MybatisAutoConfiguration.class]: Bean instantiation via factory method failed; nested exception is org.springframework.beans.BeanInstantiationException: Failed to instantiate [org.apache.ibatis.session.SqlSessionFactory]: Factory method 'sqlSessionFactory' threw exception; nested exception is org.springframework.core.NestedIOException: Failed to parse mapping resource: 'file [H:\work_project\demo\target\classes\mapper\UserInfoMapper.xml]'; nested exception is org.apache.ibatis.builder.BuilderException: Error parsing Mapper XML. The XML location is 'file [H:\work_project\demo\target\classes\mapper\UserInfoMapper.xml]'. Cause: java.lang.IllegalArgumentException: Mapped Statements collection already contains value for cn.cb.demo.dao.UserMapper.selectList. please check file [H:\work_project\demo\target\classes\mapper\UserInfoMapper.xml] and file [H:\work_project\demo\target\classes\mapper\UserInfoMapper.xml]
at org.springframework.beans.factory.support.ConstructorResolver.instantiate(ConstructorResolver.java:655)
at org.springframework.beans.factory.support.ConstructorResolver.instantiateUsingFactoryMethod(ConstructorResolver.java:635)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.instantiateUsingFactoryMethod(AbstractAutowireCapableBeanFactory.java:1336)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBeanInstance(AbstractAutowireCapableBeanFactory.java:1176)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.doCreateBean(AbstractAutowireCapableBeanFactory.java:556)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBean(AbstractAutowireCapableBeanFactory.java:516)
at org.springframework.beans.factory.support.AbstractBeanFactory.lambda$doGetBean$0(AbstractBeanFactory.java:324)
at org.springframework.beans.factory.support.DefaultSingletonBeanRegistry.getSingleton(DefaultSingletonBeanRegistry.java:226)
at org.springframework.beans.factory.support.AbstractBeanFactory.doGetBean(AbstractBeanFactory.java:322)
at org.springframework.beans.factory.support.AbstractBeanFactory.getBean(AbstractBeanFactory.java:202)
at org.springframework.beans.factory.config.DependencyDescriptor.resolveCandidate(DependencyDescriptor.java:276)
at org.springframework.beans.factory.support.DefaultListableBeanFactory.doResolveDependency(DefaultListableBeanFactory.java:1307)
at org.springframework.beans.factory.support.DefaultListableBeanFactory.resolveDependency(DefaultListableBeanFactory.java:1227)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.autowireByType(AbstractAutowireCapableBeanFactory.java:1509)
... 81 more
这么一大串什么意思?懵逼了~
大致的意思:
cn.cb.demo.dao.UserMapper.selectList
这个id
已经存在了,导致创建sqlSessionFactory
失败。
为什么不能重载?
通过上面的异常提示可以知道创建 sqlSessionFactory
失败了,这个想必已经不陌生吧,顾名思义,就是创建SqlSession
的工厂。Springboot与Mybatis会有一个启动器的自动配置类 MybatisAutoConfiguration
,其中有一段代码就是创建sqlSessionFactory
,如下图:
既然是创建失败,那么肯定是这里出现异常了,这里的「大致思路」就是:
❝
解析
XML
文件和Mapper
接口,将Mapper中的方法与XML文件中<select>
、<insert>
等标签一一对应,那么Mapper中的方法如何与XML中<select>
这些标签对应了,当然是唯一的id
对应了,具体如何这个id
的值是什么,如何对应?下面一一讲解。❞
如上图的 SqlSessionFactory
的创建过程中,前面的部分代码都是设置一些配置,并没有涉及到解析XML的内容,因此答案肯定是在最后一行return factory.getObject();
,于是此处打上断点,一点点看。于是一直到了org.mybatis.spring.SqlSessionFactoryBean#buildSqlSessionFactory
这个方法中,其中一段代码如下:
这里的 xmlMapperBuilder.parse();
就是解析XML文件与Mapper接口,继续向下看。略过不重要的代码,在 org.apache.ibatis.builder.xml.XMLMapperBuilder#configurationElement
这个方法中有一行重要的代码,如下图:
此处就是根据XML文件中的 select|insert|update|delete
这些标签开始构建MappedStatement
了。继续跟进去看。略过不重要的代码,此时看到 org.apache.ibatis.builder.MapperBuilderAssistant#addMappedStatement
这个方法返回值就是MappedStatement
,不用多说,肯定是这个方法了,仔细一看,很清楚的看到了构建id
的代码,如下图:
从上图可以知道,创建 id
的代码就是id = applyCurrentNamespace(id, false);
,具体实现如下图:
❝
上图的代码已经很清楚了,
MappedStatement
中的id=Mapper的全类名+'.'+方法名
。如果重载话,肯定会存在id
相同的MappedStatement
。❞
到了这其实并不能说明方法不能重载啊,重复就重复呗,并没有冲突啊。这里需要看一个结构,如下:
protected final Map<String, MappedStatement> mappedStatements = new StrictMap<MappedStatement>("Mapped Statements collection")
.conflictMessageProducer((savedValue, targetValue) ->
". please check " + savedValue.getResource() + " and " + targetValue.getResource());
构建好的 MappedStatement
都会存入mappedStatements
中,如下代码:
public void addMappedStatement(MappedStatement ms) {
//key 是id
mappedStatements.put(ms.getId(), ms);
}
StrictMap
的put(k,v)
方法如下图:
❝
到了这里应该理解了吧,这下抛出的异常和上面的
异常信息
对应起来了吧。这个StrictMap
不允许有重复的key
,而存入的key
就是id
。因此Mapper中的方法不能重载。❞
如何找到XML中对应的SQL?
在使用Mybatis的时候只是简单的调用Mapper中的方法就可以执行SQL,如下代码:
List<UserInfo> userInfos = userMapper.selectList(Arrays.asList("192","198"));
❝
一行简单的调用到底如何找到对应的SQL呢?其实就是根据
id
从Map<String, MappedStatement> mappedStatements
中查找对应的MappedStatement
。❞
在 org.apache.ibatis.session.defaults.DefaultSqlSession#selectList
方法有这一行代码如下图:
MappedStatement ms = configuration.getMappedStatement(statement);
这行代码就是根据id
从mappedStatements
获取对应的MappedStatement
,源码如下:
public MappedStatement getMappedStatement(String id) {
return this.getMappedStatement(id, true);
}
总结
文章写到这,想必已经很清楚Mapper中的方法为什么不能重载了,归根到底就是因为这个这个 id=Mapper的全类名+'.'+方法名
。如果觉得作者写的不错,有所收获的话,点点关注,分享一波,关注微信公众号 码猿技术专栏
第一手文章推送!!!
Mybatis的Mapper中的方法为什么不能重载?的更多相关文章
- Mybatis接口Mapper内的方法为啥不能重载吗?
动态代理的功能:通过拦截器方法回调,对目标target方法进行增强. 言外之意就是为了增强目标target方法.上面这句话没错,但也不要认为它就是真理,殊不知,动态代理还有投鞭断流的霸权,连目标tar ...
- Mybatis的mapper代理开发方法
一.开发规范 1.映射文件中的namespase等于mapper接口类路径 2.statement的id与mapper中的方法名一致 3.让mapper的接口方法输入参数类型与statement中的p ...
- mybatis的mapper中,实体非空检验问题
因为项目变动,数据库需要删除一个字段,于是勤劳的我把项目中对应的实体属性也给弄掉了,可是没有弄彻底,mybatis里面的mapper没有管,当时感觉是选择性的插入: <if test=" ...
- mybatis的Mapper代理原理
前言:在mybatis的使用中,我们会习惯采用XXMapper.java+XXMapper.xml(两个文件的名字必须保持一致)的模式来开发dao层,那么问题来了,在XXMapper的文件里只有接口, ...
- 四. Java继承和多态3. 继承中的方法的覆盖和重载
在类继承中,子类可以修改从父类继承来的方法,也就是说子类能创建一个与父类方法有不同功能的方法,但具有相同的名称.返回值类型.参数列表. 如果在新类中定义一个方法,其名称.返回值类型和参数列表正好与父类 ...
- 关于Mybatis的@Param注解 及 mybatis Mapper中各种传递参数的方法
原文:https://blog.csdn.net/mrqiang9001/article/details/79520436 关于Mybatis的@Param注解 Mybatis 作为一个轻量级的数 ...
- 【mybatis】idea中 mybatis的mapper类去找对应的mapper.xml中的方法,使用插件mybatis-plugin
idea中 mybatis的mapper类去找对应的mapper.xml中的方法,使用插件mybatis-plugin,名字可能叫Free mybatis-plugin 安装上之后,可能需要重启ide ...
- Mybatis Generator自动生成的mapper只有insert方法
– Mybatis Generator 生成的mapper只有insert方法 – 首先检查generatorConfig.xml中table项中的属性 enableSelectByPrimaryKe ...
- Mybatis的mapper代理开发dao方法
看完了之前的mybatis原始的dao开发方法是不是觉得有点笨重,甚至说没有发挥mybatis 作为一个框架的优势.总结了一下,原始的dao方法有以下几点不足之处 dao接口实现方法中存在大量的模板方 ...
随机推荐
- Mybatis-06-Lombok
偷懒神器Lombok 1. 什么是Lombok? java library plugs build tools 2.使用步骤: 在IDEA中安装Lombok插件 在项目中导入lombok的jar包 ...
- mysql无法远程连接问题(ERROR 1045 (28000): Access denied for user 'root')
mysql版本 : 8.0.21 使用mysql 作为nextcloud的数据库.之前使用挺正常的,因为被黑客勒索过一次,重新启动了一个mysql的docker镜像. 结果数据库配置老是失败,next ...
- CSS动画实例:Loading加载动画效果(三)
3.小圆型Loading 这类Loading动画的基本思想是:在呈现容器中定义1个或多个子层,再对每个子层进行样式定义,使得其均显示为一个实心圆形,最后编写关键帧动画控制,使得各个实心圆或者大小发生改 ...
- .Net MVC5(.Net Framework 4.0+)多语言解决方案
最近项目需要做多语言,原先是2种语言(中文/英文),现在又要加一种语言,成了3种.那么原来的方式肯定不适用了,只能升级解决方案. 原来的写法,使用三目表达式,按照当前全局变量的语言类型,返回不同的语言 ...
- importTSV工具导入数据到hbase
1.建立目标表test,确定好列族信息. create'test','info','address' 2.建立文件编写要导入的数据并上传到hdfs上 touch a.csv vi a.csv 数据内容 ...
- 使用CrashHandler获取应用crash信息
Android应用不可避免会发生crash,也称之为崩溃.发生原因可能是由于Android系统底层的bug,也可能是由于不充分的机型适配或者是糟糕的网络情况.当crash发生时,系统会kill掉正 ...
- 海豚星空扫码投屏 Android 接收端 SDK 集成 六步骤
一 跟目录的build.gradle添加私有mevan仓库 maven {url 'http://nexus.dolphinstar.cn/repo/openmavenx'} 二 app/build. ...
- 二叉搜索树及java实现
二叉搜索树(Binary Search Tree) 二叉搜索树是二叉树的一种,是应用非常广泛的一种二叉树,英文简称为 BST 又被称为:二叉查找树.二叉排序树 任意一个节点的值都大于其左子树所有节 ...
- springboot整合websocket后打包报错:javax.websocket.server.ServerContainer not available
项目整合了websocket以后,打包多次都没有成功,原来是报错了,报错内容如下: Error starting ApplicationContext. To display the conditio ...
- python编译错误ValueError: Complex data not supported
今天在用python跑一个k-means算法与谱聚类算法对比的程序时,谱聚类的图不能出来,编译报错 后来,多亏了这位GitHub用户,找到了解决办法,是因为在运算过程中出现了复数,因此要进行强制转换 ...