Spring Data Elasticsearch 5.0.0 API查询构建最优方法咨询

你完全可以避免使用带下划线的_toQuery()内部方法，改用Elasticsearch Java Client提供的官方公开API来构建查询，既安全又符合规范，以下是两种简洁的实现方式：

方式一：先构建BoolQuery再转为Query接口 #

// 构建BoolQuery逻辑
BoolQuery boolQuery = QueryBuilders.bool()
    .must(QueryBuilders.matchQuery("your_field", "target_value"))
    .filter(QueryBuilders.termQuery("status", "active"))
    .build();

// 用官方API将BoolQuery转为Query接口实例
Query elasticsearchQuery = Query.of(q -> q.bool(boolQuery));

// 构建NativeQuery并执行查询
NativeQuery nativeQuery = new NativeQueryBuilder()
    .withQuery(elasticsearchQuery)
    .build();

elasticsearchTemplate.search(nativeQuery, YourTargetClass.class);

方式二：链式直接构建Query（更简洁） #

无需单独构建BoolQuery，直接通过Query.of()链式完成整个查询逻辑：

Query elasticsearchQuery = Query.of(q -> q.bool(b -> b
    .must(m -> m.match(mq -> mq.field("your_field").query("target_value")))
    .filter(f -> f.term(tq -> tq.field("status").value("active")))
));

NativeQuery nativeQuery = NativeQuery.builder()
    .query(elasticsearchQuery)
    .build();

elasticsearchTemplate.search(nativeQuery, YourTargetClass.class);

为什么不推荐_toQuery()？ #

带下划线前缀的方法通常是框架内部使用的非公开API，虽然当前是public，但后续版本可能会被修改、移除或限制访问，依赖它会导致代码兼容性风险，所以优先使用官方提供的Query.of()方法来转换查询类型。

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