java-high-level-REST-client.pdf

elasticsearch7.10Java高级客户端（high-level）官方文档（英文）。 由官方文档导出的PDF格式的英文文档。high-level 是官方唯一在持续维护的java的elasticsearch客户端 Java 高级 REST 客户端是 Elasticsearch 7.10 版本的官方文档，主要面向使用 Java 开发的应用程序。这个客户端是官方唯一维护的 Java 接口，用于与 Elasticsearch 进行通信，提供了高级封装的 RESTful API 调用方式。 **兼容性** Java 高级 REST 客户端需要 Java 1.8 或以上版本，并依赖于 Elasticsearch 的核心项目。客户端的版本与开发时所对应的 Elasticsearch 版本相同。它接受与 TransportClient 相同的请求参数，并返回相同的响应对象。如果你需要将应用程序从 TransportClient 迁移到新的 REST 客户端，可以参考“迁移指南”部分。 高级客户端保证能够与运行在同一主版本且次要版本相等或更高的 Elasticsearch 节点进行通信。这意味着它是向前兼容的，支持与比其开发版本更晚的 Elasticsearch 版本通信。例如，6.0 客户端可以与任何 6.x 版本的 Elasticsearch 节点通信，而 6.1 客户端则肯定可以与 6.1、6.2 及更高 6.x 版本通信。但是，如果新版本客户端支持某些 API 请求体字段，而旧版本节点不识别，可能会出现不兼容问题，如 6.1 客户端与 6.0 节点之间的通信。 **升级策略** 当升级 Elasticsearch 集群到新主版本时，推荐升级 Java 高级 REST 客户端，因为 REST API 的破坏性变更可能导致请求命中不同版本节点时出现意外结果，而且新添加的 API 只有在较新版本的客户端中才被支持。升级过程中，客户端应作为最后一步更新，待集群中所有节点都升级到新主版本后再进行。 **Javadoc** REST 高级客户端的 Javadoc 文档可以在 {rest-high-level-client-javadoc}/index.html 找到，这里提供了详细的 API 文档，方便开发者查阅和使用。 **Maven 仓库** 如果你使用 Maven 进行项目管理，可以通过 Maven 仓库获取客户端库。高可用 REST 客户端的坐标在描述中未给出，通常会以类似于 `org.elasticsearch.client:elasticsearch-rest-high-level-client:<version>` 的形式存在，`<version>` 应替换为实际的 Elasticsearch 客户端版本号。 使用 Java 高级 REST 客户端，开发者可以方便地构建 Elasticsearch 查询、索引数据、执行聚合、管理索引以及进行其他操作，而无需关心底层 HTTP 协议的细节。客户端提供了丰富的异常处理机制，帮助开发者更好地处理与 Elasticsearch 交互过程中可能出现的问题。 Java 高级 REST 客户端是 Elasticsearch 集成到 Java 应用中的理想选择，它简化了与 Elasticsearch 服务器的通信，使得开发过程更加高效。为了确保最佳的兼容性和功能支持，建议始终保持客户端版本与 Elasticsearch 集群版本同步。