QueryWrapper.or使用时如何动态拼接多个或条件？

Question

在使用MyBatis-Plus的QueryWrapper时，如何动态拼接多个“或”条件是一个常见问题。例如，当需要根据用户输入的关键字，在多个字段中进行模糊查询时，传统的if判断会显得冗长且不易维护。那么，如何优雅地实现这一需求？ 可以通过`apply`方法结合`or`动态拼接SQL片段来解决。例如：先调用`query.or(i -> {...})`，在lambda中循环添加条件。但需注意，若条件为空则可能导致SQL语法错误，因此必须在拼接前检查条件是否有效。 此外，另一种方式是利用` Wrappers.query().or()`链式调用，适合条件数量不固定的情况。这种方式不仅代码简洁，还能确保只生成必要的SQL部分，提升性能与可读性。你更倾向于哪种实现呢？

Answer 1

1. 问题背景与分析

在使用MyBatis-Plus的QueryWrapper时，动态拼接多个“或”条件是一个常见的需求。例如，当需要根据用户输入的关键字，在多个字段中进行模糊查询时，传统的if判断会显得冗长且不易维护。

具体场景如下：

• 用户可能输入关键字用于匹配多个字段（如名称、描述等）。
• 关键字可能是空值或者无效值，这需要在SQL拼接前进行检查。
• 如果直接通过if判断实现，代码逻辑复杂且难以扩展。

因此，我们需要一种更优雅的方式来解决这一问题。

2. 解决方案探讨

以下是两种主流解决方案及其优缺点分析：

1. 使用apply方法结合or动态拼接SQL片段：

2. 这种方式允许我们通过lambda表达式灵活地构建SQL片段。以下是一个示例：

   
   QueryWrapper<Entity> query = new QueryWrapper<>();
   List<String> keywords = Arrays.asList("key1", "key2");
   keywords.forEach(keyword -> {
       if (StringUtils.isNotBlank(keyword)) {
           query.or(i -> i.like("field1", keyword).or().like("field2", keyword));
       }
   });
           

   优点：灵活性高，适合复杂的条件拼接。

   缺点：若不注意条件有效性检查，可能导致SQL语法错误。

3. 利用Wrappers.query().or()链式调用：

4. 这种方式更加简洁，适合条件数量不固定的情况。以下是另一个示例：

   
   QueryWrapper<Entity> query = Wrappers.query();
   keywords.stream()
          .filter(StringUtils::isNotBlank)
          .forEach(keyword -> query.or(i -> i.like("field1", keyword).or().like("field2", keyword)));
           

   优点：代码简洁，只生成必要的SQL部分，提升性能与可读性。

   缺点：对于极其复杂的条件，可能需要额外的封装逻辑。

3. 技术选型建议

从实际开发的角度来看，选择哪种方式取决于具体的需求和团队的技术栈偏好：

方案	适用场景	优点	缺点
apply方法结合or	复杂条件拼接，需要高度灵活性	灵活，支持自定义SQL片段	容易出错，需手动检查条件有效性
Wrappers.query().or()链式调用	简单条件拼接，条件数量不固定	简洁，只生成必要SQL	对复杂条件支持有限

4. 流程图展示

以下是基于上述两种方案的流程图对比：

graph TD;
            A[开始] --> B{是否使用apply};
            B --是--> C[apply方法];
            C --> D{条件是否有效?};
            D --否--> E[跳过];
            D --是--> F[拼接SQL];
            B --否--> G[Wrappers.query().or()];
            G --> H{条件是否为空?};
            H --是--> I[跳过];
            H --否--> J[链式拼接];