Getting started - Initialization

优质
小牛编辑
133浏览
2023-12-01

RestClient 实例可以通过相应的 RestClientBuilder 类来构建,通过静态方法 RestClient#builder(HttpHost...) 创建。唯一必需的参数是服务的host和端口(默认9200,切记不要使用9300),以 HttpHost 实例的方式提供给建造者,如下所示:

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

RestClient 类是线程安全的,理想状态下它与使用它的应用程序具有相同的生命周期。当不再使用时强烈建议关闭它:

  1. restClient.close();

RestClientBuilder 在构建 RestClient 实例时可以设置以下的可选配置参数:

  1. RestClientBuilder builder = RestClient.builder(new HttpHost("localhost", 9200, "http"));
  2. Header[] defaultHeaders = new Header[]{
  3. new BasicHeader("header", "value")
  4. };
  5. builder.setDefaultHeaders(defaultHeaders); // 设置默认头文件,避免每个请求都必须指定。
  1. RestClientBuilder builder = RestClient.builder(new HttpHost("localhost", 9200, "http"));
  2. builder.setMaxRetryTimeoutMillis(10000);//设置在同一请求进行多次尝试时应该遵守的超时时间。默认值为30秒,与默认`socket`超时相同。 如果自定义设置了`socket`超时,则应该相应地调整最大重试超时。
  1. RestClientBuilder builder = RestClient.builder(new HttpHost("localhost", 9200, "http"));
  2. builder.setFailureListener(new RestClient.FailureListener() {
  3. @Override
  4. public void onFailure(HttpHost host) {
  5. //设置每次节点发生故障时收到通知的侦听器。内部嗅探到故障时被启用。
  6. }
  7. });
  1. RestClientBuilder builder = RestClient.builder(new HttpHost("localhost", 9200, "http"));
  2. builder.setRequestConfigCallback(new RestClientBuilder.RequestConfigCallback() {
  3. @Override
  4. public RequestConfig.Builder customizeRequestConfig(RequestConfig.Builder requestConfigBuilder) {
  5. return requestConfigBuilder.setSocketTimeout(10000); // 设置修改默认请求配置的回调(例如:请求超时,认证,或者其他 [org.apache.http.client.config.RequestConfig.Builder](https://hc.apache.org/httpcomponents-client-ga/httpclient/apidocs/org/apache/http/client/config/RequestConfig.Builder.html) 设置)。
  6. }
  7. });
  1. RestClientBuilder builder = RestClient.builder(new HttpHost("localhost", 9200, "http"));
  2. builder.setHttpClientConfigCallback(new RestClientBuilder.HttpClientConfigCallback() {
  3. @Override
  4. public HttpAsyncClientBuilder customizeHttpClient(HttpAsyncClientBuilder httpClientBuilder) {
  5. return httpClientBuilder.setProxy(new HttpHost("proxy", 9000, "http")); //设置修改 http 客户端配置的回调(例如:ssl 加密通讯,或其他任何 [org.apache.http.impl.nio.client.HttpAsyncClientBuilder](http://hc.apache.org/httpcomponents-asyncclient-dev/httpasyncclient/apidocs/org/apache/http/impl/nio/client/HttpAsyncClientBuilder.html) 设置)
  6. }
  7. });