Mybatis-plus动态条件查询QueryWrapper的函数用法

news2025/2/5 0:00:51

前言

原本都是在Mapper文件中修改，直到看到项目中使用了QueryWrapper这个函数，大致了解了用法以及功能，发现还可以！

对此此贴为科普帖以及笔记帖

1. QueryWrapper

MyBatis-Plus 是 MyBatis 的增强工具包，它简化了 MyBatis 的开发流程，提供了一些常用功能的增强和简化方法。其中，QueryWrapper 是 MyBatis-Plus 中用于构建动态条件查询的一个重要类。QueryWrapper 可以用于构建 SQL 的 WHERE 子句，动态地拼接条件，以实现灵活的查询。

查看其层级结构：
在这里插入图片描述

对于Wrapper主体父类其下有关系的类，主要作用如下：

Wrapper：
Wrapper 接口是用于构建查询条件的基础接口。
它声明了一些常用的设置条件的方法，比如 eq、ne、like 等。
QueryWrapper 和 UpdateWrapper 都实现了这个接口。
AbstractWrapper：
AbstractWrapper 是一个抽象类，实现了 Wrapper 接口。
为常用的条件设置方法提供了默认实现。
AbstractLambdaWrapper：
AbstractLambdaWrapper 继承自 AbstractWrapper，引入了用于类型安全查询的 lambda 表达式。
它专为使用 Java lambda 表达式指定查询条件的实体设计。
LambdaQueryWrapper：
LambdaQueryWrapper 是 AbstractLambdaWrapper 的具体实现，用于查询操作。
支持使用 lambda 表达式以类型安全的方式指定查询条件。
对于实体属性名称的编译时检查，避免运行时错误。
LambdaUpdateWrapper：
LambdaUpdateWrapper 是 AbstractLambdaWrapper 的具体实现，用于更新操作。
允许使用 lambda 表达式以类型安全的方式更新实体字段。
类似于 LambdaQueryWrapper，它通过编译时检查帮助避免运行时错误。
QueryWrapper：
QueryWrapper 是 AbstractWrapper 的具体实现，用于查询操作。
提供了各种方法用于设置不同的查询条件，如 eq、ne、like 等

2. 函数

以下是 QueryWrapper 常用的一些函数和用法：

eq、ne、gt、ge、lt、le：

这些方法分别表示等于、不等于、大于、大于等于、小于、小于等于的条件。

QueryWrapper<User> wrapper = new QueryWrapper<>();
wrapper.eq("name", "John") 
       .ne("age", 25)
       .gt("salary", 50000)
       .ge("create_time", "2022-01-01")
       .lt("update_time", "2023-01-01")
       .le("status", 1);

like、notLike、likeLeft、likeRight：用于构建模糊查询条件。

wrapper.like("name", "John")
       .notLike("description", "test")
       .likeLeft("code", "abc")
       .likeRight("email", "@domain.com");

isNull、isNotNull：用于构建判空条件。

wrapper.isNull("email")
       .isNotNull("phone");

in、notIn：用于构建 IN 和 NOT IN 条件。

wrapper.in("role", "admin", "user", "guest")
       .notIn("status", 0, 2, 3);

between、notBetween：用于构建 BETWEEN 和 NOT BETWEEN 条件。

wrapper.between("age", 20, 30)
       .notBetween("salary", 50000, 80000);

or、and：用于构建 OR 和 AND 条件，可以嵌套使用。

wrapper.and(i -> i.eq("name", "John").ne("age", 25))
       .or(i -> i.like("name", "Tom").ge("age", 30));

orderBy、orderByAsc、orderByDesc：用于指定排序方式。

wrapper.orderBy(true, true, "age")
       .orderByAsc("create_time")
       .orderByDesc("update_time");

groupBy、having：用于指定分组和分组后的条件。

wrapper.groupBy("department")
       .having("SUM(salary) > 50000");

apply：用于直接拼接 SQL 片段。

wrapper.apply("DATE_FORMAT(create_time, '%Y-%m-%d') = '2022-01-01'");

这些方法可以根据实际需要组合使用，动态地构建查询条件。

在 MyBatis-Plus 中，QueryWrapper 的使用使得动态条件查询变得更加方便和灵活。

关于该类的具体源码，由于比较多，我分析一个给大家看看，感兴趣的可以自已去看源码：

eq判断相等的函数：

该类继承了AbstractWrapper类：

找到AbstractWarpper类中重写的eq方法，对应其参数以及其怎么实现：（具体参数讲解可继续点击其addCondition）
查看其具体函数执行
columnToString函数是将属性转换为string属性
formatSql函数将val进行格式化
doIt函数判断condition条件为true，则执行sql片段的组装

3. Demo

大致相关的User类别以及Mapper需要进行创建

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.core.toolkit.Wrappers;

// Assuming you have a User entity with fields like id, name, age, email, etc.

public class UserQueryExample {

    public static void main(String[] args) {
        // Example: Constructing a dynamic query

        // Create a QueryWrapper instance
        QueryWrapper<User> wrapper = new QueryWrapper<>();

        // Basic conditions
        wrapper.eq("name", "John")
                .between("age", 25, 35)
                .like("email", "@domain.com");

        // Nested conditions using lambda
        wrapper.and(qw -> qw.gt("salary", 50000).or().lt("salary", 80000));

        // Order by
        wrapper.orderByAsc("age");

        // Applying additional conditions using apply
        wrapper.apply("DATE_FORMAT(create_time, '%Y-%m-%d') = '2022-01-01'");

        // Print the generated SQL
        System.out.println("Generated SQL: " + wrapper.getSqlSegment());

        // If you are using MyBatis-Plus mapper, you can directly use the wrapper in your query
        // For example, if you have a UserMapper, you can do something like:
        // List<User> userList = userMapper.selectList(wrapper);
    }
}