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 mapperPUBLIC "-//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 userwhere 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 mapperPUBLIC "-//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 userwhere 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 mapperPUBLIC "-//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 userwhere 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 mapperPUBLIC "-//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 userwhere 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 mapperPUBLIC "-//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 userwhere 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 mapperPUBLIC "-//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 userwhere 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 mapperPUBLIC "-//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 userwhere 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 mapperPUBLIC "-//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 userwhere id in<foreach collection="ids" open="(" close=")" item="id" separator=",">#{id}</foreach></select>
</mapper>

注意：以上这些类型参数，MyBatis都默认提供了一些参数名称，例如：arg0，param0，list、array、collection等。

但是，在实际开发中，都是会通过@Param注解来指定具体的参数名称，因为这样更加的直观清晰。