本章节基于Java API 6.3.x版本,为您介绍使用Java Rest Client连接阿里云Elasticsearch集群,并调用Elasticsearch Document API的方法。通过调用Document API,您可以在本地Java程序中完成创建文档、获取文档、更新文档等操作。

Elasticsearch的Client包括TransportClient和Java Rest Client,在Elasticsearch 7.0中已经弃用TransportClient,在8.0中完全删除它。因此在实际开发中建议您使用Java REST Client。Rest Client通过HTTP请求来执行操作,无需再序列化Java请求。

Java REST客户端有两种风格:
  • Java Low Level REST Client:Elasticsearch Client低级别客户端。它允许通过http请求与Elasticsearch集群进行通信。API本身不负责数据的编码解码,由用户去编码解码。它与所有的ElasticSearch版本兼容。
  • Java High Level REST Client(本章节以此为例):Elasticsearch Client官方高级客户端。基于低级客户端,主要目标是为了暴露各API特定的方法。Java High Level REST Client依赖于Elasticsearch核心项目,将Request对象作为参数,返回一个Response对象。所有API都可以同步或异步调用。
    • 同步调用方法立即返回一个Response对象。
    • 而异步调用方法(方法名以async结尾)依赖于监听,当有请求返回或是错误返回时,该监听会通知到对应的方法继续执行。
本章节基于Java API 6.3.x版本,并使用阿里云Elasticsearch 6.3版本的实例,为您介绍使用Java Rest Client连接阿里云Elasticsearch集群,并调用Elasticsearch Document API的方法。主要分为以下两个步骤。
  1. 创建并配置阿里云Elasticsearch集群:包括创建阿里云Elasticsearch实例、配置白名单、开启自动创建索引等操作。
  2. 调用Document API:包括连接Elasticsearch集群、创建文档、获取文档、更新文档、删除文档等操作。