【Elasticsearch入门到落地】10、初始化RestClient

接上篇《9、hotel数据结构分析

上一篇我们讲解了导入的宾馆数据库tb_hotel表结构的具体含义,并分析如何建立其索引库。本篇我们来正式进入链接Elasticsearch的Java代码的编写阶段,先进行RestClient的初始化。

RestClient的初始化分为三步,如下:

一、环境准备

1.引入依赖

首先需要在项目的pom.xml文件中添加Elasticsearch客户端依赖:

XML 复制代码
<dependency>
    <groupId>org.elasticsearch.client</groupId>
    <artifactId>elasticsearch-rest-high-level-client</artifactId>
</dependency>

由于SpringBoot默认集成的Elasticsearch版本可能与我们需要的不一致:

建议在<properties>中明确指定版本:

XML 复制代码
<properties>
    <java.version>1.8</java.version>
    <!-- 指定Elasticsearch版本为7.12.1 -->
    <elasticsearch.version>7.12.1</elasticsearch.version>
</properties>

二、初始化RestHighLevelClient

1.创建测试类

我们在src/test/java/cn/itcast/hotel下面新建一个测试文件HotelIndexTest.java:

然后我们在java类中,初始化RestHighLevelClient作为其成员变量:

java 复制代码
package cn.itcast.hotel;

public class HotelIndexTest {
    private RestHighLevelClient client;
}

这个对象为什么放在成员变量的位置,因为将来在这个类中我们需要写很多很多的单元测试,如果我在每一个单元测试中都对这个对象进行初始化,就会很麻烦,定义成员变量后就可以复用。

2.初始化方法

定义完成员变量后,我们要对其进行初始化,我们定义一个setUp方法:

java 复制代码
@BeforeEach
void setUp(){
   this.client = new RestHighLevelClient(RestClient.builder(
           HttpHost.create("http://192.168.2.129:9200") //如果有集群,可以设置多个
   ));
}

初始化的代码中,注解@BeforeEach表示在每个单元测试方法执行前运行,通过RestClient.builder()构建一个低级REST客户端,并传入ES节点的地址,然后使用低级客户端构造RestHighLevelClient对象,赋值给成员变量client。如果有集群,还可以设置多个HttpHost以提高容错性。

3.资源清理方法

然后我们还需要编写一个关闭客户端进行资源清理的代码:

java 复制代码
@AfterEach
void tearDown() throws IOException{
    this.client.close();
}

注解@AfterEach,表示在每个单元测试方法执行后运行。调用client.close()关闭客户端连接,释放资源。注意这个我们方法声明了IOException,因为关闭连接可能引发I/O异常。

三、验证初始化结果

最后我们编写一个测试方法,来打印一下client,看看我们初始化是否成功:

java 复制代码
@Test
void testInit(){
    System.out.println(client);
}

我们启动虚拟机中的docker服务,运行Elasticsearch的9200服务,然后在IDEA编辑器右键testInit()方法执行:

执行完毕后,如果显示绿色,证明我们client初始化成功:

四、常见问题排查

1. 连接失败问题

​●错误现象ConnectException或NoNodeAvailableException
​​●解决方案

(1)确认ES服务是否正常运行

(2)检查防火墙设置,确保9200端口可访问

(3)验证IP地址和端口配置是否正确

2. 版本不兼容问题

​​●错误现象UnsupportedOperationException或序列化错误
​​●解决方案

(1)确保客户端版本与ES服务版本一致

(2)检查elasticsearch.version是否被正确覆盖

3. 资源泄漏问题

​​●错误现象:测试运行后连接未释放
​​●解决方案:

(1)确保tearDown()方法被正确执行

(2)检查是否有未关闭的客户端实例

五、总结

本篇我们完成了RestHighLevelClient的初始化工作,关键要点包括:

1.正确配置Elasticsearch客户端依赖
2.使用@BeforeEach和@AfterEach管理客户端生命周期
3.验证客户端初始化结果
4.掌握常见问题的排查方法

通过规范的初始化流程,为后续的索引库操作奠定了坚实基础。下一篇我们将讲解如何使用RestClient创建索引库。

附:完整代码结构

src/test/java/cn/itcast/hotel/
└── HotelIndexTest.java

测试类完整代码:

java 复制代码
package cn.itcast.hotel;

import org.apache.http.HttpHost;
import org.elasticsearch.client.RestClient;
import org.elasticsearch.client.RestHighLevelClient;
import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;

import java.io.IOException;

public class HotelIndexTest {
    private RestHighLevelClient client;

    @BeforeEach
    void setUp() {
        this.client = new RestHighLevelClient(
            RestClient.builder(
                HttpHost.create("http://192.168.2.129:9200")
            )
        );
    }

    @AfterEach
    void tearDown() throws IOException {
        this.client.close();
    }

    @Test
    void testInit() {
        System.out.println(client);
    }
}

转载请注明出处:https://blog.csdn.net/acmman/article/details/146779179

相关推荐
怒放吧德德1 小时前
MySQL篇:MySQL如何实时同步到ES
mysql·elasticsearch·面试
细心的莽夫2 小时前
Elasticsearch复习笔记
java·大数据·spring boot·笔记·后端·elasticsearch·docker
码农周4 小时前
Elasticsearch 报错 Limit of total fields [1000] has been exceeded
大数据·elasticsearch
Elastic 中国社区官方博客5 小时前
Elasticsearch 堆内存使用情况和 JVM 垃圾回收
大数据·jvm·数据库·elasticsearch·搜索引擎·全文检索
道长没有道观6 小时前
ubuntu系统下部署使用git教程
git·ubuntu·elasticsearch
菜鸟、上路6 小时前
Elasticsearch 集群节点下线方案
大数据·elasticsearch
TracyCoder1239 小时前
ElasticSearch深入解析(二):核心概念
大数据·elasticsearch·搜索引擎
小橘快跑10 小时前
elasticsearch 查询检索
大数据·elasticsearch
白雪讲堂12 小时前
【白雪讲堂】GEO优化第7篇 -构建《推荐类》内容的结构化模板
大数据·人工智能·搜索引擎·geo
yangmf204012 小时前
私有知识库 Coco AI 实战(三):摄入 Elasticsearch 官方文档
人工智能·elasticsearch·搜索引擎·全文检索·coco ai