摘要：入門本節描述從獲取工件到在應用程序中使用它如何開始使用高級別客戶端。保證能夠與運行在相同主版本和大于或等于的次要版本上的任何節點通信。與具有相同的發布周期，將版本替換為想要的客戶端版本。

本節描述從獲取工件到在應用程序中使用它如何開始使用高級別REST客戶端。

Java High Level REST Client需要Java 1.8，并依賴于Elasticsearch核心項目，客戶端版本與客戶端開發的Elasticsearch版本相同，它接受與TransportClient相同的請求參數，并返回相同的響應對象，如果需要將應用程序從TransportClient遷移到新的REST客戶端，請參閱遷移指南。

High Level Client保證能夠與運行在相同主版本和大于或等于的次要版本上的任何Elasticsearch節點通信。當它與Elasticsearch節點通信時，它不需要在同一個次要版本中，因為它是向前兼容的，這意味著它支持與Elasticsearch的更高的版本進行通信，而不是與其開發的版本進行通信。

6.0客戶端能夠與任何6.x Elasticsearch節點通信，而6.1客戶端肯定能夠與6.1，6.2和任何更高版本的6.x版本通信，但是，如果6.1客戶端支持6.0節點不知道的某些API的新請求主體字段，則在與先前的Elasticsearch節點版本通信時可能存在不兼容問題，例如在6.1和6.0之間。

建議在將Elasticsearch集群升級到新的主要版本時升級High Level Client，因為REST API重要更改可能會導致意外結果，具體取決于請求命中的節點，并且只有較新版本的客戶端才支持新添加的API，一旦集群中的所有節點都升級到新的主版本，客戶端應該總是在最后更新。

可以在https://artifacts.elastic.co/javadoc/org/elasticsearch/client/elasticsearch-rest-high-level-client/6.4.2/index.html找到REST高級別客戶端的javadoc。

高級別Java REST客戶端托管在Maven Central上，所需的最低Java版本為1.8。

High Level REST Client與Elasticsearch具有相同的發布周期，將版本替換為想要的客戶端版本。

如果你正在尋找SNAPSHOT版本，可以通過https://snapshots.elastic.co/maven/獲取Elastic Maven Snapshot倉庫。

以下是如何使用maven作為依賴關系管理器來配置依賴關系，將以下內容添加到pom.xml文件中

    org.elasticsearch.client
    elasticsearch-rest-high-level-client
    6.4.2

以下是使用gradle作為依賴關系管理器配置依賴關系的方法，將以下內容添加到build.gradle文件中：

dependencies {
    compile "org.elasticsearch.client:elasticsearch-rest-high-level-client:6.4.2"
}

任何主要版本（如測試版）的最新版本可能都是基于Lucene Snapshot版本構建的，在這種情況下，你將無法解析客戶端的Lucene依賴關系。

例如，如果要使用依賴于Lucene 7.0.0-snapshot-00142c9的6.0.0-beta1版本，則必須定義以下存儲庫。

對于Maven：

    elastic-lucene-snapshots
    Elastic Lucene Snapshots
    http://s3.amazonaws.com/download.elasticsearch.org/lucenesnapshots/00142c9
    true
    false

對于Gradle：

maven {
    url "http://s3.amazonaws.com/download.elasticsearch.org/lucenesnapshots/00142c9"
}

High Level Java REST Client依賴于以下工件及其傳遞依賴性：

org.elasticsearch.client:elasticsearch-rest-client

org.elasticsearch:elasticsearch

RestHighLevelClient實例需要按如下方式構建REST低級別客戶端構建器：

RestHighLevelClient client = new RestHighLevelClient(
        RestClient.builder(
                new HttpHost("localhost", 9200, "http"),
                new HttpHost("localhost", 9201, "http")));

高級別客戶端將在內部創建用于根據提供的構建器執行請求的低級別客戶端，該低級別客戶端維護一個連接池并啟動一些線程，因此當你完好無損地關閉高級別客戶端時，它將關閉內部低級別客戶端以釋放這些資源，這可以通過close來完成：

client.close();

在關于Java High Level Client的本文檔的其余部分中，RestHighLevelClient實例將被引用為client。

RestHighLevelClient中的所有API都接受RequestOptions，你可以用來不會改變Elasticsearch執行請求的的方式自定義請求。例如，你可以在此處指定NodeSelector來控制哪個節點接收請求，有關自定義選項的更多示例，請參閱低級別客戶端文檔。