文章目录
- 背景
- 什么是@Param
- @Param的使用方法使用方法:
- 遇到的问题及因
- @Param解决了什么问题
- 使用与不使用对比
- @Param是如何进行映射的
- 总结
背景
最近在开发过程中,在写mapper接口是在参数前加了@Param注解,但是在运行的时候就会报错,说是找不到参数、
nested exception is org.apache.ibatis.binding.BindingException: Parameter ‘defaultRole’ not found. Available parameters are [role, param1]
什么是@Param
@Param注解是一种用于标记方法参数的注解,它用于指定该参数的名称和类型,在使用该参数时可以通过名称来引用。在不同的编程语言和框架中,@Param注解的具体用法和功能可能会有所不同。
在Java开发中,如果用到了mybatis,那么@Param是用户给方法参数指定一个名称,以便在Mapper XML文件中引用该参数。
@Param的使用方法使用方法:
当使用MyBatis框架时,@Param注解有以下几种使用方法:
1、在Mapper接口方法的参数前使用@Param注解指定参数名称:
void insertUser(@Param("user") User user);
在Mapper XML文件中可以使用#{user}来引用参数。
2、在Mapper接口方法的参数前使用@Param注解指定多个参数名称:
void insertUserAndRole(@Param("user") User user, @Param("role") Role role);
在Mapper XML文件中可以使用#{user}和#{role}来引用参数。
3、在Mapper接口方法的参数前使用@Param注解指定相同的参数名称:
void insertUsers(@Param("users") List<User> users);
在Mapper XML文件中可以使用#{users}来引用参数。
4、在Mapper接口方法的参数前使用@Param注解指定多个相同的参数名称:
void insertUserAndRoles(@Param("users") List<User> users, @Param("roles") List<Role> roles);
在Mapper XML文件中可以使用#{users}和#{roles}来引用参数。
5、在Mapper接口方法的参数前不使用@Param注解:
void insertUser(User user);
在Mapper XML文件中可以使用#{arg0}来引用参数,或者把#{arg0}替换为#{user}
6、在Mapper接口方法的参数前不使用@Param注解,但有多个参数:
void insertUserAndRole(User user, Role role);
在Mapper XML文件中可以使用#{arg0}和#{arg1}来引用参数。
这些是@Param注解的常见使用方法。通过使用@Param注解,可以明确指定Mapper接口方法参数的名称,使得在Mapper XML文件中引用参数更加直观和可读。
原理:
@Param注解的作用是给Mapper接口方法的参数命名,以便在Mapper XML文件中引用这些参数。没有@Param注解时,MyBatis无法识别参数的名称,导致无法正确引用参数。
在编译时,Java编译器会将@Param注解保留在编译后的字节码文件中。MyBatis通过Java的反射机制获取Mapper接口方法的参数列表,并检查是否存在@Param注解。
当解析Mapper XML文件时,MyBatis会根据#{}占位符中的名称来查找对应的参数。如果找不到与占位符名称匹配的参数,MyBatis会抛出BindingException异常。
遇到的问题及因
这是我写的mapper接口:
int setDefaultRole( List<SysRole> roleList);
以及xml文件:
<update id="setDefaultRole" >update sys_role<set><foreach collection="roleList" item="role" separator=",">default_role=#{role.defaultRole},update_by=#{role.updateBy},update_time=sysdate()</foreach></set>where role_id in<foreach collection="roleList" item="role" open="(" close=")" separator=",">#{role.roleId}</foreach>and del_flag=0</update>
那么在xml文件中用到了多个关于roleList的多个参数,所以这里如果不使用@Param注解是不可以,他不能对应上对应的参数
这个错误通常是由于Mapper接口方法的参数和Mapper XML文件中的参数名不一致导致的。
@Param解决了什么问题
@Param注解主要解决了以下两个问题:
解决多个参数的问题: 在Mapper接口方法中,如果存在多个参数,MyBatis默认会将这些参数封装为一个Map对象,并以参数名作为键,参数值作为值。但是,当需要在Mapper XML文件中引用这些参数时,就需要使用#{}占位符,并指定对应的参数名。而@Param注解可以明确指定参数的名称,使得在Mapper XML文件中引用参数更加直观和可读。
解决参数名与Mapper XML文件中占位符名称不一致的问题: 在Mapper XML文件中,使用#{}占位符来引用参数,占位符中的名称应该与Java代码中的参数名称一致。但是,Java编译器在编译时会将参数名擦除,导致在运行时无法获取参数的名称。而@Param注解可以保留参数的名称,并在运行时通过反射机制获取参数的名称,从而确保参数名与占位符名称一致。
通过使用@Param注解,可以提高Mapper接口方法的可读性和可维护性,避免了潜在的错误。它确保了Mapper XML文件中的参数引用与Java代码中的参数名称一致。
使用与不使用对比
使用@Param注解和不使用的区别主要体现在Mapper接口方法的参数映射上。
不使用@Param注解:
void insertUser(User user);
在Mapper接口方法中,直接使用参数对象作为方法的参数,例如User user。在Mapper XML文件中,可以使用#{}占位符来引用参数的属性,例如#{id}和#{name}。
使用@Param注解:
void insertUser(@Param(“user”) User user);
在Mapper接口方法中,使用@Param注解来明确指定参数的名称,例如@Param(“user”)。在Mapper XML文件中,可以使用#{}占位符来引用参数,占位符中的名称应与@Param注解中指定的名称一致,例如#{user.id}和#{user.name}。
使用@Param注解的优势是可以提高Mapper接口方法的可读性和可维护性。通过明确指定参数的名称,可以确保参数名与占位符名称一致,避免因为参数顺序变化或者重载方法导致的错误。
总结起来,使用@Param注解可以提高Mapper接口方法的可读性和可维护性,确保参数名与占位符名称一致,而不使用@Param注解则直接使用参数对象作为方法的参数。
@Param是如何进行映射的
当使用@Param注解时,MyBatis会通过反射机制获取Mapper接口方法的参数信息,包括参数的名称和类型。然后,MyBatis会将这些参数信息与方法的参数列表进行关联,以便后续在Mapper XML文件中引用这些参数。
具体的映射过程如下:
在Mapper接口方法上使用@Param注解,并指定参数的名称。例如:
void insertUser(@Param("user") User user);
这里使用@Param(“user”)注解明确指定了参数的名称为"user"。
MyBatis解析Mapper接口方法时,会通过反射获取方法的参数信息,包括参数的名称和类型。这是通过Java的反射机制实现的。
在解析Mapper XML文件时,MyBatis会使用ParamNameResolver类来解析占位符中的参数名称。ParamNameResolver会根据方法的参数列表和参数名称,确定参数的映射关系。
在Mapper XML文件中,可以使用#{}占位符来引用参数。占位符中的名称应与Java代码中的参数名称一致。例如:
<insert id="insertUser" parameterType="com.example.User">INSERT INTO user (id, name) VALUES (#{user.id}, #{user.name})
</insert>
这里使用#{user.id}和#{user.name}来引用参数。
通过以上过程,@Param注解实现了参数名称与Mapper XML文件中占位符名称的映射关系。这样可以提高Mapper接口方法的可读性和可维护性,确保参数名与占位符名称一致。
总的来说,@Param注解的工作原理是通过反射机制获取参数信息,并将参数名称与方法的参数列表进行关联,以确保参数名与占位符名称一致。这样可以提高Mapper接口方法的可读性和可维护性。
总结
总结起来,@Param注解用于在Mapper接口方法中明确指定参数的名称,以提高方法的可读性和可维护性。以下是关于@Param注解的优缺点的总结:
优点:
明确参数名称:使用@Param注解可以明确指定参数的名称,避免参数顺序变化或者重载方法导致的错误。这样可以提高代码的可读性和可维护性。
参数与占位符一致:@Param注解可以确保参数名与Mapper XML文件中的占位符名称一致,避免因为参数名与占位符不一致而引发的错误。
缺点:
冗余代码:使用@Param注解会在Mapper接口方法中增加注解的代码,可能会导致代码的冗余。
额外的注解:使用@Param注解需要在Mapper接口方法中添加额外的注解,可能会增加代码的复杂性。
@Param注解可以提高Mapper接口方法的可读性和可维护性,确保参数名与占位符名称一致。然而,使用@Param注解可能会导致代码的冗余,同时也需要额外的注解。因此,在使用@Param注解时,需要根据具体情况进行权衡和取舍。