【MyBatis-Plus】深入解析 MP：UpdateWrapper、LambdaQueryWrapper 、LambdaUpdateWrapper 构造动态 SQL 和自定义 SQL 的方法及规范

条件构造器

UpdateWrapper

对于更新，我们也可以直接使用 UpdateWrapper，在不创建实体对象的情况下，直接设置更新字段和条件。

set( )

刚刚煮啵讲解了条件构造器 QueryWrapper，那怎么使用 UpdateWrapper构造更新语句呢？

两种更新方式的对比说明：

以下是简化后的对比表格，突出核心区别：

核心区别：UpdateWrapper通过内置的set()方法实现了条件构造和值更新的统一处理，避免了实体对象的创建。

基础更新：完成下述 SQL 查询。

UPDATE user_info SET delete_flag=0, age=5 WHERE id IN (1,2,3)

测试代码：

    @Test
    void testUpdateByUpdateWrapper(){
        UpdateWrapper updateWrapper = new UpdateWrapper();
        updateWrapper.set("delete_flag", 0).set("age",25)
                .in("id", List.of(1,2,3));
        userInfoMapper.update(updateWrapper);
    }

setSql( )

基于 SQL 更新：完成下述 SQL 查询。

UPDATE user_info SET age = age+10 WHERE id IN (1,2,3)

对于条件不是一个固定值，而是一个语句，就不能使用 set()，而是使用 setSql()

	@Test
    void testUpdateByUpdateWrapper(){
        UpdateWrapper updateWrapper = new UpdateWrapper();
        updateWrapper.setSql("age = age + 10")
                .in("id", List.of(1,2,3));
        userInfoMapper.update(updateWrapper);
    }

LambdaQueryWrapper

QueryWrapper 和 UpdateWrapper 存在一个问题，就是需要写死字段名；如果字段名发生变更，可能会因为测试不到位酿成事故。

MyBatis-Plus 提供了一种基于 Lambda 表达式的条件构造器，它通过 Lambda 表达式来引用实体类的属性，从而避免了硬编码字段名，也提高了代码的可读性和可维护性。

• LambdaQueryWrapper
• LambdaUpdateWrapper

  分别对应上述的 QueryWrapper 和 UpdateWrapper。

  ---

  接下来我们看下具体使用：

  SELECT id, username, password, age 
  FROM user_info 
  WHERE age = 18 AND username 
  LIKE "%min%"
  

  ---

  下列分别是QueryWrapper和LambdaQueryWrapper的 SQL 代码实现：

  

  ---

  

  ---

  通过日志，也可以看出来拼接的 SQL 是否正确：

  

  ---

  LambdaUpdateWrapper

  ---

  LambdaUpdateWrapper 用法和 LambdaQueryWrapper 相似。

      @Test
      void testLamdaUpdateByUpdateWrapper(){
          UpdateWrapper updateWrapper = new UpdateWrapper();
          updateWrapper.lambda()
                  .set(UserInfo::getDeleteFlag, 0)
                  .set(UserInfo::getAge, 5)
                  .in(UserInfo::getId, List.of(1,2,3));
          userInfoMapper.update(updateWrapper);
      }
  

  ---

  MyBatis-Plus Wrapper类对比表格

  ---

  以下是整理后的 MyBatis-Plus Wrapper 类对比表格：

  Wrapper 类名	继承关系	主要用途	核心特点	适用场景
  AbstractWrapper	所有 Wrapper 的基类	提供通用的条件构造方法	包含 eq(), ne(), gt(), lt() 等通用条件方法，支持链式调用	作为其他 Wrapper 的父类使用
  QueryWrapper	继承 AbstractWrapper	构造查询条件	新增 select() 方法可指定查询字段，支持 SQL 函数操作	需要动态构建查询条件的场景
  UpdateWrapper	继承 AbstractWrapper	构造更新条件	支持 set() 方法直接指定更新字段和值，可结合条件更新部分数据	需要条件更新的场景
  LambdaQueryWrapper	继承 AbstractWrapper	Lambda 表达式风格的查询构造器	通过 Lambda 方法引用(如 User::getName)避免字段名硬编码，编译期类型检查	需要类型安全且避免硬编码的场景
  LambdaUpdateWrapper	继承 AbstractWrapper	Lambda 表达式风格的更新构造器	结合 Lambda 表达式和 set() 方法，在避免字段名硬编码的同时构建更新条件	需要类型安全的条件更新场景

  补充说明：

  1. 所有 Wrapper 都支持链式调用（如 .eq().gt().orderBy()）
  2. Lambda 系 Wrapper 需基于实体类（如 new LambdaQueryWrapper()）
  3. 官网链接：条件构造器 | MyBatis-Plus

  接下来通过代码来看下如何使用。

  ---

  自定义 SQL

  ---

  在实际的开发中，MyBatis-Plus 提供的操作不能满足我们的实际需求，MyBatis-Plus 也提供了自定义 SQL 的功能，我们可以利用 Wrapper 构造查询条件，再结合 Mapper 编写 SQL。

  条件构造器 | MyBatis-Plus

  

  ---

  代码示例 1

  ---

  完成下述 SQL 查询。

  select id,username,password,age FRoM user_info WHERE username = "admin"
  

  ---

  Mapper：

  导入正确的 wrapper 包：

  

  ---

  ${} 虽然会有 SQL 注入的问题，但是 MyBatis-Plus 已经考虑到了这个问题并且解决了，所以这里我们可以正常使用 ${ew.customSqlSegment}

  

  ---

  package com.bit.mybatis.plus.mapper;
  import com.baomidou.mybatisplus.core.conditions.Wrapper;
  import com.baomidou.mybatisplus.core.mapper.BaseMapper;
  import com.baomidou.mybatisplus.core.toolkit.Constants;
  import com.bit.mybatis.plus.model.UserInfo;
  import org.apache.ibatis.annotations.Mapper;
  import org.apache.ibatis.annotations.Param;
  import org.apache.ibatis.annotations.Select;
  import java.util.List;
  @Mapper
  public interface UserInfoMapper extends BaseMapper {
      @Select("select id,username,password,age from user_info ${ew.customSqlSegment}")
      List selectUserInfoByCondition(@Param(Constants.WRAPPER) Wrapper queryWrapper);
  }
  

  ---

  测试代码：

      @Test
      void selectUserInfoByCondition() {
          QueryWrapper queryWrapper = new QueryWrapper();
          queryWrapper.lt("age",20);
          userInfoMapper.selectUserInfoByCondition(queryWrapper).forEach(System.out::println);
      }
  

  

  ---

  

  ---

  观察打印日志：

  

  ---

  代码示例 2

  ---

  完成下述 SQL 查询。

  UPDATE user_info SET age = age+10 WHERE id IN (1,2,3)
  

  ---

  Mapper：

  

  ---

  

  ---

  

  ---

  测试代码：

  

  ---

  观察打印日志：

  

  ---

  代码示例 3

  ---

  MyBatis-Plus 在 MyBatis 的基础上只做增强不做改变，所以也支持 XML 的实现方式。上述功能也可以使用 XML 的方式完成：

  配置 mapper 路径

  mybatis-plus:
    mapper-locations: "classpath*:/mapper/**.xml" # Mapper.xml
  

  

  ---

  定义方法

  创建并初始化 XML 文件

  

  ---

  

  ---

  编写 XML

  
  
      
          select id,username,password,age FROM user_info ${ew.customSqlSegment}
      
  
  

  ---

  测试

  

  ---

  查看打印日志

  

  ---

  总结

  ---

  • MyBatis-Plus 是 MyBatis 的增强工具，在 MyBatis 的基础上只做增强不做改变，可以用更少的代码实现数据库表的 CRUD，让我们的开发变得更加简单。
  • MyBatis-Plus 支持自定义 SQL，版本不低于 3.0.7，传递 Wrapper 对象作为参数时，参数名必须为 ew，在 SQL 语句中，使用 ${ew.customSqlSegment} 来引用 Wrapper 对象生成的 SQL 片段。

    ---