Mybatis plus链式调用

在日常使用 Mybatis Plus 进行数据访问层开发时，条件构造器 (QueryWrapper 和 LambdaQueryWrapper) 是我们构建动态 SQL 的得力助手。而链式调用（Chain Invocation）则是 Mybatis Plus 为这些构造器提供的一种极其优雅、可读性极高的编码风格，它能显著提升代码的简洁度和开发体验。

一、什么是链式调用

链式调用的核心思想在于：一个对象的方法在调用后，返回对象本身（通常是 this），使得后续的方法可以紧接着在前一个方法调用的结果上继续调用，形成一条连续的“链条”。

在 Mybatis Plus 的 QueryWrapper 和 LambdaQueryWrapper 中，绝大多数用于添加条件（如 eq, like, gt, orderBy 等）的方法都采用了这种设计。

二、传统方式 vs 链式调用

假设我们需要查询：状态为启用 (status=1)、姓名包含"张" (name like '%张%')、年龄大于 18 岁 (age > 18)，并按照创建时间倒序排列 (create_time DESC) 的用户。

1. 传统方式 (非链式)

QueryWrapper<User> queryWrapper = new QueryWrapper<>();
queryWrapper.eq("status", 1);
queryWrapper.like("name", "张");
queryWrapper.gt("age", 18);
queryWrapper.orderByDesc("create_time");

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

这种方式清晰但略显冗余，每次调用都需要重复 queryWrapper 对象名。

2. 链式调用方式

QueryWrapper<User> queryWrapper = new QueryWrapper<User>()
    .eq("status", 1)
    .like("name", "张")
    .gt("age", 18)
    .orderByDesc("create_time");

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

代码行数减少 所有条件按照逻辑顺序依次排列，避免了重复书写对象变量名

三、LambdaQueryWrapper

LambdaQueryWrapper 在 QueryWrapper 的基础上，利用 Java 的 Lambda 表达式和方法引用，彻底消除了条件字段名硬编码字符串，带来了编译期的类型安全检查

LambdaQueryWrapper<User> lambdaQueryWrapper = new LambdaQueryWrapper<User>()
    .eq(User::getStatus, 1)          // 使用 User::getStatus 方法引用
    .like(User::getName, "张")       // 编译时检查字段名正确性
    .gt(User::getAge, 18)            // 避免字段名拼写错误
    .orderByDesc(User::getCreateTime); // 重构友好

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

编译器会在你修改实体类属性名称时立即提示错误，避免运行时因字段名拼写错误导致的 SQL 异常, 也不会出现数据库表没有该字段的问题了

四、链式调用的常见方法