码猿技术专栏

微信公众号:码猿技术专栏

Mybatis的Mapper中的方法为什么不能重载?

前言

  • 在初入门Mybatis的时候可能都犯过一个错误,那就是在写Mapper接口的时候都重载过其中的方法,但是运行起来总是报错,那时候真的挺郁闷的,但是自己也查不出来原因,只能默默的改了方法名,哈哈,多么卑微的操作。
  • 今天就写一篇文章从源码角度为大家解惑为什么Mybatis中的方法不能重载?

    环境配置

  • 本篇文章讲的一切内容都是基于Mybatis3.5SpringBoot-2.3.3.RELEASE

错误示范

  • 举个栗子:假设现在有两个需求,一个是根据用户的id筛选用户,一个是根据用户的性别筛选,此时在Mapper中重载的方法如下:

    1
    2
    3
    4
    5
    public interface UserMapper {
    List<UserInfo> selectList(@Param("userIds") List<String> userIds);

    List<UserInfo> selectList(Integer gender);
    }
  • 这个并没有什么错误,但是启动项目,报出如下的错误:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    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

  • 到了这其实并不能说明方法不能重载啊,重复就重复呗,并没有冲突啊。这里需要看一个结构,如下:

    1
    2
    3
    protected final Map<String, MappedStatement> mappedStatements = new StrictMap<MappedStatement>("Mapped Statements collection")
    .conflictMessageProducer((savedValue, targetValue) ->
    ". please check " + savedValue.getResource() + " and " + targetValue.getResource());
  • 构建好的MappedStatement都会存入mappedStatements中,如下代码:

    1
    2
    3
    4
    public void addMappedStatement(MappedStatement ms) {
    //key 是id
    mappedStatements.put(ms.getId(), ms);
    }
  • StrictMapput(k,v)方法如下图:

到了这里应该理解了吧,这下抛出的异常和上面的异常信息对应起来了吧。这个StrictMap不允许有重复的key,而存入的key就是id。因此Mapper中的方法不能重载。

如何找到XML中对应的SQL?

  • 在使用Mybatis的时候只是简单的调用Mapper中的方法就可以执行SQL,如下代码:

    1
    List<UserInfo> userInfos = userMapper.selectList(Arrays.asList("192","198"));

    一行简单的调用到底如何找到对应的SQL呢?其实就是根据idMap<String, MappedStatement> mappedStatements中查找对应的MappedStatement

  • org.apache.ibatis.session.defaults.DefaultSqlSession#selectList方法有这一行代码如下图:

  • MappedStatement ms = configuration.getMappedStatement(statement);这行代码就是根据idmappedStatements获取对应的MappedStatement,源码如下:

    1
    2
    3
    public MappedStatement getMappedStatement(String id) {
    return this.getMappedStatement(id, true);
    }

总结

  • 文章写到这,想必已经很清楚Mapper中的方法为什么不能重载了,归根到底就是因为这个这个id=Mapper的全类名+'.'+方法名
  • 如果觉得作者写的不错,有所收获的话,点点关注,分享一波,关注微信公众号码猿技术专栏第一手文章推送!!!

欢迎关注我的其它发布渠道