Mybatis-plus 条件构造器 Wrapper
注意⚠️
Wrapper类是 MyBatis-Plus 提供的工具类，必须与继承了BaseMapper的接口配合使用。
作用
Wrapper 是 MyBatis-Plus 提供的 条件构造器工具类，用于构建复杂的数据库查询条件。
它的作用是简化 SQL 条件构造，但它不能替代 Mapper 层。最终仍需通过 Mapper 接口的方法（如 selectList、selectOne 等）执行数据库操作。
它不涉及 SQL 的执行逻辑（如连接数据库、设置参数、返回结果映射等），这些仍由 Mapper 层负责。
构成
| QueryWrapper （LambdaQueryWrapper） | 用于构造查询条件，如：select、delete 中的 where |
| UpdateWrapper（LambdaUpdateWrapper） | 用于构造更新条件, 如：update 中的 set + where |
| AbstractWrapper | 上面所有wrapper的父类 |
| 操作类型 | 核心需求 | 是否需要 Wrapper | 示例 |
|---|---|---|---|
| 新增 | 设置字段值 | 否 | userMapper.insert(user) |
| 查询 | 构造 WHERE 条件 | 是 | userMapper.selectList(new QueryWrapper<User>().eq("name", "张三")) |
| 更新 | 设置 SET 字段 + WHERE 条件 | 部分需要 | userMapper.update(user, new UpdateWrapper<User>().eq("id", 1)) |
| 删除 | 构造 WHERE 条件 | 是 | userMapper.delete(new QueryWrapper<User>().eq("id", 1)) |
示例代码
QueryWrapper
QueryWrapper<User> queryWrapper = new QueryWrapper<>();
queryWrapper.eq("status", 1).like("name", "张").gt("age", 18).orderByDesc("create_time").last("LIMIT 10"); // 拼接原生 SQLList<User> users = userMapper.selectList(queryWrapper);
LambdaUpdateWrapper
LambdaUpdateWrapper<User> updateWrapper = new LambdaUpdateWrapper<>();
updateWrapper.set(User::getStatus, 0).set(User::getUpdateTime, LocalDateTime.now()).eq(User::getId, 1).or().lt(User::getAge, 18);userMapper.update(null, updateWrapper);
语法详解
条件构造器 | MyBatis-Plus
一、基础条件构造
1. 等值查询（=）
eq (String column, Object val) // = 等于// 示例：WHERE name = '张三'
queryWrapper.eq("name", "张三");
2. 非等值查询（!=、>、< 等）
ne(String column, Object val) // !=
gt(String column, Object val) // >
ge(String column, Object val) // >=
lt(String column, Object val) // <
le(String column, Object val) // <=// 示例：WHERE age > 18 AND salary <= 10000
queryWrapper.gt("age", 18).le("salary", 10000);
3. 模糊查询（LIKE）
like (String column, Object val) // LIKE '%值%'
likeLeft (String column, Object val) // LIKE '%值'
likeRight (String column, Object val) // LIKE '值%'notLike (String column, Object val)
notLikeLeft (String column, Object val)
notLikeRight (String column, Object val)// 示例：WHERE email LIKE '%@gmail.com'
queryWrapper.likeRight("email", "@gmail.com");
4. IN 查询
in(String column, Collection<?> values) // IN (v1, v2, ...)
in(String column, Object... values) // 可变参数版本// 示例：WHERE id IN (1, 2, 3)
queryWrapper.in("id", Arrays.asList(1, 2, 3));
5. NULL 判断
isNull(String column) // IS NULL
isNotNull(String column) // IS NOT NULL// 示例：WHERE create_time IS NULL
queryWrapper.isNull("create_time");
6. 范围查询（BETWEEN）
between (String column, Object val1, Object val2) // BETWEEN val1 AND val2
notBetween(String column, Object val1, Object val2) // NOT BETWEEN val1 AND val2// 示例：WHERE age BETWEEN 18 AND 30
queryWrapper.between("age", 18, 30);
二、逻辑组合（AND、OR、括号）
1. AND 连接（默认）
// 多个条件默认用 AND 连接
queryWrapper.eq("name", "张三").gt("age", 18);// 等价于：WHERE name = '张三' AND age > 18
2. OR 连接
or()
or(Consumer<Param> consumer) // 带括号的 OR// 示例：WHERE name = '张三' OR age > 18
queryWrapper.eq("name", "张三").or().gt("age", 18);// 示例：WHERE name = '张三' OR (age > 18 AND gender = 1)
queryWrapper.eq("name", "张三").or(w -> w.gt("age", 18).eq("gender", 1));
3. 括号分组
nested(Consumer<Param> consumer) // 嵌套括号// 示例：WHERE (name = '张三' OR name = '李四') AND age > 18
queryWrapper.nested(w -> w.eq("name", "张三").or().eq("name", "李四")).gt("age", 18);
三、排序（ORDER BY）
OrderBy(boolean condition, boolean isAsc, String... columns)
// 参数说明：(是否应用这个排序条件,是否升序，排序的字段名(可以是多个))
// 示例：
queryWrapper.orderBy(true, true, "id", "name");orderByAsc(String... columns) // 升序
orderByDesc(String... columns) // 降序// 示例：ORDER BY create_time DESC, id ASC
queryWrapper.orderByDesc("create_time").orderByAsc("id");
四、 分组 （GROUP BY）
// 设置分组条件，使用字段名
groupBy (R... columns)// 示例：
queryWrapper.groupBy("id", "name");五、 分页（配合 Page 对象）
// 需配合 IPage 接口使用
Page<User> page = new Page<>(1, 10); // 第1页，每页10条
IPage<User> result = userMapper.selectPage(page, queryWrapper);
六、UpdateWrapper 特有的 SET 方法
set(String column, Object val) // 设置更新字段
setSql(String sql) // 设置原生 SQL// 示例：UPDATE user SET name = '李四', age = 20 WHERE id = 1
updateWrapper.set("name", "李四").set("age", 20).eq("id", 1);
七、其他
1. 条件动态化（避免 NULL 条件）
eq(boolean condition, String column, Object val)// 示例：当 name 不为 null 时才添加条件
queryWrapper.eq(name != null, "name", name);
2. 查询指定字段（SELECT）
select(String... columns) // 查询指定字段// 示例：SELECT id, name FROM user
queryWrapper.select("id", "name");
3. 子查询
exists(String sql) // EXISTS (subquery)
notExists(String sql) // NOT EXISTS (subquery)
inSql(String column, String inValue) // IN (subquery)// 示例：WHERE EXISTS (SELECT 1 FROM order WHERE order.user_id = user.id)
queryWrapper.exists("SELECT 1 FROM order WHERE order.user_id = user.id");