MyBatis框架中各种参数类型绑定的方式
一、MyBatis参数绑定
MyBatis框架中,通过Mapper接口和Mapper映射文件的方式来操作数据库的时候,可能需要通过Mapper接口中的方法传递相应的参数拼接到SQL语句上面,那么Mybatis将传递的参数映射到对应SQL上面的过程,我们就叫做参数绑定。下面介绍MyBatis框架里面,几种常见的参数绑定类型。
1.1、单个参数
当Mapper接口里面的方法只有一个参数的时候,这个时候参数名称和Mapper映射文件里面的参数名称可以不一致,为什么呢???因为你这个方法既然只有一个参数,MyBatis就只能使用这一个参数,那这个参数叫什么名称也就没有什么规定了。
- 创建Mapper接口方法。
package cn.js.mapper;
import cn.js.domain.User;
import java.util.List;
/**
* @author js
* @version 1.0.0
* @Date: 2023/9/7 12:14
* @Description
*/
public interface UserMapper {
/**
* 一个参数的情况
* @param id
* @return
*/
List<User> queryList(Integer id);
}
- 定义Mapper映射文件。
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="cn.js.mapper.UserMapper">
<!-- 编写查询SQL语句 -->
<select id="queryList" resultType="cn.js.domain.User"
parameterType="java.lang.Integer">
select * from user
where id = #{abc}
</select>
</mapper>
上面定义了一个参数的接口方法,可以看到接口方法中的参数名称叫做:id,而在XML映射文件里面则是使用【#{abc}】来获取的参数,MyBatis对于只有一个参数的时候,是支持这种写法的。
1.2、多个参数
当接口方法需要传递多个参数的时候,这个时候XML映射文件里面,参数名称就不能任意编写了,那要如何获取到具体某个参数值呢???MyBatis框架支持下面三种方式进行参数绑定:
三种参数获取方式:
- 第一种方式:通过【arg0】【arg1】等等参数名称来获取参数值。
- 第二种方式:通过【param0】【param1】等参数名称来获取参数值。
- 第三种方式:通过@Param注解获取指定参数名称的对应关系。
(1)arg和param获取参数
MyBatis对于多个参数的情况下,框架会默认按照接口方法中参数的顺序,依次将这些参数保存到一个map集合里面,而这个map集合是以【arg】或者【param】两个作为key的,对应的value就是具体的参数值。
举例如下:
- 接口方法中有两个参数时候,这个时候MyBatis会将参数保存到map集合里面。
- 【map.put(“arg0”, “参数1”);】或者【map.put(“param0”, “参数1”);】
- 【map.put(“arg1”, “参数2”);】或者【map.put(“param1”, “参数2”);】
- 多个参数依次类推,【map.put(“argn”, “参数n”);】或者【map.put(“paramn”, “参数n”);】。
按照上面的规则,我们只需要在XML映射文件里面,通过对应的参数key就可以获取到对应的参数值。
package cn.js.mapper;
import cn.js.domain.User;
import java.util.List;
/**
* @author js
* @version 1.0.0
* @Date: 2029/8/6 13:14
* @Description
*/
public interface UserMapper {
/**
* 多个参数情况
* @param id
* @param username
* @return
*/
List<User> queryList2(Integer id, String username);
}
- 定义的XML映射文件。
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="cn.js.mapper.UserMapper">
<!-- 编写查询SQL语句 -->
<select id="queryList2" resultType="cn.js.domain.User">
select * from user
where id = #{arg0}
and username = #{param2}
</select>
</mapper>
【arg】和【param】可以混合使用,这两种获取参数的方式都是MyBatis支持的。
(2)@Param注解获取参数
通过上面方式获取参数来看,太不方便了,我们还需要确保【arg】和【param】对应哪个参数,如果不小心对应错了,不容易发现问题所在,为了解决这个问题,MyBatis提供了@Param注解,@Param注解的作用就是将接口方法参数和XML映射文件中的参数进行关系映射。
package cn.js.mapper;
import cn.js.domain.User;
import org.apache.ibatis.annotations.Param;
import java.util.List;
/**
* @author js
* @version 1.0.0
* @Date: 2023/9/7 14:14
* @Description
*/
public interface UserMapper {
/**
* 多个参数的情况
* @param id
* @param username
* @return
*/
List<User> queryList3(@Param("id") Integer id, @Param("uname") String username);
}
- 定义XML映射文件。
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="cn.js.mapper.UserMapper">
<!-- 编写查询SQL语句 -->
<select id="queryList3" resultType="cn.js.domain.User">
select * from user
where id = #{id}
and username = #{uname}
</select>
</mapper>
上面这种方式是实际开发里面最常用的,因为这种方式更加的直观,参数绑定关系一目了然。
1.3、Map类型参数
MyBatis框架对于多个参数的时候,是采用Map集合来保存的,那么我们就可以自己定义Map集合作为参数,使用的时候也是直接通过key获取对应的参数值即可。
package cn.js.mapper;
import cn.js.domain.User;
import java.util.List;
import java.util.Map;
/**
* @author js
* @version 1.0.0
* @Date: 2023/9/9 10:12
* @Description
*/
public interface UserMapper {
/**
* Map集合参数
* @param map
* @return
*/
List<User> queryList4(Map<String, String> map);
}
- Mapper映射文件。
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="cn.js.mapper.UserMapper">
<!-- 编写查询SQL语句 -->
<select id="queryList4" resultType="cn.js.domain.User">
select * from user
where id = #{id}
and username = #{uname}
</select>
</mapper>
1.4、JavaBean类型参数
MyBatis对于JavaBean类型的参数,它在进行参数绑定的时候,是根据对应的【getter】方法来获取参数值的,也就是说,XML映射文件里面的参数名称,必须是在JavaBean实体类里面具有【getXXX()】方法的,这样才能够进行参数绑定。
package cn.js.mapper;
import cn.js.User;
import java.util.List;
/**
* @author js
* @version 1.0.0
* @Date: 2023/9/8 09:14
* @Description
*/
public interface UserMapper {
/**
* 实体类参数
* @param user
* @return
*/
List<User> queryList5(User user);
}
- 创建XML映射文件。
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="cn.js.mapper.UserMapper">
<!-- 编写查询SQL语句 -->
<select id="queryList5" resultType="cn.js.domain.User">
select * from user
where id = #{id}
and username = #{username}
</select>
</mapper>
实体类参数绑定规则如下所示:
1.5、List集合类型
集合类型的参数,在实际开发里面,使用最多的场景就是【IN】条件查询,批量插入、批量更新的操作。
package cn.js.mapper;
import cn.js.domain.User;
import java.util.List;
/**
* @author js
* @version 1.0.0
* @Date: 2023/9/8 17:21
* @Description
*/
public interface UserMapper {
/**
* 集合类型参数
* @param ids
* @return
*/
List<User> queryList6(List<String> ids);
}
- 创建XML映射文件。
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="cn.js.mapper.UserMapper">
<!-- 编写查询SQL语句 -->
<select id="queryList6" resultType="cn.js.domain.User">
select * from user
where id in
<foreach collection="list" open="(" close=")" item="id" separator=",">
#{id}
</foreach>
</select>
</mapper>
MyBatis对于集合类型的参数,如果没有使用@Param注解明确指定参数名称,那么MyBatis框架会默认采用**【arg0,list、collection】**三个参数名称进行映射,所以我们在使用的参数的时候,不能使用接口方法参数名称,只能够使用【arg0,list、collection】这三个参数名称。
<!-- 使用 collection 参数名称 -->
<foreach collection="collection" open="(" close=")" item="id" separator=",">
#{id}
</foreach>
<!-- 使用 arg0 参数名称 -->
<foreach collection="arg0" open="(" close=")" item="id" separator=",">
#{id}
</foreach>
<!-- 使用 list 参数名称 -->
<foreach collection="list" open="(" close=")" item="id" separator=",">
#{id}
</foreach>
当然,如果我们通过@Param注解指定了具体的参数名称,那就直接使用具体的参数名称就好啦。
1.6、Set集合类型参数
对于Set集合参数类型来说,它其实和List集合是类似的,只不过Set集合在没有指定具体参数名称的时候,MyBatis框架默认提供了**【arg0,collection】**两个参数名称,相比于List集合,Set集合缺少一个参数名称。
package cn.js.mapper;
import cn.js.domain.User;
import java.util.List;
import java.util.Set;
/**
* @author js
* @version 1.0.0
* @Date: 2023/9/8 17:30
* @Description
*/
public interface UserMapper {
/**
* 集合参数类型
* @param ids
* @return
*/
List<User> queryList7(Set<String> ids);
}
- 创建XML映射文件。
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="cn.js.mapper.UserMapper">
<!-- 编写查询SQL语句 -->
<select id="queryList7" resultType="cn.js.domain.User">
select * from user
where id in
<foreach collection="arg0" open="(" close=")" item="id" separator=",">
#{id}
</foreach>
</select>
</mapper>
Set集合类型参数只提供了两种默认的参数名称可供选择。
<!-- 使用 collection 参数名称 -->
<foreach collection="collection" open="(" close=")" item="id" separator=",">
#{id}
</foreach>
<!-- 使用 arg0 参数名称 -->
<foreach collection="arg0" open="(" close=")" item="id" separator=",">
#{id}
</foreach>
1.7、数组类型参数
对于数组类型的参数,MyBatis默认提供了两种参数名称可供选择,分别是:【arg0,array】。
package cn.js.mapper;
import cn.js.domain.User;
import java.util.List;
/**
* @author js
* @version 1.0.0
* @Date: 2022/9/7 10:26
* @Description
*/
public interface UserMapper {
/**
* 数组类型参数
* @param ids
* @return
*/
List<User> queryList8(int[] ids);
}
- 定义XML映射文件。
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="cn.js.mapper.UserMapper">
<!-- 编写查询SQL语句 -->
<select id="queryList8" resultType="cn.js.domain.User">
select * from user
where id in
<foreach collection="ids" open="(" close=")" item="id" separator=",">
#{id}
</foreach>
</select>
</mapper>
注意:以上这些类型参数,MyBatis都默认提供了一些参数名称,例如:arg0,param0,list、array、collection等。
但是,在实际开发中,都是会通过@Param注解来指定具体的参数名称,因为这样更加的直观清晰。