在 elasticsearch 查询中处理空结果，核心做法是将 java api client 返回的 searchresponse 中的 hits().hits() 数组转换为 optional。具体操作是检查命中列表是否为空或长度为 0，若为空则返回 optional.empty()，否则取第一个命中文档并反序列化为目标对象后包装为 optional.of()。这样做的好处是调用方可以直接使用 ifpresent() 链式处理业务逻辑，避免显式的 null 检查。
SearchResponse 的命中结构如何映射到 Optional？
直接回答：通过访问 response.hits().hits() 获取命中数组，判断其长度即可确定是否存在数据。如果数组长度为 0，说明查询结果为空；如果大于 0，则提取第一个元素进行转换。
import co.elastic.clients.elasticsearch.ElasticsearchClient;
import co.elastic.clients.elasticsearch.core.SearchRequest;
import co.elastic.clients.elasticsearch.core.SearchResponse;
import co.elastic.clients.json.JsonData;
import java.io.IOException;
import java.util.Optional;
public class EsService {
private final ElasticsearchClient client;
public EsService(ElasticsearchClient client) {
this.client = client;
}
// 假设文档类
public static class Product {
public String id;
public String name;
}
public Optional<product> findFirstProduct(String keyword) throws IOException {
SearchRequest request = SearchRequest.of(s -> s
.index("products")
.query(q -> q.match(m -> m.field("name").query(keyword)))
.size(1)
);
SearchResponse<product> response = client.search(request, Product.class);
// 关键步骤：处理空结果
if (response.hits().total() == null || response.hits().total().value() == 0) {
return Optional.empty();
}
var hit = response.hits().hits().get(0);
if (hit.source() == null) {
return Optional.empty();
}
return Optional.of(hit.source());
}
}</product></product>
运行上述代码，当数据库中存在匹配关键词的产品时，返回 Optional[Product] 包含该对象；当不存在匹配项时，返回 Optional.empty()。注意 hits().total() 可能为 null（旧版本 ES），需做空值保护。
如何确保 Optional 转换过程中的类型安全？
直接回答：在将 Hit 转换为 Product 实例时，必须校验 hit.source() 是否为 null。Elasticsearch 允许存储不包含 source 字段的文档（如仅存元数据），此时 source() 返回 null，直接取值会导致 NullPointerException。因此，在构建 Optional.of() 前增加非空判断是保证类型安全的必要步骤。
// 补充验证逻辑的代码片段
var hit = response.hits().hits().get(0);
if (hit.source() == null) {
// 记录日志或返回空
System.out.println("Found hit but no source data");
return Optional.empty();
}
return Optional.of(hit.source());
此段代码展示了在获取到命中对象后，对 source() 字段进行的防御性编程。即使 hits() 不为空，单个命中的源数据仍可能缺失。这种处理方式确保了 Optional 内部包裹的对象始终是非空的，符合 Optional 的设计契约。
当查询条件包含分页参数时，如何处理第一页为空的情况？
直接回答：当查询包含分页参数（如 from 和 size）且请求的第一页没有数据时，API 依然会返回一个成功的 SearchResponse 对象，但其内部的 hits 数组为空。此时应复用前述的空值检查逻辑，即检查 response.hits().hits() 的长度或 response.hits().total().value() 是否为零。无论是否有分页，只要命中数为零，就应返回 Optional.empty()，而不是抛出异常或返回 null。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
