【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

相关推荐
mooyuan天天3 小时前
黑帽SEO之搜索引擎劫持-域名劫持原理分析
搜索引擎·seo搜索引擎劫持·seo域名劫持
上等猿14 小时前
Elasticsearch笔记
java·笔记·elasticsearch
qq_54702617919 小时前
Elasticsearch 评分机制
大数据·elasticsearch·jenkins
yangmf204020 小时前
私有知识库 Coco AI 实战(一):Linux 平台部署
大数据·linux·运维·人工智能·elasticsearch·搜索引擎·全文检索
Elastic 中国社区官方博客20 小时前
Elasticsearch:理解政府中的人工智能 - 应用、使用案例和实施
大数据·人工智能·elasticsearch·机器学习·搜索引擎·ai·全文检索
Elasticsearch1 天前
RAG vs. Fine Tuning ,一种实用方法
elasticsearch
Elasticsearch1 天前
了解可观察性指标:类型、黄金信号和最佳实践
elasticsearch
LaughingZhu1 天前
PH热榜 | 2025-03-30
前端·数据库·人工智能·经验分享·mysql·搜索引擎·产品运营
IT成长日记1 天前
Elasticsearch安全与权限控制指南
安全·elasticsearch
中工钱袋1 天前
SEO(搜索引擎优化)详解
搜索引擎