Elasticsearch——Java API 概述

拼搏现实的明天。 2024-03-27 18:54 75阅读 0赞

#### 目录 ####

*  Elasticsearch Java API
 *   *  1、直接使用HTTP请求
     *  2、Low Level REST Client
     *  3、Java High Level REST Client
     *  4、TransportClient
     *  5、Java API Client

## Elasticsearch Java API ##

Java 操作 Es 的方案有如下几种，根据Elasticsearch版本的不同要选择对应的客户端。

### 1、直接使用HTTP请求 ###

Elasticsearch提供Rest API，所以可以直接直接使用 HTTP 请求，去操作 Es。HTTP 请求工具，可以使用 Java 自带的 HttpUrlConnection，也可以使用一些 HTTP 请求库，例如 HttpClient、OKHttp、Spring 中的 RestTemplate 都可以。这种方式有一个弊端，就是要自己组装请求参数，自己去解析响应的 JSON。

### 2、Low Level REST Client ###

Elasticsearch Client低级别客户端。它允许通过HTTP请求与Elasticsearch集群进行通信。API本身不负责数据的编码解码，由用户去编码解码。它与所有的Elasticsearch版本兼容。这种方式好处就是兼容所有的 Es 版本。但是就是数据处理比较麻烦。

### 3、Java High Level REST Client ###

Elasticsearch Client官方高级客户端。基于低级客户端，主要目标是为了暴露各API特定的方法。Java High Level REST Client依赖于Elasticsearch核心项目，将Request对象作为参数，返回一个Response对象。所有API都可以同步或异步调用。

*  同步调用方法立即返回一个Response对象。
 *  而异步调用方法（方法名以async结尾）依赖于监听，当有请求返回或是错误返回时，该监听会通知到对应的方法继续执行。

> 注意：这种方式，所使用的依赖库的版本要和 Es 对应。

### 4、TransportClient ###

Transport Client随着Elasticsearch的第一个版本诞生，是一个特别的客户端。特别之处在于，它使用TCP协议与Elasticsearch通信，这也造成了当客户端与不同版本的Elasticsearch通信时，会存在兼容性问题。

Elasticsearch 7.0中已经弃用Transport Client，在8.0中完全移除它。

### 5、Java API Client ###

Elasticsearch在7.17版本之前使用的Java客户端是Java REST Client，从7.17版本开始Elastic官方将Java REST Client标记为弃用（deprecated），并推荐使用新版Java客户端Java API Client。

Java API Client是一个用于与Elasticsearch服务器进行通信的Java客户端库，帮助开发人员与Elasticsearch服务器进行通信，开发人员可以更加轻松地开发和维护代码。

Java API Client主要包含三个部分：

*  ElasticsearchClient类：Java API Client的核心类，提供与Elasticsearch服务器进行通信的方法。该类封装了底层的Transport通信，并提供了同步和异步调用、流式和函数式调用等方法。
 *  JSON object mapper：处理数据序列化和反序列化的库。JSON object mapper与Jackson无缝集成，可以将Java对象映射到JSON格式。
 *  通用能力：提供了连接池、重试、JSON序列化等通用能力，提高了代码的可读性和可维护性，便于开发人员进行开发。