如何用ElasticSearch Java API构建含可变数量match()子句的查询

问题场景 #

需要基于以下三个字段的任意组合检索文档：

• canonicalForm
• grammar
• meaning

当前实现仅在三个字段值全部提供时有效，若仅提供1个或2个字段值：

• 将未使用字段设为null会抛出异常
• 设为空字符串则始终返回0条结果

需求：仅在字段值非空时，向查询中添加对应的match()子句。

当前无效实现 #

String canonicalForm = "tut";
String grammar = "verb";
String meaning = "to land";

BoolQuery bool = BoolQuery.of(q -> q
            .must(m -> m
                .match(mt -> mt
                    .field("descr.canonicalForm")
                        .query(canonicalForm)
                    )
            )
            .must(m -> m
                .match(mt -> mt
                    .field("descr.grammar")
                        .query(grammar)
                    )
            )
            .must(m -> m
                .match(mt -> mt
                    .field("descr.meaning")
                        .query(meaning)
                    )
            )
        );

解决方案 #

通过分步构建BoolQuery.Builder实例，动态添加有效字段的查询条件，避免链式调用的局限性。

基础实现方案 #

String canonicalForm = "tut";
String grammar = "verb";
String meaning = ""; // 示例：仅提供两个有效字段值

// 初始化BoolQuery构建器
BoolQuery.Builder boolBuilder = BoolQuery.builder();

// 仅当canonicalForm非空时添加查询条件
if (canonicalForm != null && !canonicalForm.isEmpty()) {
    boolBuilder.must(match -> match
        .field("descr.canonicalForm")
        .query(canonicalForm)
    );
}

// 仅当grammar非空时添加查询条件
if (grammar != null && !grammar.isEmpty()) {
    boolBuilder.must(match -> match
        .field("descr.grammar")
        .query(grammar)
    );
}

// 仅当meaning非空时添加查询条件
if (meaning != null && !meaning.isEmpty()) {
    boolBuilder.must(match -> match
        .field("descr.meaning")
        .query(meaning)
    );
}

// 构建最终的BoolQuery对象
BoolQuery bool = boolBuilder.build();

优化实现（提取公共方法） #

为避免重复的非空判断逻辑，可提取公共方法简化代码：

// 公共方法：仅当值非空时向构建器添加match查询
private void addMatchClauseIfValid(BoolQuery.Builder builder, String fieldName, String fieldValue) {
    if (fieldValue != null && !fieldValue.isEmpty()) {
        builder.must(match -> match.field(fieldName).query(fieldValue));
    }
}

// 使用示例
String canonicalForm = "tut";
String grammar = "";
String meaning = "to land";

BoolQuery.Builder boolBuilder = BoolQuery.builder();
addMatchClauseIfValid(boolBuilder, "descr.canonicalForm", canonicalForm);
addMatchClauseIfValid(boolBuilder, "descr.grammar", grammar);
addMatchClauseIfValid(boolBuilder, "descr.meaning", meaning);

BoolQuery bool = boolBuilder.build();

原理说明 #

• 先创建BoolQuery.Builder实例，而非直接链式调用BoolQuery.of()，从而获得动态修改查询条件的灵活性。
• 对每个字段值进行非空+非空字符串的双重校验，确保只有有效参数才会被加入查询。
• 最终通过build()方法生成仅包含有效条件的查询对象，完美适配多字段任意组合的检索需求。

内容的提问来源于stack exchange，提问作者Alain Désilets