mybatisplus的QueryWrapper有什么作用？怎么使用？（附应用场景）

本文链接：https://blog.csdn.net/shayenudong/article/details/144774434

MyBatis-Plus 的 QueryWrapper 是一个强大的查询条件构造器，它的作用和使用方法如下：

作用：

构建查询条件：QueryWrapper 用于构建动态SQL查询条件，它封装了各种条件构造方法，使得查询条件的构建更加简洁和直观。
链式调用：支持链式调用的方式添加多个查询条件，方便进行多条件组合。
支持多种查询：包括等值、不等值、大于、小于、模糊查询等多种查询条件的构建。
动态条件拼接：可以根据条件的存在与否动态构建查询条件，提供and、or、nested等条件拼接方法。
支持排序和分组：可以设置查询结果的排序和分组。
自定义SQL片段：允许在查询中加入自定义的SQL片段。

使用方法：

创建QueryWrapper对象：

QueryWrapper<User> queryWrapper = new QueryWrapper<>();

或者使用Lambda表达式创建LambdaQueryWrapper：

LambdaQueryWrapper<User> lambdaQueryWrapper = Wrappers.lambdaQuery();

设置查询条件：

等值查询：
```
queryWrapper.eq("username", "admin");
```
不等值查询：
```
queryWrapper.ne("age", 25);
```

大于、小于等查询：

queryWrapper.gt("age", 20);
queryWrapper.lt("age", 30);

模糊查询：
```
queryWrapper.like("username", "a");
```

多条件查询：

queryWrapper.and(qw -> qw.eq("username", "admin").ne("age", 25));

排序：

queryWrapper.orderByAsc("create_time");
queryWrapper.orderByDesc("create_time");

自定义SQL片段：

queryWrapper.apply("date_format(create_time,'%Y-%m-%d')={0}", "2021-01-01");

执行查询：

List<User> userList = userMapper.selectList(queryWrapper);

Lambda表达式：使用Lambda表达式进行类型安全的字段操作，避免硬编码字段名：

LambdaQueryWrapper<User> lambdaQueryWrapper = Wrappers.lambdaQuery();
lambdaQueryWrapper.eq(User::getUsername, "admin").ne(User::getAge, 25);

QueryWrapper 提供了灵活、简洁的查询语句构建方式，使得数据库操作更加方便。通过上述方法，可以根据实际业务需求组合使用不同的查询条件，构建出复杂的查询语句。

使用场景

QueryWrapper 在复杂查询中的应用场景非常广泛，以下是几个例子：

1. 多条件组合查询

假设我们有一个用户表User，包含字段id、username、age、email等，现在需要查询年龄大于20岁且用户名以"a"开头的用户。

QueryWrapper<User> queryWrapper = new QueryWrapper<>();
queryWrapper.gt("age", 20).like("username", "a");
List<User> users = userMapper.selectList(queryWrapper);

2. 动态条件查询

有时候，我们需要根据传入的参数动态构建查询条件。例如，根据用户输入的不同，可能需要查询用户名、邮箱或年龄。

QueryWrapper<User> queryWrapper = new QueryWrapper<>();
if (username != null && !username.isEmpty()) {
    queryWrapper.like("username", username);
}
if (email != null && !email.isEmpty()) {
    queryWrapper.like("email", email);
}
if (age != null) {
    queryWrapper.eq("age", age);
}
List<User> users = userMapper.selectList(queryWrapper);

3. 排序和分页查询

在查询时，我们可能需要对结果进行排序，并进行分页处理。

QueryWrapper<User> queryWrapper = new QueryWrapper<>();
queryWrapper.orderByDesc("age").orderByDesc("create_time");
Page<User> page = new Page<>(1, 10); // 第1页，每页10条
IPage<User> userPage = userMapper.selectPage(page, queryWrapper);
List<User> users = userPage.getRecords();

4. 嵌套查询条件

有时候需要嵌套查询条件，比如查询用户名不为"admin"且年龄大于20岁的用户，或者邮箱以"@"结尾的用户。

QueryWrapper<User> queryWrapper = new QueryWrapper<>();
queryWrapper.and(wrapper -> wrapper.ne("username", "admin").gt("age", 20))
            .or().eq("email", email);
List<User> users = userMapper.selectList(queryWrapper);

5. 自定义SQL片段

在某些复杂查询中，可能需要添加自定义的SQL片段。

QueryWrapper<User> queryWrapper = new QueryWrapper<>();
queryWrapper.apply("status = {0} AND (age > {1} OR username LIKE {2})", 1, 20, "%admin%");
List<User> users = userMapper.selectList(queryWrapper);

6. 关联查询

在处理关联表查询时，QueryWrapper 也可以通过自定义SQL片段来实现。

QueryWrapper<Order> queryWrapper = new QueryWrapper<>();
queryWrapper.select("order_id", "total_amount")
            .apply("user_id = {0}", userId)
            .orderByDesc("create_time");
List<Order> orders = orderMapper.selectList(queryWrapper);