摘要：設(shè)置在多次嘗試同一請求時應(yīng)該遵守的超時，默認值為秒，與默認超時相同。如果自定義超時，則應(yīng)相應(yīng)地調(diào)整最大重試超時。設(shè)置一個監(jiān)聽器，每次節(jié)點出現(xiàn)故障時都會收到通知，以防需要采取措施，當啟用故障嗅探時在內(nèi)部使用。

可以通過相應(yīng)的RestClientBuilder類構(gòu)建RestClient實例，通過RestClient#builder(HttpHost...)靜態(tài)方法創(chuàng)建，唯一必需的參數(shù)是客戶端將與之通信的一個或多個主機，作為HttpHost的實例提供，如下所示：

RestClient restClient = RestClient.builder(
        new HttpHost("localhost", 9200, "http"),
        new HttpHost("localhost", 9201, "http")).build();

RestClient類是線程安全的，理想情況下與使用它的應(yīng)用程序具有相同的生命周期，重要的是不再需要時關(guān)閉它，以便它所使用的所有資源得到正確釋放，以及底層的http客戶端實例及其線程：

restClient.close();

RestClientBuilder還允許在構(gòu)建RestClient實例時可選地設(shè)置以下配置參數(shù)：

RestClientBuilder builder = RestClient.builder(new HttpHost("localhost", 9200, "http"));
Header[] defaultHeaders = new Header[]{new BasicHeader("header", "value")};
builder.setDefaultHeaders(defaultHeaders);

設(shè)置需要隨每個請求一起發(fā)送的默認headers，以防止必須為每個請求指定它們。

RestClientBuilder builder = RestClient.builder(new HttpHost("localhost", 9200, "http"));
builder.setMaxRetryTimeoutMillis(10000);

設(shè)置在多次嘗試同一請求時應(yīng)該遵守的超時，默認值為30秒，與默認socket超時相同。如果自定義socket超時，則應(yīng)相應(yīng)地調(diào)整最大重試超時。

RestClientBuilder builder = RestClient.builder(new HttpHost("localhost", 9200, "http"));
builder.setFailureListener(new RestClient.FailureListener() {
    @Override
    public void onFailure(Node node) {
        
    }
});

設(shè)置一個監(jiān)聽器，每次節(jié)點出現(xiàn)故障時都會收到通知，以防需要采取措施，當啟用故障嗅探時在內(nèi)部使用。

RestClientBuilder builder = RestClient.builder(new HttpHost("localhost", 9200, "http"));
builder.setNodeSelector(NodeSelector.SKIP_DEDICATED_MASTERS);

設(shè)置用于過濾節(jié)點的節(jié)點選擇器，客戶端將發(fā)送請求到設(shè)置給客戶端本身的節(jié)點之一，這有助于防止在啟用嗅探時向?qū)Ｓ弥鞴?jié)點發(fā)送請求，默認情況下，客戶端向每個配置的節(jié)點發(fā)送請求。

RestClientBuilder builder = RestClient.builder(new HttpHost("localhost", 9200, "http"));
builder.setRequestConfigCallback(new RestClientBuilder.RequestConfigCallback() {
    @Override
    public RequestConfig.Builder customizeRequestConfig(RequestConfig.Builder requestConfigBuilder) {
        return requestConfigBuilder.setSocketTimeout(10000); 
    }
});

設(shè)置允許修改默認請求配置的回調(diào)（例如請求超時，身份驗證或org.apache.http.client.config.RequestConfig.Builder允許設(shè)置的任何內(nèi)容）。

RestClientBuilder builder = RestClient.builder(new HttpHost("localhost", 9200, "http"));
builder.setHttpClientConfigCallback(new RestClientBuilder.HttpClientConfigCallback() {
    @Override
    public HttpAsyncClientBuilder customizeHttpClient(HttpAsyncClientBuilder httpClientBuilder) {
        return httpClientBuilder.setProxy(new HttpHost("proxy", 9000, "http"));  
    }
});

設(shè)置允許修改http客戶端配置的回調(diào)（例如通過ssl進行加密通信，或者org.apache.http.impl.nio.client.HttpAsyncClientBuilder允許設(shè)置的任何內(nèi)容）。