org.apache.http.client

## Interface HttpClient

- 所有已知实现类：
    AbstractHttpClient ， AutoRetryHttpClient ， CloseableHttpClient ， ContentEncodingHttpClient ， DecompressingHttpClient ， DefaultHttpClient ， SystemDefaultHttpClient

      public interface HttpClient

  此接口仅代表执行HTTP请求的最基本的合同。 它对请求执行过程没有施加任何限制或特定细节，并将具体的状态管理，身份验证和重定向处理留给个别实现。
  从以下版本开始：
    4

- - ### 方法摘要

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `HttpResponse` | `execute(HttpHost target, HttpRequest request)` 使用默认上下文执行HTTP请求。
    `HttpResponse` | `execute(HttpHost target, HttpRequest request, HttpContext context)` 使用给定的上下文执行HTTP请求。
    `<T> T` | `execute(HttpHost target, HttpRequest request, ResponseHandler<? extends T> responseHandler)` 使用默认上下文对目标执行HTTP请求，并使用给定的响应处理程序处理响应。
    `<T> T` | `execute(HttpHost target, HttpRequest request, ResponseHandler<? extends T> responseHandler, HttpContext context)` 使用给定的上下文对目标执行HTTP请求，并使用给定的响应处理程序处理响应。
    `HttpResponse` | `execute(HttpUriRequest request)` 使用默认上下文执行HTTP请求。
    `HttpResponse` | `execute(HttpUriRequest request, HttpContext context)` 使用给定的上下文执行HTTP请求。
    `<T> T` | `execute(HttpUriRequest request, ResponseHandler<? extends T> responseHandler)` 使用默认上下文执行HTTP请求，并使用给定的响应处理程序处理响应。
    `<T> T` | `execute(HttpUriRequest request, ResponseHandler<? extends T> responseHandler, HttpContext context)` 使用给定的上下文执行HTTP请求，并使用给定的响应处理程序处理响应。
    `ClientConnectionManager` | `getConnectionManager()` 已过时。 （4.3）使用`HttpClientBuilder` 。
    `HttpParams` | `getParams()` 已过时。 （4.3）使用`RequestConfig` 。

- - ### 方法详细信息

    - #### getParams

          @Deprecated
          HttpParams getParams()

      已过时。 （4.3）使用`RequestConfig` 。
      获取此客户端的参数。 这些参数将成为使用此客户端执行的所有请求的默认值，以及此客户端中依赖对象的参数。
      结果
        默认参数

    - #### getConnectionManager

          @Deprecated
          ClientConnectionManager getConnectionManager()

      已过时。 （4.3）使用`HttpClientBuilder` 。
      获取此客户端使用的连接管理器。
      结果
        连接管理器

    - #### execute

          HttpResponse execute(HttpUriRequest request)
                               throws IOException,
                                      ClientProtocolException

      使用默认上下文执行HTTP请求。
      参数
        `request` - 请求执行
      结果
        对请求的响应。 这总是一个最后的响应，从来没有一个1xx状态代码的中间响应。 是否自动返回或处理重定向或身份验证挑战取决于该客户端的实现和配置。
      异常
        `IOException` - 出现问题或连接中止时
        `ClientProtocolException` - 在http协议错误的情况下

    - #### execute

          HttpResponse execute(HttpUriRequest request,
                             HttpContext context)
                               throws IOException,
                                      ClientProtocolException

      使用给定的上下文执行HTTP请求。
      参数
        `request` - 请求执行
        `context` - 用于执行的上下文，或 `null`使用默认上下文
      结果
        对请求的响应。 这总是一个最后的响应，从来没有一个1xx状态代码的中间响应。 是否自动返回或处理重定向或身份验证挑战取决于该客户端的实现和配置。
      异常
        `IOException` - 出现问题或连接中止时
        `ClientProtocolException` - 在http协议错误的情况下

    - #### execute

          HttpResponse execute(HttpHost target,
                             HttpRequest request)
                               throws IOException,
                                      ClientProtocolException

      使用默认上下文执行HTTP请求。
      参数
        `target` - 请求的目标主机。 如果他们仍然可以确定路由，例如到默认目标或通过检查请求，则实施方案可以接受`null` 。
        `request` - 请求执行
      结果
        对请求的响应。 这总是一个最后的响应，从来没有一个1xx状态代码的中间响应。 是否自动返回或处理重定向或身份验证挑战取决于该客户端的实现和配置。
      异常
        `IOException` - 出现问题或连接中止时
        `ClientProtocolException` - 在http协议错误的情况下

    - #### execute

          HttpResponse execute(HttpHost target,
                             HttpRequest request,
                             HttpContext context)
                               throws IOException,
                                      ClientProtocolException

      使用给定的上下文执行HTTP请求。
      参数
        `target` - 请求的目标主机。 如果他们仍然可以确定路由，例如到默认目标或通过检查请求，那么实现可以接受`null` 。
        `request` - 请求执行
        `context` - 用于执行的上下文，或 `null`使用默认上下文
      结果
        对请求的响应。 这总是一个最后的响应，从来没有一个1xx状态代码的中间响应。 是否自动返回或处理重定向或身份验证挑战取决于该客户端的实现和配置。
      异常
        `IOException` - 出现问题或连接中止时
        `ClientProtocolException` - 在http协议错误的情况下

    - #### execute

          <T> T execute(HttpUriRequest request,
                      ResponseHandler<? extends T> responseHandler)
                    throws IOException,
                           ClientProtocolException

      使用默认上下文执行HTTP请求，并使用给定的响应处理程序处理响应。

      需要实现类以确保与响应相关联的内容实体完全消耗，并且底层连接在所有情况下自动释放回连接管理器，从而减轻个人`ResponseHandler`在内部管理资源释放的情况。

      参数
        `request` - 执行请求
        `responseHandler` - 响应处理程序
      结果
        由响应处理程序生成的响应对象。
      异常
        `IOException` - 出现问题或连接中止时
        `ClientProtocolException` - 在http协议错误的情况下

    - #### execute

          <T> T execute(HttpUriRequest request,
                      ResponseHandler<? extends T> responseHandler,
                      HttpContext context)
                    throws IOException,
                           ClientProtocolException

      使用给定的上下文执行HTTP请求，并使用给定的响应处理程序处理响应。

      需要实现类，以确保与响应相关联的内容实体完全消耗，并且底层连接在所有情况下自动释放回连接管理器，从而减轻个人`ResponseHandler`不必在内部管理资源释放。

      参数
        `request` - 要执行的请求
        `responseHandler` - 响应处理程序
        `context` - 用于执行的上下文，或 `null`使用默认上下文
      结果
        由响应处理程序生成的响应对象。
      异常
        `IOException` - 出现问题或连接中止时
        `ClientProtocolException` - 在http协议错误的情况下

    - #### execute

          <T> T execute(HttpHost target,
                      HttpRequest request,
                      ResponseHandler<? extends T> responseHandler)
                    throws IOException,
                           ClientProtocolException

      使用默认上下文对目标执行HTTP请求，并使用给定的响应处理程序处理响应。

      需要实现类，以确保与响应相关联的内容实体完全消耗，并且底层连接在所有情况下自动释放回连接管理器， 以免个人`ResponseHandler`不必在内部管理资源释放。

      参数
        `target` - 请求的目标主机。 如果他们仍然可以确定路由，例如到默认目标或通过检查请求，则实施方案可以接受`null` 。
        `request` - 执行请求
        `responseHandler` - 响应处理程序
      结果
        由响应处理程序生成的响应对象。
      异常
        `IOException` - 出现问题或连接中止时
        `ClientProtocolException` - 在http协议错误的情况下

    - #### execute

          <T> T execute(HttpHost target,
                      HttpRequest request,
                      ResponseHandler<? extends T> responseHandler,
                      HttpContext context)
                    throws IOException,
                           ClientProtocolException

      使用给定的上下文对目标执行HTTP请求，并使用给定的响应处理程序处理响应。

      需要实现类以确保与响应相关联的内容实体被完全消耗，并且底层连接在所有情况下都自动释放回连接管理器，从而使个人`ResponseHandler`不必在内部管理资源释放。

      参数
        `target` - 请求的目标主机。 如果他们仍然可以确定路由，例如到默认目标或通过检查请求，那么实现可以接受`null` 。
        `request` - 要执行的请求
        `responseHandler` - 响应处理程序
        `context` - 用于执行的上下文，或 `null`使用默认上下文
      结果
        由响应处理程序生成的响应对象。
      异常
        `IOException` - 出现问题或连接中止时
        `ClientProtocolException` - in case of an http protocol error

Copyright © 1999–2017 The Apache Software Foundation. All rights reserved.

本帮助文档是使用 《谷歌翻译》翻译，请与英文版配合使用 by--QQ:654638585