【Mybatis】mapper接口多参数

mybatis mapper接口类可以通过五种方法接收多个参数

方法一：利用arg或param

利用arg或param获取mapper接口类的多参数
arg可以通过#{arg0}、#{arg1}、#{arg2}…获取接口中相对应的参数
param可以通过#{param1}、#{param2}、#{param3}…获取接口中相对应的参数。

方法二：map

通过把参数 以键值对 的方式存储到map集合中，然后把map集合作为mapper接口类的参数，在mapper映射文件中编写SQL语句需要调用参数值时，可以通过map集合的key调用。

public List<User> findUserMap(Map<String, Object> parameterMap);

<select id="findUserMap" parameterType="map" resultType="user">
    <!-- concat：将多个字段连接起来，组成新的字段 -->
    select id,username from user where id=#{id} and username like concat('%',#{username},'%')
</select>

方法三：通过Java Bean传递多个参数

通过把参数赋值给类对象的变量，然后把类对象作为mapper接口类的参数，在mapper映射文件中编写SQL语句需要调用参数值时，可以通过类对象的变量名调用。

方法四：@Param()

通过 @Param() 注解给参数加上key，在mapper映射文件中就可以通过key，所谓的key也就是@Param内value中的值。

//mapper多参数传入
User findUserOne(@Param(value = "username") String username, @Param("password") String password);

方法五：混合使用

在某些情况下可能需要混合使用几种方法来传递参数。举个例子，查询一个角色，可以通过角色名称和备注进行查询，与此同时还需要支持分页

public List<Role> findByMix(@Param("params") RoleParams roleParams, @Param("page") PageParam PageParam);

<select id="findByMix" resultType="role">
    select id, role_name as roleName, note from t_role
    where role_name like concat('%', #{params.roleName}, '%') 
    and note like concat('%', #{params.note}, '%') 
    limit #{page.start}, #{page.limit}
</select>

解析

当只传一个参数时，不需要@Param注解标注key，可以省略

总结

• 使用 map 传递参数导致了业务可读性的丧失，导致后续扩展和维护的困难，在实际的应用中要果断废弃这种方式。
• 使用 @Param 注解传递多个参数，受到参数个数（n）的影响。当 n≤5 时，这是最佳的传参方式，它比用 Java Bean 更好，因为它更加直观；当 n＞5 时，多个参数将给调用带来困难，此时不推荐使用它。
• 当参数个数多于5个时，建议使用 Java Bean 方式。
• 对于使用混合参数的，要明确参数的合理性。