当前位置：首页 > 文章列表 > 文章 > java教程 > Java连接ES教程：RestHighLevelClient使用指南

Java连接ES教程：RestHighLevelClient使用指南

2025-08-06 18:36:43 0浏览收藏

想要在Java应用中连接Elasticsearch进行搜索和日志分析？本文详细介绍了如何使用Java RestHighLevelClient客户端连接ES，并进行数据插入、查询和搜索等常见操作。即使RestHighLevelClient已被官方标记为过时，但由于其在老项目中的广泛应用，掌握其使用方法仍然重要。本文将指导你如何通过Maven添加依赖，创建客户端实例（建议单例模式），并展示了使用IndexRequest、GetRequest和SearchRequest进行数据操作的示例代码。同时，文章还强调了版本匹配、资源关闭、异常处理和安全认证配置等关键注意事项，助你避免常见问题，高效稳定地使用Java连接Elasticsearch。

如何使用Java中的RestHighLevelClient连接Elasticsearch？1.添加Maven依赖，引入elasticsearch-rest-high-level和elasticsearch对应版本；2.创建客户端实例，指定ES地址或集群节点，并建议单例使用；3.执行插入数据、查询数据、搜索数据等操作；4.注意版本匹配、资源关闭、异常处理及安全认证配置。

如何使用Java连接ES？RestHighLevelClient

连接Elasticsearch（ES）是Java应用中常见的需求，特别是在做搜索、日志分析等场景。如果你用的是较老版本的ES（比如6.x或7.x），可能还会接触到一个叫 RestHighLevelClient 的客户端。

虽然现在官方已经不推荐使用这个客户端了（建议用新的 Java API Client），但很多老项目还在用它，所以还是有必要了解怎么用。

下面简单说说怎么在Java里用 RestHighLevelClient 连接ES。

添加Maven依赖

要使用这个客户端，首先得引入对应的依赖。一般项目都是用 Maven 或 Gradle 管理依赖，这里以 Maven 为例：

<dependency>
    <groupId>org.elasticsearch.client</groupId>
    <artifactId>elasticsearch-rest-high-level</artifactId>
    <version>7.17.0</version> <!-- 版本号要和你的ES版本匹配 -->
</dependency>

<dependency>
    <groupId>org.elasticsearch</groupId>
    <artifactId>elasticsearch</artifactId>
    <version>7.17.0</version>
</dependency>

注意：版本号一定要跟你用的 ES 版本一致，不然容易出兼容性问题。

创建客户端实例

创建 RestHighLevelClient 实例时，需要指定 ES 的地址，通常是通过 HTTP 方式连接。

RestHighLevelClient client = new RestHighLevelClient(
    RestClient.builder(
        new HttpHost("localhost", 9200, "http")
    )
);

如果是集群部署，可以加多个节点：

RestClient.builder(
    new HttpHost("host1", 9200, "http"),
    new HttpHost("host2", 9200, "http")
)

建议把这个 client 做成单例，不要每次请求都新建。
使用完之后记得关闭，避免资源泄露。

常见操作示例

插入数据

可以用 IndexRequest 来插入一条记录：

IndexRequest request = new IndexRequest("my_index");
request.id("1"); // 可选，如果不指定会自动生成
request.source(Map.of("name", "张三", "age", 25), XContentType.JSON);

client.index(request, RequestOptions.DEFAULT);

查询数据

使用 GetRequest 获取某条记录：

GetRequest getRequest = new GetRequest("my_index", "1");
GetResponse response = client.get(getRequest, RequestOptions.DEFAULT);

if (response.isExists()) {
    Map<String, Object> source = response.getSource();
    System.out.println(source); // 输出：{name=张三, age=25}
}

搜索数据

可以用 SearchRequest 加上 SearchSourceBuilder 构建查询条件，比如按字段匹配：

SearchRequest searchRequest = new SearchRequest("my_index");
SearchSourceBuilder sourceBuilder = new SearchSourceBuilder();
MatchQueryBuilder matchQuery = QueryBuilders.matchQuery("name", "张三");

sourceBuilder.query(matchQuery);
searchRequest.source(sourceBuilder);

SearchResponse response = client.search(searchRequest, RequestOptions.DEFAULT);

这些只是基本操作，实际开发中还要处理异常、分页、聚合等等。