MyBatis-Plus 中 nested() 与 and() 方法详解(最佳实践场景)

 更新时间:2025年07月03日 15:57:15   作者:千层冷面  
在MyBatis-Plus的条件构造器中,nested()和and()都是用于构建复杂查询条件的关键方法,但它们在功能和使用场景上有显著差异,本文给大家介绍MyBatis-Plus中nested()与and()方法,感兴趣的朋友一起看看吧

MyBatis-Plus 中nested()与and()方法详解

在 MyBatis-Plus 的条件构造器中,nested()and() 都是用于构建复杂查询条件的关键方法,但它们在功能和使用场景上有显著差异。

一、核心区别对比

特性and()nested()
主要用途连接多个条件(默认AND)创建嵌套查询条件
括号生成❌ 不生成括号✅ 自动生成括号包裹内部条件
逻辑关系与外部条件默认AND连接可作为独立逻辑单元
复杂查询支持有限,适合简单条件组合强大,支持任意层级嵌套
OR 条件处理需要显式使用or()天然支持OR条件嵌套
SQL 表现平铺条件生成带括号的子表达式

二、方法详解

1.and()方法

  • 功能:连接多个查询条件,默认使用 AND 逻辑
  • 特点
    • 不会生成括号
    • 适用于简单的条件组合
    • 当需要 OR 逻辑时需显式调用 or()
使用示例:
// 查询年龄大于18且姓张的用户
QueryWrapper<User> wrapper = new QueryWrapper<>();
wrapper.gt("age", 18)
       .and(wq -> wq.like("name", "张"));

生成 SQL

WHERE age > 18 AND name LIKE '%张%'

2.nested()方法

  • 功能:创建嵌套查询条件(自动添加括号)
  • 特点
    • 自动生成括号包裹内部条件
    • 支持任意层级的复杂嵌套
    • 特别适合处理 OR 逻辑组合
    • 使SQL逻辑更清晰
使用示例:
// 查询(年龄>30 或 工资>10000) 且 状态为激活的用户
QueryWrapper<User> wrapper = new QueryWrapper<>();
wrapper.nested(nq -> 
        nq.gt("age", 30).or().gt("salary", 10000))
    .eq("status", 1);

生成 SQL

WHERE (age > 30 OR salary > 10000) AND status = 1

三、高级用法对比

1. 复杂 OR 条件处理

使用 and() 实现:

wrapper.and(wq -> wq.gt("age", 30).or().gt("salary", 10000))
       .eq("status", 1);
-- 逻辑错误!实际生成:
WHERE (age > 30 OR salary > 10000 AND status = 1)
-- 正确应使用括号包裹OR条件

使用 nested() 实现:

wrapper.nested(nq -> nq.gt("age", 30).or().gt("salary", 10000))
       .eq("status", 1);
-- 正确生成:
WHERE (age > 30 OR salary > 10000) AND status = 1

2. 多层级嵌套

nested() 支持无限嵌套:

wrapper.nested(nq1 -> 
    nq1.eq("type", 1)
       .nested(nq2 -> 
           nq2.lt("age", 20).or().gt("age", 60))
    )
    .like("name", "张");

生成 SQL

WHERE (type = 1 AND (age < 20 OR age > 60)) 
AND name LIKE '%张%'

四、最佳实践场景

使用and()当:

  1. 构建简单的 AND 条件组合
  2. 不需要改变条件优先级
  3. 查询条件逻辑简单平铺

使用nested()当:

  1. 需要处理 OR 条件组合
  2. 需要改变条件运算优先级
  3. 构建复杂嵌套查询
  4. 需要清晰分隔逻辑单元
  5. 处理多条件分支逻辑

混合使用示例:

wrapper.eq("dept_id", 10)
       .nested(nq -> 
           nq.like("name", "张")
             .or()
             .nested(nq2 -> 
                 nq2.gt("salary", 10000).lt("age", 40))
       );

生成 SQL

WHERE dept_id = 10 
AND (name LIKE '%张%' OR (salary > 10000 AND age < 40))

五、原理分析

1.and()实现原理

public Children and(Consumer<Param> consumer) {
    return addNestedCondition(true, consumer);
}
  • 内部调用 addNestedCondition
  • 参数 true 表示使用 AND 连接
  • 不添加括号

2.nested()实现原理

public Children nested(Consumer<Param> consumer) {
    return addNestedCondition(false, consumer);
}
  • 参数 false 表示不指定连接类型
  • 自动添加括号包裹表达式
  • 可作为独立逻辑单元嵌入

六、常见误区

  1. 错误认为 and() 会加括号

    • ✅ 只有 nested() 会生成括号
  2. 在 OR 条件中错误使用 and()

    // 错误:OR条件未正确包裹
    wrapper.eq("a", 1)
           .or()
           .and(wq -> wq.eq("b", 2).eq("c", 3));
    // 正确:使用nested
    wrapper.eq("a", 1)
           .or()
           .nested(nq -> nq.eq("b", 2).eq("c", 3));
  3. 忽略条件优先级

    // 错误:AND/OR优先级问题
    wrapper.eq("status", 1)
           .or()
           .eq("deleted", 0)
           .eq("name", "test");
    // 正确:使用nested明确优先级
    wrapper.nested(nq -> nq.eq("status", 1).or().eq("deleted", 0))
           .eq("name", "test");

七、性能考虑

  1. 数据库优化

    • 嵌套条件可能影响查询优化器的工作
    • 避免超过3层嵌套(影响可读性和性能)
  2. 索引利用

    // 好的实践:索引列前置
    wrapper.nested(nq -> 
        nq.eq("indexed_column1", val1)  // 索引列
           .or()
           .eq("indexed_column2", val2) // 索引列
    );
    // 避免:非索引列前置
    wrapper.nested(nq -> 
        nq.eq("non_indexed", val)      // 非索引列
           .or()
           .eq("indexed_column", val)   // 索引列
    );

总结

场景推荐方法
简单AND条件组合and()
OR条件组合nested()
改变条件优先级nested()
多层级复杂查询nested()
逻辑单元清晰分隔nested()

经验法则

当需要括号来明确查询逻辑时,总是使用 nested()
当只是简单添加AND条件时,使用 and()

正确使用这两个方法可以使你的MyBatis-Plus查询:

  1. 逻辑更清晰
  2. 优先级更明确
  3. 更易维护
  4. 充分利用数据库优化能力
  5. 避免难以调试的逻辑错误

到此这篇关于MyBatis-Plus 中 nested() 与 and() 方法详解的文章就介绍到这了,更多相关MyBatis-Plus nested() 与 and() 内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • java中UUID生成工具类(UUIDUtils)方法详解

    java中UUID生成工具类(UUIDUtils)方法详解

    这篇文章主要介绍了java中UUID生成工具类(UUIDUtils)的相关资料,UUIDUtils工具类是用于生成和处理UUID的工具类,支持生成标准UUID、去掉连字符的UUID、基于命名空间的UUID、UUID校验和格式化等操作,需要的朋友可以参考下
    2025-05-05
  • SpringBoot LocalDateTime格式转换方案详解(前端入参)

    SpringBoot LocalDateTime格式转换方案详解(前端入参)

    这篇文章主要介绍了SpringBoot LocalDateTime格式转换(前端入参),本文用示例介绍SpringBoot全局格式配置,将前端传过来的时间自动转化为LocalDateTime,需要的朋友可以参考下
    2023-04-04
  • java实现微信扫码登录第三方网站功能(原理和代码)

    java实现微信扫码登录第三方网站功能(原理和代码)

    为避免繁琐的注册登陆,很多平台和网站都会实现三方登陆的功能,增强用户的粘性。这篇文章主要介绍了java实现微信扫码登录第三方网站功能(原理和代码),避免做微信登录开发的朋友们少走弯路
    2022-12-12
  • MyBatis-Plus 主键生成策略的几种实现方式

    MyBatis-Plus 主键生成策略的几种实现方式

    主键生成策略是指在数据库中为每条记录生成唯一标识符的方法,本文就来介绍一下MyBatis-Plus 主键生成策略的实现,具有一定的参考价值,感兴趣的可以了解一下
    2024-05-05
  • Java超过long类型的数据表示方法

    Java超过long类型的数据表示方法

    这篇文章主要给大家介绍Java超过long类型的数据如何表示,在 Java 中,如果需要表示超过 long 类型范围的数据,可以使用 BigInteger 类,BigInteger 是 Java 提供的一个用于处理任意精度整数的类,它可以表示非常大或非常小的整数,需要的朋友可以参考下
    2023-09-09
  • java获取properties属性文件示例

    java获取properties属性文件示例

    Properties类表示了一个持久的属性集。Properties可保存在流中或从流中加载。属性列表中每个键及其对应值都是一个字符串。本文使用java读取这些属性,看下面详细介绍吧
    2014-01-01
  • @scope("prototype") @loadbalanced注解负载均衡失效问题

    @scope("prototype") @loadbalanced注解负载均衡失效问题

    这篇文章主要为大家介绍了@scope("prototype") @loadbalanced注解负载均衡失效问题解决,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-02-02
  • java出现no XXX in java.library.path的解决及eclipse配置方式

    java出现no XXX in java.library.path的解决及eclipse配

    这篇文章主要介绍了java出现no XXX in java.library.path的解决及eclipse配置方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-12-12
  • SpringBoot中属性赋值操作的实现

    SpringBoot中属性赋值操作的实现

    这篇文章主要介绍了SpringBoot中属性赋值操作的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-10-10
  • Spring AOP的概念与实现过程详解

    Spring AOP的概念与实现过程详解

    AOP为Aspect Oriented Programming的缩写,意为:面向切面编程,可通过运行期动态代理实现程序功能的统一维护的一种技术。AOP是 Spring框架中的一个重要内容
    2023-02-02

最新评论