如何使用Java Hibernate Search Query DSL实现适配Elasticsearch的XOR运算符

解决方案 #

问题根因

你原有代码存在逻辑错误：直接在根boolClausesAppender上调用must/mustNot，会把这部分条件直接追加到根布尔查询中，而非作为should的子查询生效，完全不符合异或逻辑的预期。

正确实现（无需maximumShouldMatch方法）

你需要构造的两个should子句本身是天然互斥的：第一个子句要求「第一个条件成立、第二个不成立」，第二个子句要求「第二个条件成立、第一个不成立」，二者不可能同时匹配，因此完全不需要maximumShouldMatchNumber方法，仅需设置minimumShouldMatchNumber(1)即可实现异或需求（恰好满足其中一个条件，天然禁止两个条件同时成立）。

正确代码示例（基于Hibernate Search 6+）：

import org.hibernate.search.engine.search.predicate.dsl.BooleanPredicateClausesStep;
import org.hibernate.search.engine.search.predicate.dsl.PredicateFactory;
import org.hibernate.search.engine.search.predicate.SearchPredicate;

private void applyXorOperator(BooleanPredicateClausesStep<?> boolClausesAppender,
                              PredicateFactory predicateFactory,
                              SearchPredicate firstBool,
                              SearchPredicate secondBool) {
    // 子查询1：满足第一个条件，不满足第二个
    boolClausesAppender.should(predicateFactory.bool(b -> {
        b.must(firstBool);
        b.mustNot(secondBool);
    }));
    // 子查询2：满足第二个条件，不满足第一个
    boolClausesAppender.should(predicateFactory.bool(b -> {
        b.must(secondBool);
        b.mustNot(firstBool);
    }));
    // 两个子查询天然互斥，最多匹配1个，要求至少匹配1个即可实现XOR逻辑
    boolClausesAppender.minimumShouldMatchNumber(1);
}

变种需求（仅禁止同时满足，允许都不满足）

如果你不需要强制要求必须满足其中一个，仅需要禁止两个条件同时成立，实现更简单：

private void applyNotBothOperator(BooleanPredicateClausesStep<?> boolClausesAppender,
                                  PredicateFactory predicateFactory,
                                  SearchPredicate firstBool,
                                  SearchPredicate secondBool) {
    // 直接排除两个条件同时成立的场景
    boolClausesAppender.mustNot(predicateFactory.bool(b -> {
        b.must(firstBool);
        b.must(secondBool);
    }));
}

内容的提问来源于stack exchange，提问作者François F.