HttpClient API 文档：1. 基本原理

1.1 请求执行

HttpClient 最重要的功能是执行 HTTP 方法。执行 HTTP 方法涉及一个或多个 HTTP 请求/响应 交换，通常由 HttpClient 内部处理。

用户期望提供一个请求对象来执行，并且希望 HttpClient 将请求发送到目标服务器返回相应的响应对象，如果执行失败则抛出异常。

很自然，HttpClient API 的主要入口点是定义上述协议的 HttpClient 接口。
以下是一个最基本的请求执行过程的例子：

CloseableHttpClient httpclient = HttpClients.createDefault();
HttpGet httpget = new HttpGet("http://localhost/");
CloseableHttpResponse response = httpclient.execute(httpget);
try {
  <...>
} finally {
  response.close();
}

1.1.1 HTTP 请求

所有 HTTP 请求都有一个请求行，包括方法名称，请求 URI 和 HTTP 协议版本。

HttpClient 支持了在 HTTP / 1.1 规范中定义的所有 HTTP 方法：GET，HEAD，POST，PUT，DELETE，TRACE 和 OPTIONS。

对于每个方法类型，都有一个特定的类来支持：HttpGet， HttpHead，HttpPost， HttpPut，HttpDelete， HttpTrace，和 HttpOptions。

Request-URI 是统一资源标识符，用于标识应用请求的资源。HTTP 请求 URI 由协议方案，主机名，可选端口，资源路径，可选查询和可选片段组成。

HttpGet httpget = new HttpGet(
        "http://www.google.com/search?hl=en&q=httpclient&btnG=Google+Search&aq=f&oq=");

HttpClient 提供 URIBuilder 实用工具类来简化请求 URI 的创建和修改。

stdout>
http://www.google.com/search?q=httpclient&btnG=Google+Search&aq=f&oq=

URI uri = new URIBuilder()
        .setScheme("http")
        .setHost("www.google.com")
        .setPath("/search")
        .setParameter("q", "httpclient")
        .setParameter("btnG", "Google Search")
        .setParameter("aq", "f")
        .setParameter("oq", "")
        .build();
HttpGet httpget = new HttpGet(uri);
System.out.println(httpget.getURI());

1.1.2 HTTP 响应

HTTP 响应是在接收和解释请求消息之后由服务器发送回客户端的消息。该消息的第一行包括协议版本，后跟数字状态代码及其关联的文本短语。

 stdout >
 HTTP/1.1
 200
 OK
 HTTP/1.1 200 OK

HttpResponse response = new BasicHttpResponse(HttpVersion.HTTP_1_1, HttpStatus.SC_OK, "OK");

System.out.println(response.getProtocolVersion());
System.out.println(response.getStatusLine().getStatusCode());
System.out.println(response.getStatusLine().getReasonPhrase());
System.out.println(response.getStatusLine().toString());

1.1.3 处理消息头

HTTP 消息可以包含描述消息的属性的多个标题，例如内容长度，内容类型等。HttpClient 提供了检索，添加，删除和枚举消息头的方法。

 stdout >
 Set-Cookie: c1=a; path=/; domain=localhost
 Set-Cookie: c2=b; path="/", c3=c; domain="localhost"
 2

HttpResponse response = new BasicHttpResponse(HttpVersion.HTTP_1_1,
        HttpStatus.SC_OK, "OK");
response.addHeader("Set-Cookie",
        "c1=a; path=/; domain=localhost");
response.addHeader("Set-Cookie",
        "c2=b; path=\"/\", c3=c; domain=\"localhost\"");
Header h1 = response.getFirstHeader("Set-Cookie");
System.out.println(h1);
Header h2 = response.getLastHeader("Set-Cookie");
System.out.println(h2);
Header[] hs = response.getHeaders("Set-Cookie");
System.out.println(hs.length);

获取给定类型的所有标头的最有效的方法是使用 HeaderIterator 接口。

 stdout >
 Set-Cookie: c1=a; path=/; domain=localhost
 Set-Cookie: c2=b; path="/", c3=c; domain="localhost"

HttpResponse response = new BasicHttpResponse(HttpVersion.HTTP_1_1,
        HttpStatus.SC_OK, "OK");
response.addHeader("Set-Cookie",
        "c1=a; path=/; domain=localhost");
response.addHeader("Set-Cookie",
        "c2=b; path=\"/\", c3=c; domain=\"localhost\"");

HeaderIterator it = response.headerIterator("Set-Cookie");

while (it.hasNext()) {
    System.out.println(it.next());
}

它还提供了便捷的方法来将 HTTP 消息解析为单独的头元素。

 stdout >
 c1 = a
 path=/
 domain=localhost
 c2 = b
 path=/
 c3 = c
 domain=localhost

HttpResponse response = new BasicHttpResponse(HttpVersion.HTTP_1_1,
        HttpStatus.SC_OK, "OK");
response.addHeader("Set-Cookie","c1=a;path=/;domain=localhost");
response.addHeader("Set-Cookie","c2=b;path=\"/\",c3=c;domain=\"localhost\"");

HeaderElementIterator heit = new BasicHeaderElementIterator(
        response.headerIterator("Set-Cookie"));

while (heit.hasNext()) {
    HeaderElement element = heit.nextElement();
    System.out.println(element.getName() + "=" + element.getValue());
    NameValuePair[] params = element.getParameters();
    for (int i = 0; i < params.length; i++) {
        System.out.println("" + params[i]);
    }
}

1.1.4 HTTP 实体

HTTP 消息可以携带与请求或响应相关联的内容实体。实体可以在某些请求和响应中找到，因为它们是可选的。
使用实体的请求被称为实体封装请求。
HTTP 规范定义了两个实体封装请求的方法：POST 和 PUT。
HTTP 响应通常期望包含有内容实体。
当然也有例外的情况，例如响应为 204 No Content， 304 Not Modified，205 Reset Content 的时候不包含内容实体。
HttpClient 根据其内容来源区分三种实体：

  1. 流式传输（streamed）：内容是从流中接收到的，或者即时生成。特别地，该类别包括从 HTTP 响应接收到的实体。流式实体通常不可重复。
  2. 自包含（self-contained）：内容在内存中或通过独立于连接或其他实体的方式获取。自包含的实体通常是可重复的。这种类型的实体将主要用于封闭 HTTP 请求的实体。
  3. 包装（wrapping）：内容是从另一个实体获得的。

当从 HTTP 响应流出内容时，这个区别对于连接管理很重要。对于由应用程序创建并且仅使用 HttpClient 发送的请求实体，流和自包含的区别并不是重要。因而可以通过是否可重复来区分它们，将不可重复的实体视为流式的，将可重复的实体视为自包含的。

1.1.4.1 可重复的实体

一个实体可以重复，这意味着它的内容可以被读取多次。这种情况仅仅可能出现在自包含的实体中（例如 ByteArrayEntity 或 StringEntity）。

1.1.4.2 使用 HTTP 实体

由于实体可以表示二进制和字符内容，因此它支持字符编码（为了支持字符内容）。

当执行带有封闭内容的请求时，或者当请求成功后使用响应主体将结果发送回客户端时，实体被创建。

要从实体读取内容，可以通过 HttpEntity#getContent() 方法来检索输入流，该方法返回一个 java.io.InputStream，或者可以向 HttpEntity#writeTo(OutputStream) 方法提供输出流，一旦所有内容都被写入给定流，该方法将返回。

当实体和传入消息已经被接收，方法 HttpEntity#getContentType() 和
HttpEntity#getContentLength() 可用于读取公共 metadata，例如 Content-Type 与 Content-Length 报头（如果可用的话）。
Content-Type 报头可以包含 text/plain 或 text/html 等文本 MIME 类型的字符编码，方法 HttpEntity#getContentEncoding() 可以用于读取此信息。
如果报头不可用，则返回 Content-Length 为 -1，Content-Type 为 NULL。如果 Content-Type 报头可用，将返回一个 Header 对象。

当为外发消息创建实体时，该 metadata 必须由实体的创建者来提供。

 stdout >
 Content-Type: text/plain; charset=utf-8
 17
 important message
 17

StringEntity myEntity = new StringEntity("important message",
        ContentType.create("text/plain", "UTF-8"));

System.out.println(myEntity.getContentType());
System.out.println(myEntity.getContentLength());
System.out.println(EntityUtils.toString(myEntity));
System.out.println(EntityUtils.toByteArray(myEntity).length);

1.1.5 确保释放低级别的资源

为了确保正确释放系统资源，必须关闭与实体相关联的内容流或者响应本身。

CloseableHttpClient httpclient = HttpClients.createDefault();
HttpGet httpget = new HttpGet("http://localhost/");
CloseableHttpResponse response = httpclient.execute(httpget);
try {
    HttpEntity entity = response.getEntity();
    if (entity != null) {
        InputStream instream = entity.getContent();
        try {
            //做一些有用的事情
        } finally {
            instream.close();
        }
    }
} finally {
    response.close();
}

关闭内容流和关闭响应之间的区别是，前者将尝试通过消费实体内容来保持底层的连接，而后者会立即关闭并丢弃当前连接。

请注意，一旦方法 HttpEntity#writeTo(OutputStream) 的实体完全写出，也需要确保合适的释放系统资源。如果这个方法通过调用 HttpEntity#getContent() 获取一个 java.io.InputStream 实例，那么也应该在 finally 子句中关闭流。

当处理流实体时，可以使用 EntityUtils#consume(HttpEntity) 方法来确保实体内容已被完全消耗，并且底层流已经被关闭。

然而，可能会有一种情况，当仅需要检索整个响应内容的一小部分时，消耗剩余内容并使连接可重用的性能损失太高，这时可以通过关闭响应来终止内容流。

CloseableHttpClient httpclient = HttpClients.createDefault();
HttpGet httpget = new HttpGet("http://localhost/");
CloseableHttpResponse response = httpclient.execute(httpget);
try {
    HttpEntity entity = response.getEntity();
    if (entity != null) {
        InputStream instream = entity.getContent();
        int byteOne = instream.read();
        int byteTwo = instream.read();
        //不需要休息
    }
} finally {
    response.close();
}

连接不会被重用，但由其持有的所有级别的资源将会被正确地释放。

1.1.6 消费实体内容

消费实体内容推荐使用 HttpEntity#getContent() 或 HttpEntity#writeTo(OutputStream) 方法。

HttpClient 还附带了 EntityUtils 类，它暴露了几种静态方法，来方便我们从实体中读取内容或信息。可以通过使用这个类的方法取回整个内容体的字符串或者字节数组，而不是通过去直接读取 java.io.InputStream 来获取内容。但是，除非响应实体来自受信任的 HTTP 服务器，并且已知其长度有限，否则强烈建议不要使用 EntityUtils 的方法。

CloseableHttpClient httpclient = HttpClients.createDefault();
HttpGet httpget = new HttpGet("http://localhost/");
CloseableHttpResponse response = httpclient.execute(httpget);
try {
    HttpEntity entity = response.getEntity();
    if (entity != null) {
        long len = entity.getContentLength();
        if (len != -1 && len < 2048) {
            System.out.println(EntityUtils.toString(entity));
        } else {
            //流内容
        }
    }
} finally {
    response.close();
}

在某些情况下，可能需要多次读取实体内容。在这种情况下，实体内容必须以某种方式缓存，无论是在内存还是在磁盘上。

最简单的方式是通过使用 BufferedHttpEntity 类包装原始实体。这会使原始实体的内容被读入内存缓冲区。在所有其他方式中，实体包装器将具有原始内容。

CloseableHttpResponse response = <...>
HttpEntity entity = response.getEntity();
if (entity != null) {
    entity = new BufferedHttpEntity(entity);
}

1.1.7 创建实体内容

HttpClient 提供了几个类，可以通过 HTTP 连接高效地流出内容。这些类的实例可以将那些需要包装其关联的实体内容的 HTTP 请求（例如 POST 和 PUT）包装实体去流出 HTTP 请求端。HttpClient 为最常见的数据的容器（如字符串，字节数组，输入流和文件）提供了几个类：StringEntity，ByteArrayEntity，InputStreamEntity 和 FileEntity。

请注意 InputStreamEntity 不可重复，因为它只能从基础数据流中读取一次。通常建议实现一个自包含 HttpEntity 的自定义类，而不是使用一般的 InputStreamEntity。 FileEntity 可以是一个很好的开始。

File file = new File("somefile.txt");
FileEntity entity = new FileEntity(file,
        ContentType.create("text/plain", "UTF-8"));

HttpPost httppost = new HttpPost("http://localhost/action.do");
httppost.setEntity(entity);

1.1.7.1 HTML 表单

许多应用程序需要模拟提交 HTML 表单的过程，例如，登录到 Web 应用程序或提交输入数据。HttpClient 提供实体类 UrlEncodedFormEntity 来简化这个过程。
本 UrlEncodedFormEntity 实例将使用所谓的 URL 编码参数进行编码并生成以下内容：

param1=value1&param2=value2

List<NameValuePair> formparams = new ArrayList<NameValuePair>();
formparams.add(new BasicNameValuePair("param1", "value1"));
formparams.add(new BasicNameValuePair("param2", "value2"));
UrlEncodedFormEntity entity = new UrlEncodedFormEntity(formparams, Consts.UTF_8);
HttpPost httppost = new HttpPost("http://localhost/handler.do");
httppost.setEntity(entity);

1.1.7.2 内容分块

一般建议让 HttpClient 根据正在传输的 HTTP 消息的属性选择最合适的传输编码。然而，可以通知 HttpClient，通过设置 HttpEntity#setChunked() 为 true，优先选择块编码。

请注意，HttpClient 只会使用此标志作为提示。当使用不支持块编码的 HTTP 协议版本（如 HTTP/1.0）时，此值将被忽略。

StringEntity entity = new StringEntity("important message",
        ContentType.create("plain/text", Consts.UTF_8));
entity.setChunked(true);
HttpPost httppost = new HttpPost("http://localhost/acrtion.do");
httppost.setEntity(entity);

1.1.8 响应处理程序

处理响应的最简单和最方便的方法是使用 ResponseHandler 接口，它包含 handleResponse(HttpResponse response) 方法。该方法完全消除用户对连接管理的担心。

使用 ResponseHandler 时，无论请求执行成功还是出现异常，HttpClient 都将自动保证将该连接释放回连接管理器。

CloseableHttpClient httpclient = HttpClients.createDefault();
HttpGet httpget = new HttpGet("http://localhost/json");

ResponseHandler<MyJsonObject> rh = new ResponseHandler<MyJsonObject>() {

    @Override
    public JsonObject handleResponse(final HttpResponse response) throws IOException {
        StatusLine statusLine = response.getStatusLine();
        HttpEntity entity = response.getEntity();
        if (statusLine.getStatusCode() >= 300) {
            throw new HttpResponseException(
                    statusLine.getStatusCode(),
                    statusLine.getReasonPhrase());
        }
        if (entity == null) {
            throw new ClientProtocolException("Response contains no content");
        }
        Gson gson = new GsonBuilder().create();
        ContentType contentType = ContentType.getOrDefault(entity);
        Charset charset = contentType.getCharset();
        Reader reader = new InputStreamReader(entity.getContent(), charset);
        return gson.fromJson(reader, MyJsonObject.class);
    }
};
MyJsonObject myjson = client.execute(httpget, rh);

1.2 HttpClient 接口

HttpClient 接口代表 HTTP 请求执行最基本的协议。它对请求执行过程没有施加任何限制或特定细节，并将连接管理，状态管理，认证和重定向处理的具体细节留给一个具体实现。这使得可以更容易使用附加功能（如响应内容缓存）来装饰接口。

一般来说，HttpClient 实现作为一个特殊目的处理程序或策略接口实现的立面，负责处理 HTTP 协议的特定方面，如重定向或身份验证处理或决定连接持久性并保持活动持续时间。这使得用户能够选择性地将这些方面的默认实现替换为自己的实现或者为特定应用程序设计的实现。

ConnectionKeepAliveStrategy keepAliveStrat = new DefaultConnectionKeepAliveStrategy() {

    @Override
    public long getKeepAliveDuration(
            HttpResponse response,
            HttpContext context) {
        long keepAlive = super.getKeepAliveDuration(response, context);
        if (keepAlive == -1) {
            // 如果 keep-alive 的值没有被服务器显式设置，就设置为 5 秒
            keepAlive = 5000;
        }
        return keepAlive;
    }
};

CloseableHttpClient httpclient = HttpClients.custom()
        .setKeepAliveStrategy(keepAliveStrat)
        .build();

1.2.1 HttpClient 线程安全

HttpClient 的实现是线程安全的。因此建议将此类的同一个实例重用于多个请求执行。

1.2.2 HttpClient 资源释放

当一个 CloseableHttpClient 实例不再需要并且即将超出作用域时，与它关联的连接管理器必须通过调用 CloseableHttpClient#close() 方法来关闭。

CloseableHttpClient httpclient = HttpClients.createDefault();
try {
<...>
} finally {
    httpclient.close();
}

1.3 HTTP 执行上下文

最初 HTTP 被设计为无状态的，请求-响应的协议。然而，现实世界的应用程序通常需要通过几个逻辑相关的请求-响应交换来保持状态信息。

为了使应用程序能够保持处理状态，HttpClient 允许在特定执行上下文（称为 HTTP context）中执行 HTTP 请求。

如果在连续请求之间重复使用相同的上下文，则多个逻辑相关请求可以参与逻辑会话。HTTP 上下文功能类似于一个 java.util.Map<String, Object>。它只是一个任意命名值的集合。应用程序可以在请求执行之前填充上下文属性，或者在执行完成后检查上下文。

HttpContext 可以包含任意对象，因此可能不安全地在多个线程之间共享。建议每个执行线程维护自己的上下文。

在 HTTP 请求执行过程中，HttpClient 将以下属性添加到执行上下文中：

  • HttpConnection 表示与目标服务器的实际连接的实例。
  • HttpHost 表示连接目标的实例。
  • HttpRoute 表示完整的连接路由的实例
  • HttpRequest 表示实际 HTTP 请求的实例。执行上下文中的最终 HttpRequest 对象总是表示消息的状态与发送到目标服务器的状态完全相同。默认 HTTP / 1.0 和 HTTP / 1.1 使用相对请求 URI。然而，如果请求是通过非隧道模式下的代理发送的，则 URI 将是绝对地址。
  • HttpResponse 表示实际的 HTTP 响应。
  • java.lang.Boolean 表示实际请求是否被完全发送到连接目标的标志的对象。
  • RequestConfig 表示实际请求配置的对象。
  • java.util.List<URI> 表示在请求执行过程中接收到的所有重定向位置的集合的对象。

可以使用 HttpClientContext 适配器类来简化与上下文状态的分离。

HttpContext context = <...>
HttpClientContext clientContext = HttpClientContext.adapt(context);
HttpHost target = clientContext.getTargetHost();
HttpRequest request = clientContext.getRequest();
HttpResponse response = clientContext.getResponse();
RequestConfig config = clientContext.getRequestConfig();

表示逻辑相关会话的多个请求序列应该使用相同的 HttpContext 实例执行，以确保在请求之间自动传播会话上下文和状态信息。

在以下示例中，由初始请求设置的请求配置将保留在执行上下文中，并被传播到共享相同上下文的连续请求。

CloseableHttpClient httpclient = HttpClients.createDefault();
RequestConfig requestConfig = RequestConfig.custom()
        .setSocketTimeout(1000)
        .setConnectTimeout(1000)
        .build();

HttpGet httpget1 = new HttpGet("http://localhost/1");
httpget1.setConfig(requestConfig);
CloseableHttpResponse response1 = httpclient.execute(httpget1, context);
try {
    HttpEntity entity1 = response1.getEntity();
} finally {
    response1.close();
}
HttpGet httpget2 = new HttpGet("http://localhost/2");
CloseableHttpResponse response2 = httpclient.execute(httpget2, context);
try {
    HttpEntity entity2 = response2.getEntity();
} finally {
    response2.close();
}

1.4 HTTP 协议拦截器

HTTP 协议拦截器是一个实现 HTTP 协议特定切面的程序。通常协议拦截器期望作用于输入消息的一个特定头部或一组相关头部，或者使用一个特定头部或一组相关头部填充传出的消息。

协议拦截器还可以操纵包含消息的内容实体 - 显式内容压缩/解压缩就是一个很好的例子。通常这是通过使用“装饰器”模式来实现的，其中包装器实体类用于装饰原始实体。几个协议拦截器可以组合形成一个逻辑单元。

协议拦截器可以通过 HTTP 执行上下文共享信息（如处理状态）进行协作。协议拦截器可以使用 HTTP 上下文来存储一个请求或多个连续请求的处理状态。通常执行拦截器的顺序并不重要，只要它们不依赖执行上下文的特定状态即可。如果协议拦截器具有相互依赖关系，那么必须以特定顺序执行，应将它们按照与其预期执行顺序相同的顺序添加到协议处理器中。

协议拦截器必须实现为线程安全。与 servlet 类似，协议拦截器不应该使用实例变量，除非对这些变量的访问是同步（synchronized）的。

下面是一个例子，说明如何使用本地上下文来持续连续请求之间的处理状态：

CloseableHttpClient httpclient = HttpClients.custom()
        .addInterceptorLast(new HttpRequestInterceptor() {

            public void process(
                    final HttpRequest request,
                    final HttpContext context) throws HttpException, IOException {
                AtomicInteger count = (AtomicInteger) context.getAttribute("count");
                request.addHeader("Count", Integer.toString(count.getAndIncrement()));
            }

        })
        .build();

AtomicInteger count = new AtomicInteger(1);
HttpClientContext localContext = HttpClientContext.create();
localContext.setAttribute("count", count);

HttpGet httpget = new HttpGet("http://localhost/");
for (int i = 0; i < 10; i++) {
    CloseableHttpResponse response = httpclient.execute(httpget, localContext);
    try {
        HttpEntity entity = response.getEntity();
    } finally {
        response.close();
    }
}

1.5 异常处理

HTTP 协议处理器可以抛出两种类型的异常：java.io.IOException 表示 I/O 故障（例如套接字超时或套接字复位），而 HttpException 表示 HTTP 失败，例如违反 HTTP 协议。通常 I/O 错误被认为是非致命和可恢复的，而 HTTP 协议错误被认为是致命的，不能自动恢复。

请注意，HttpClient 实现重新抛出 HttpException 作为 ClientProtocolException，它是一个 java.io.IOException 的子类 。这使得 HttpClient 的用户能够在单个 catch 子句同时处理 I/O 错误和协议错误。

1.5.1 HTTP 传输安全

重要的是要了解 HTTP 协议并不适合所有类型的应用程序。HTTP 是一种简单的面向 请求/响应 的协议，最初被设计为支持静态或动态生成的内容检索。它从来没有意图支持事务性操作。

例如：

  • 如果 HTTP 服务器成功接收和处理请求，生成响应并将状态代码发送回客户端，则 HTTP 服务器将考虑其部分合同。
  • 如果客户端由于读取超时，请求取消或系统崩溃而无法全部收到响应，服务器将不会尝试回滚事务。
  • 如果客户端决定重试相同的请求，服务器将不可避免地最终不止一次地执行相同的事务。

在某些情况下，这可能导致应用程序数据损坏或应用程序状态不一致。

即使 HTTP 从未被设计为支持事务处理，但是如果满足某些条件，则仍然可以将其用作任务关键应用程序的传输协议。

为了确保 HTTP 传输层的安全，系统必须确保应用层上的 HTTP 方法的幂等性。

1.5.2 幂等方法

HTTP/1.1 规范定义了一种幂等方法（方法也可以具有“幂等”的属性（除了错误或到期问题），N > 0 相同请求的副作用与单个请求相同）。换句话说，应用程序应该确保它准备好处理多次执行相同方法的含义。

这可以通过例如提供唯一的事务 ID 和避免执行相同逻辑操作的其他手段来实现。

请注意，这个问题不是 HttpClient 特有的。基于浏览器的应用程序受到与 HTTP 方法非幂等性相关的完全相同的问题。

默认情况下，为了兼容性的原因，HttpClient 仅假定非实体封闭方法，例如 GET 或者 HEAD 方法 是幂等的；实体封闭方法，例如 POST 或者 PUT 不是幂等的。

1.5.3 自动异常恢复

默认情况下，HttpClient 尝试自动从 I/O 异常恢复。默认的自动恢复机制仅限于一些已知是安全的异常。

  • HttpClient 将不会尝试从任何逻辑或 HTTP 协议错误（派生自 HttpException 类）中恢复。

  • HttpClient 会自动重试那些假定为幂等的方法。

  • 当 HTTP 请求仍被传送到目标服务器（即请求尚未完全传输到服务器）时，HttpClient 将自动重试那些失败的传输异常的方法。

1.5.4 请求重试处理程序

为了启用自定义异常恢复机制，应该提供 HttpRequestRetryHandler 接口的实现。

请注意，可以使用 StandardHttpRequestRetryHandler 替代默认使用的一个，以匹配由 RFC-2616 定义为幂等安全要求的那些方法来自动重试：GET，HEAD，PUT，DELETE，OPTIONS 和 TRACE。

HttpRequestRetryHandler myRetryHandler = new HttpRequestRetryHandler() {

public boolean retryRequest(
        IOException exception,
        int executionCount,
        HttpContext context) {
    if (executionCount >= 5) {
        //如果超过最大重试计数，请不要重试
        return false;
    }
    if (exception instanceof InterruptedIOException) {
        // 时间到
        return false;
    }
    if (exception instanceof UnknownHostException) {
        // 未知主机
        return false;
    }
    if (exception instanceof ConnectTimeoutException) {
        // 拒绝连接
        return false;
    }
    if (exception instanceof SSLException) {
        // SSL握手异常
        return false;
    }
        HttpClientContext clientContext = HttpClientContext.adapt(context);
        HttpRequest request = clientContext.getRequest();
        boolean idempotent = !(request instanceof HttpEntityEnclosingRequest);
        if (idempotent) {
        //如果请求被认为是幂等，则重试
            return true;
        }
        return false;
    }

};
CloseableHttpClient httpclient = HttpClients.custom()
        .setRetryHandler(myRetryHandler)
        .build();

1.6 中止请求

在某些情况下，由于目标服务器的负载过高或在客户端发出的太多并发请求，HTTP 请求执行在预期时间内无法完成。在这种情况下，可能需要提前终止请求，并在 I/O 操作中解除阻塞执行线程。

HttpClient 执行的 HTTP 请求可以通过调用 HttpUriRequest#abort() 方法在执行的任何阶段中止 。该方法是线程安全的，可以从任何线程调用。
当一个 HTTP 请求中止时，它的执行线程 - 即使当前在 I/O 操作中被阻塞 - 也可以通过抛出一个 InterruptedIOException 来疏通阻塞线程。

1.7 重定向处理

HttpClient 会自动处理所有类型的重定向，除了需要用户干预的 HTTP 规范明确禁止的重定向之外。

See Other（状态码 303）重定向 POST 和 PUT 请求转换为 GET 请求作为 HTTP 规范的要求。

可以使用自定义重定向策略来放对 HTTP 规范强加的 POST 方法的自动重定向的限制。

LaxRedirectStrategy redirectStrategy = new LaxRedirectStrategy();
CloseableHttpClient httpclient = HttpClients.custom()
        .setRedirectStrategy(redirectStrategy)
        .build();

HttpClient 经常在其执行过程中重写请求消息。默认情况下，HTTP/1.0 和 HTTP/1.1 通常使用相对请求URI。

同样，原始请求可能会从一个地址重定向到另一个地址多次。最终绝对 HTTP 地址定位可以使用原始请求和上下文构建出来。

一个实用的方法 URIUtils#resolve 可用于构建用于生成最终 HTTP 请求绝对的 URI。该方法包括来自重定向请求或原始请求的最后一个片段标识符。

CloseableHttpClient httpclient = HttpClients.createDefault();
HttpClientContext context = HttpClientContext.create();
HttpGet httpget = new HttpGet("http://localhost:8080/");
CloseableHttpResponse response = httpclient.execute(httpget, context);
try {
    HttpHost target = context.getTargetHost();
    List<URI> redirectLocations = context.getRedirectLocations();
    URI location = URIUtils.resolve(httpget.getURI(), target, redirectLocations);
    System.out.println("Final HTTP location: " + location.toASCIIString());
    //预期是绝对的URI
} finally {
    response.close();
}
最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 159,015评论 4赞 362
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 67,262评论 1赞 292
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 108,727评论 0赞 243
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 43,986评论 0赞 205
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 52,363评论 3赞 287
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 40,610评论 1赞 219
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 31,871评论 2赞 312
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 30,582评论 0赞 198
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 34,297评论 1赞 242
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,551评论 2赞 246
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,053评论 1赞 260
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 28,385评论 2赞 253
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 33,035评论 3赞 236
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,079评论 0赞 8
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,841评论 0赞 195
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 35,648评论 2赞 274
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 35,550评论 2赞 270

推荐阅读更多精彩内容

  • API设计思考与实践
    API定义规范 本规范设计基于如下使用场景： 请求频率不是非常高：如果产品的使用周期内请求频率非常高，建议使用双通...
    有涯逐无涯阅读 2,442评论 0赞 6
  • Spring Cloud
    Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具（例如配置管理，服务发现，断路器，智...
    卡卡罗2017阅读 134,100评论 18赞 139
  • Spring Framework 5 MVC 官方手册译文
    Spring Web MVC Spring Web MVC 是包含在 Spring 框架中的 Web 框架，建立于...
    Hsinwong阅读 21,774评论 1赞 92
  • 2018-05-18
    仟佑21阅读 201评论 0赞 0
  • 杜員反思日志0802-2017@
    一、7条人生守则：采用对标的方法 1、早睡早起：晚十早五，午休5-15分钟。 2、真诚反思：日反思，周检视，月总结...
    员子圆梦阅读 149评论 0赞 0