如何使用Hibernate Search 7构建动态查询？

在Hibernate Search 7中实现带可选字段的动态查询，核心是利用**布尔查询构建器（Boolean Predicate Builder）**逐步拼接条件，具体实现如下：

代码示例 #

searchSession.search(Entity.class)
    .where(entity -> {
        // 创建布尔查询构建器，默认以AND逻辑组合条件
        var booleanBuilder = entity.bool();
        
        // 可选字段1有值时，添加匹配条件
        if (fieldValue1Exists) {
            booleanBuilder.must(entity.match().field("fieldName1").matching(fieldValue1));
        }
        
        // 可选字段2有值时，添加匹配条件
        if (fieldValue2Exists) {
            booleanBuilder.must(entity.match().field("fieldName2").matching(fieldValue2));
        }
        
        // 返回构建完成的布尔查询
        return booleanBuilder;
    })
    .fetch(); // 执行查询获取结果

逻辑说明 #

• entity.bool() 创建的布尔构建器，默认用must（AND逻辑）组合条件，只有满足所有添加条件的文档才会被返回。
• 如果需要OR逻辑（满足任意一个条件即可），将must替换为should：

  booleanBuilder.should(entity.match().field("fieldName1").matching(fieldValue1));
  

• 若要排除特定条件，可使用mustNot方法。

额外提示 #

• 确保fieldValue1Exists这类判断逻辑准确（比如判断值不为null、非空字符串等），避免添加无效查询条件。
• 如果所有可选字段都未填写，布尔构建器会返回匹配所有文档的查询；若需这种场景返回空结果，可额外添加booleanBuilder.must(entity.matchAll().not())。

内容的提问来源于stack exchange，提问作者Jack Evans