HoRain云--MyBatis多参数查询最佳实践-开发者社区

🎬 HoRain 云小助手：个人主页

⛺️生活的理想，就是为了理想的生活!

⛳️ 推荐

前些天发现了一个超棒的服务器购买网站，性价比超高，大内存超划算！忍不住分享一下给大家。点击跳转到网站。

⛳️ 推荐

1. 使用 @Param 注解（推荐用于参数较少场景）

2. 使用 Map 传参（适合动态查询）

3. 使用 Java Bean 对象（推荐用于复杂查询）

4. MyBatis-Plus QueryWrapper（现代化选择）

动态 SQL 标签详解

实用建议

在 MyBatis 中进行多参数查询有多种灵活的方式，下面我为你详细介绍最常用的几种方法及其适用场景。

方法	适用场景	优点	缺点
@Param 注解	参数数量较少（2-5个）的固定查询	代码直观，参数名明确，可读性强	参数过多时代码冗长
Map 传参	动态条件查询，参数不固定	灵活性高，适合条件动态变化	类型不安全，key容易拼写错误
Java Bean 对象	参数较多且有明确业务含义	结构清晰，类型安全，易于维护	需要创建额外的类
MyBatis-Plus QueryWrapper	使用 MyBatis-Plus 框架的项目	链式调用，编程式构建条件	仅适用于 MyBatis-Plus

1. 使用 @Param 注解（推荐用于参数较少场景）

这是最常用的多参数传递方式，通过在接口方法参数前添加@Param注解来为参数命名。

Mapper 接口：

public interface UserMapper { User findByUsernameAndEmail( @Param("username") String username, @Param("email") String email ); // 用于 IN 查询的列表参数 List<User> findUsersByIds(@Param("ids") List<Long> ids); }

XML 映射文件：

<select id="findByUsernameAndEmail" resultType="User"> SELECT * FROM users WHERE username = #{username} AND email = #{email} </select> <select id="findUsersByIds" resultType="User"> SELECT * FROM users WHERE id IN <foreach collection="ids" item="id" open="(" separator="," close=")"> #{id} </foreach> </select>

2. 使用 Map 传参（适合动态查询）

当查询条件不固定时，使用 Map 可以灵活地传递参数。

Mapper 接口：

public interface UserMapper { List<User> findUsersByCondition(Map<String, Object> params); }

Service 层调用：

public List<User> searchUsers(String name, Integer age, String email) { Map<String, Object> params = new HashMap<>(); if (name != null) params.put("name", name); if (age != null) params.put("age", age); if (email != null) params.put("email", email); return userMapper.findUsersByCondition(params); }

XML 映射文件（使用动态 SQL）：

<select id="findUsersByCondition" parameterType="map" resultType="User"> SELECT * FROM users <where> <if test="name != null"> AND name LIKE CONCAT('%', #{name}, '%') </if> <if test="age != null"> AND age = #{age} </if> <if test="email != null"> AND email = #{email} </if> </where> </select>

3. 使用 Java Bean 对象（推荐用于复杂查询）

当参数较多且有明确业务含义时，创建一个专门的查询参数对象是最佳选择。

查询参数类：

public class UserQueryParams { private String username; private String email; private Integer minAge; private Integer maxAge; private Date createTimeStart; private Date createTimeEnd; // getter 和 setter 方法 }

Mapper 接口：

public interface UserMapper { List<User> findUsersByQueryParams(UserQueryParams params); }

XML 映射文件：

<select id="findUsersByQueryParams" parameterType="UserQueryParams" resultType="User"> SELECT * FROM users <where> <if test="username != null"> AND username = #{username} </if> <if test="email != null"> AND email = #{email} </if> <if test="minAge != null"> AND age >= #{minAge} </if> <if test="maxAge != null"> AND age <= #{maxAge} </if> <if test="createTimeStart != null"> AND create_time >= #{createTimeStart} </if> <if test="createTimeEnd != null"> AND create_time <= #{createTimeEnd} </if> </where> ORDER BY create_time DESC </select>

4. MyBatis-Plus QueryWrapper（现代化选择）

如果你使用 MyBatis-Plus，QueryWrapper 提供了更简洁的链式编程方式。

使用示例：

@Service public class UserService { @Autowired private UserMapper userMapper; public List<User> findUsers(String username, Integer minAge, Integer maxAge) { QueryWrapper<User> queryWrapper = new QueryWrapper<>(); if (username != null) { queryWrapper.like("username", username); } if (minAge != null) { queryWrapper.ge("age", minAge); } if (maxAge != null) { queryWrapper.le("age", maxAge); } queryWrapper.orderByDesc("create_time"); return userMapper.selectList(queryWrapper); } // 分页查询 public Page<User> findUsersWithPage(Page<User> page, UserQueryParams params) { QueryWrapper<User> queryWrapper = new QueryWrapper<>(); // 构建查询条件... return userMapper.selectPage(page, queryWrapper); } }