ElasticsearchClient入门指南

在本教程中,我们将探讨如何使用Elasticsearch的官方Java客户端 - ElasticsearchClient。这个强大的工具允许您的Java应用程序与Elasticsearch集群进行交互,执行各种操作,如索引文档、执行搜索查询等。

前提条件

在开始之前,确保您的项目中已经包含了必要的依赖。您可以通过Maven添加以下依赖:

xml 复制代码
<dependency>
    <groupId>co.elastic.clients</groupId>
    <artifactId>elasticsearch-java</artifactId>
    <version>8.10.0</version>
</dependency>
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.12.3</version>
</dependency>

创建ElasticsearchClient

首先,我们需要创建一个ElasticsearchClient实例。这涉及几个步骤:

  1. 创建一个RestClient实例
  2. 使用RestClient创建一个ElasticsearchTransport实例
  3. 使用transport创建ElasticsearchClient实例

以下是代码示例:

java 复制代码
import co.elastic.clients.elasticsearch.ElasticsearchClient;
import co.elastic.clients.json.jackson.JacksonJsonpMapper;
import co.elastic.clients.transport.ElasticsearchTransport;
import co.elastic.clients.transport.rest_client.RestClientTransport;
import org.apache.http.HttpHost;
import org.elasticsearch.client.RestClient;

// 创建低级客户端
RestClient restClient = RestClient.builder(
    new HttpHost("localhost", 9200)).build();

// 创建传输层
ElasticsearchTransport transport = new RestClientTransport(
    restClient, new JacksonJsonpMapper());

// 创建API客户端
ElasticsearchClient client = new ElasticsearchClient(transport);

执行搜索查询

现在我们有了ElasticsearchClient实例,让我们执行一个简单的搜索查询:

java 复制代码
import co.elastic.clients.elasticsearch._types.query_dsl.MatchQuery;
import co.elastic.clients.elasticsearch.core.SearchResponse;

try {
    // 执行搜索请求
    SearchResponse<Object> response = client.search(s -> s
        .index("my-index")
        .query(q -> q
            .match(new MatchQuery.Builder()
                .field("title")
                .query("elasticsearch")
                .build()
            )
        ),
        Object.class
    );

    // 处理响应
    long totalHits = response.hits().total().value();
    System.out.println("Total hits: " + totalHits);

    // 遍历搜索结果
    response.hits().hits().forEach(hit -> {
        System.out.println("Found document: " + hit.source());
    });

} catch (IOException e) {
    e.printStackTrace();
}

这个例子展示了如何:

  1. 构建一个match查询,搜索标题字段中包含"elasticsearch"的文档
  2. 执行搜索请求
  3. 获取总命中数
  4. 遍历并打印搜索结果

关闭客户端

最后,当您完成所有操作后,别忘了关闭客户端:

java 复制代码
try {
    restClient.close();
} catch (IOException e) {
    e.printStackTrace();
}

结论

本教程介绍了ElasticsearchClient的基本用法。我们学习了如何创建客户端、执行搜索查询和处理结果。ElasticsearchClient提供了丰富的API,允许您执行各种复杂的操作。随着您对Elasticsearch的深入了解,您将能够利用这个客户端执行更高级的查询和操作。

记住,这只是一个起点。Elasticsearch提供了大量的功能,包括聚合、地理空间查询、文档更新等。继续探索官方文档,以充分利用Elasticsearch的强大功能!

相关推荐
一心0925 小时前
ubuntu 20.04.6 sudo 源码包在线升级到1.9.17p1
运维·ubuntu·sudo·漏洞升级
好好学习啊天天向上5 小时前
世上最全:ubuntu 上及天河超算上源码编译llvm遇到的坑,cmake,ninja完整过程
linux·运维·ubuntu·自动性能优化
你想考研啊6 小时前
三、jenkins使用tomcat部署项目
运维·tomcat·jenkins
代码老y6 小时前
Docker:容器化技术的基石与实践指南
运维·docker·容器
典学长编程7 小时前
Linux操作系统从入门到精通!第二天(命令行)
linux·运维·chrome
你想考研啊9 小时前
四、jenkins自动构建和设置邮箱
运维·jenkins
Code blocks9 小时前
使用Jenkins完成springboot项目快速更新
java·运维·spring boot·后端·jenkins
饥饿的半导体10 小时前
Linux快速入门
linux·运维
还是奇怪12 小时前
Linux - 安全排查 2
linux·运维·安全
牛奶咖啡1313 小时前
Linux系统的常用操作命令——文件远程传输、文件编辑、软件安装的四种方式
运维·服务器·软件安装·linux云计算·scp文件远程传输·vi文件编辑·设置yum的阿里云源