Mybatis的Mapper接口传递多个参数的时候必须要加@Param注解吗?

答案是:不一定,取决于mybatis的版本、jdk的版本和javac的编译选项。

测试代码

Maven依赖:

xml 复制代码
<dependency>
	<groupId>org.mybatis.spring.boot</groupId>
	<artifactId>mybatis-spring-boot-starter</artifactId>
	<version>2.3.1</version>
</dependency>

依赖的mybatis的版本是3.5.13

text 复制代码
[INFO] +- org.mybatis.spring.boot:mybatis-spring-boot-starter:jar:2.3.1:compile
[INFO] |  +- org.mybatis.spring.boot:mybatis-spring-boot-autoconfigure:jar:2.3.1:compile
[INFO] |  +- org.mybatis:mybatis:jar:3.5.13:compile
[INFO] |  \- org.mybatis:mybatis-spring:jar:2.1.1:compile

Mapper接口:

java 复制代码
@Mapper
public interface DeptMapper {
    @Select("select * from dept where name = #{name} and code = #{code}")
    List<Dept> selectByNameAndCode(String name, String code);
}

junit test:

java 复制代码
@Test
   public void testSelectByNameAndCode() {
       List<Dept> depts = deptMapper.selectByNameAndCode("学工部", "XUEGONG");
       System.out.println(depts);
   }

能正常输出。

原因解析

查看mybatis的官方文档:

翻译一下:3.4.1之后提供了useActualParamName这个boolean的选项(默认是true),允许把接口方法的形参名作为mybatis语句的参数名,但是前提是项目需要用jdk8以上去编译并且需要添加编译选项-paramters。

测试1)关闭useActualParamName

yml 复制代码
mybatis:
  configuration:
    use-actual-param-name: false

再运行就会报错:

text 复制代码
org.mybatis.spring.MyBatisSystemException: 
nested exception is org.apache.ibatis.binding.BindingException: 
Parameter 'name' not found. Available parameters are [0, 1, param1, param2]

测试2)关闭编译选项-parameters

idea->file->settings->compiler->java compiler

重新build项目,这样会重新编译class文件,再运行,依然报同样的错误。

看下org.apache.ibatis.reflection.ParamNameResolver#ParamNameResolver这个方法的源代码就足够了。

测试代码下载

结论

1)3.4.1之前,mapper接口传递多个参数的时候,必须要加@Param,不加就会报错。

2)3.4.1之后不一定,如果是开启了useActualParamName参数(默认就是开启的),并且在源代码编译的时候加上了-parameters参数(idea默认就添加了这个参数)就不需要加@Param了,否则还是需要加@Param的。

3)综上,建议还是加上吧。

相关推荐
阿达和自己2 天前
springboot学习-springboot引入MyBatis-Plus
spring boot·学习·mybatis
2603_969694853 天前
【JavaWeb学习记录】MyBatis核心知识点与实战笔记:从入门到动态SQL
笔记·sql·学习·mysql·mybatis·javaweb·学习方法
wang_shu_mo_ran3 天前
MyBatis 从入门到进阶(一)
java·spring·mybatis
瑞雪兆丰年兮3 天前
JavaWeb-day14-SpringBootWeb原理篇
java·开发语言·spring boot·spring·bean·mybatis·javaweb
bksczm6 天前
Redis 持久化:RDB 快照与 AOF 日志
数据库·redis·mybatis
CoderYanger7 天前
Java EE 进阶:8.MyBatis 操作数据库(入门)(第二弹)
java·数据库·spring boot·spring·面试·java-ee·mybatis
CoderYanger10 天前
Java EE 进阶:8.MyBatis 操作数据库(入门)(第一弹)
java·数据库·spring·面试·职场和发展·java-ee·mybatis
真上帝的左手12 天前
30. 技术专题-‌应用框架组件-关系型数据库-MySQL-Mybatis
数据库·分布式·mysql·中间件·mybatis
雪芽蓝域zzs12 天前
第 2 章:整合 MySQL + MyBatis,搭建数据库基础、实体类、Mapper、测试查询
数据库·mysql·mybatis
wljt13 天前
公司二-面试题
java·开发语言·mybatis