HttpEntity的作用

HttpEntity 是 Spring 的 httpclient 包中的一个类，它在 Spring 的 HTTP 客户端编程中扮演着重要的角色。HttpEntity 表示一个 HTTP 消息的实体部分，可以包含请求或响应的头信息（headers）、正文（body）以及状态码和状态信息。

以下是 HttpEntity 的一些主要用途：

1. 携带 HTTP 头信息：HttpEntity 可以包含自定义的 HTTP 头信息，例如 Content-Type、Accept、Authorization 等。

2. 发送请求正文：在使用 HttpEntity 发送 POST、PUT 或 PATCH 请求时，可以将请求正文作为 HttpEntity 的一部分发送。

3. 接收响应正文：在接收响应时，可以通过 HttpEntity 获取响应头信息和响应正文。

4. 使用 RestTemplate：HttpEntity 经常与 Spring 的 RestTemplate 一起使用，用于构建 HTTP 请求。例如，你可以创建一个 HttpEntity，设置必要的头信息和请求正文，然后使用 RestTemplate 发送请求。

5. 保持连接：HttpEntity 可以设置连接保持的头信息，这对于需要持续连接的场景（如长轮询）很有用。

6. 超时控制：可以为 HttpEntity 设置超时时间，这会影响底层 HTTP 连接的超时行为。

7. 执行 HTTP 方法：HttpEntity 可以与不同的 HTTP 方法（如 GET、POST、PUT 等）一起使用，以执行相应的操作。

下面是一个简单的使用 HttpEntity 和 RestTemplate 发送 POST 请求的示例：

import org.springframework.http.HttpEntity;
import org.springframework.http.HttpHeaders;
import org.springframework.http.MediaType;
import org.springframework.http.client.HttpComponentsClientHttpRequestFactory;
import org.springframework.web.client.RestTemplate;

// 创建 RestTemplate 实例
RestTemplate restTemplate = new RestTemplate(new HttpComponentsClientHttpRequestFactory());

// 创建 HttpEntity 设置请求头信息
HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_JSON);

// 创建请求正文
String body = "{\"key1\":\"value1\", \"key2\":\"value2\"}";

// 构建 HttpEntity
HttpEntity<String> entity = new HttpEntity<>(body, headers);

// 发送 POST 请求并接收响应
ResponseEntity<String> response = restTemplate.postForEntity("http://example.com/api/resource", entity, String.class);

// 获取响应状态码和正文
int statusCode = response.getStatusCode().value();
String responseString = response.getBody();

在这个示例中，我们创建了一个 HttpEntity，设置了请求头信息和请求正文，然后使用 RestTemplate 发送了一个 POST 请求。通过 HttpEntity，我们可以方便地构建和发送复杂的 HTTP 请求。