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