RestTemplate.postForEntity 方法进行 HTTP POST 请求

RestTemplate 是 Spring Framework 提供的一个用于处理 HTTP 请求的客户端工具。其中，postForEntity 是 RestTemplate 提供的用于发送 HTTP POST 请求并返回 ResponseEntity 对象的方法。

public <T> ResponseEntity<T> postForEntity(String url, Object request, Class<T> responseType, Object... uriVariables)

参数说明：

url（String）：HTTP POST 请求的目标URL。

request（Object）：要发送的请求体数据，通常是一个对象，它将被转换为请求体。可以是一个 POJO 对象、HttpEntity 对象、MultiValueMap 对象等。

responseType（Class<T>）：响应的数据类型，即期望的返回类型。通常是一个 Java 类型，用于指定响应数据应该被转换成的类型。

uriVariables（Object...）：可选参数，用于替换 URL 中的占位符，通常在 URL 中包含占位符时使用。

工作原理：

首先，RestTemplate 构建一个 HTTP POST 请求，包括请求头、请求体、URL等信息。

请求体数据（request 参数）会被序列化为请求体内容，通常是 JSON 或表单数据，具体的序列化方式取决于请求的内容类型（Content-Type）。

RestTemplate 发送 HTTP POST 请求到指定的 url。

当服务端响应返回时，RestTemplate 接收响应，包括响应头和响应体。

响应体的数据会被反序列化为指定的 responseType 类型，以便在 Java 中使用。

最后，postForEntity 方法返回一个 ResponseEntity<T> 对象，其中包括响应状态码、响应头和反序列化后的响应体数据。

DEMO

import org.springframework.http.ResponseEntity;
import org.springframework.web.client.RestTemplate;

public class RestTemplateExample {
    public static void main(String[] args) {
        RestTemplate restTemplate = new RestTemplate();
        
        // 请求体数据
        MyRequest request = new MyRequest("Hello, World!");
        
        // 发送 HTTP POST 请求并接收响应
        ResponseEntity<MyResponse> responseEntity = restTemplate.postForEntity("https://example.com/api/resource", request, MyResponse.class);
        
        // 提取响应状态码
        int statusCode = responseEntity.getStatusCodeValue();
        
        // 提取响应体数据
        MyResponse responseBody = responseEntity.getBody();
        
        System.out.println("Response Status Code: " + statusCode);
        System.out.println("Response Body: " + responseBody);
    }
}

在这个demo中，使用 postForEntity 方法向 https://example.com/api/resource 发送 HTTP POST 请求，发送了一个 MyRequest 对象作为请求体数据，然后提取了响应的状态码和反序列化后的响应体数据。

实战

ResponseEntity<String> responseEntity = restTemplate.postForEntity(redirectionUrl, new HttpEntity<>(resource, httpHeaders), String.class);

使用 Spring 的 RestTemplate 发送一个 HTTP POST 请求，并从响应中获取一个 ResponseEntity<String> 对象。

ResponseEntity<String> responseEntity：这是一个用于存储 HTTP POST 请求的响应的对象。ResponseEntity 是 Spring Framework 提供的一种数据结构，它包含了响应的状态码、响应头和响应体。

restTemplate：这是一个已配置的 RestTemplate 对象，用于发送 HTTP 请求。通常需要在应用中配置和初始化 RestTemplate 实例。

postForEntity：这是 RestTemplate 的方法，用于发送 HTTP POST 请求并返回一个 ResponseEntity 对象。它接受以下参数：

redirectionUrl：这是目标 URL，表示将 HTTP POST 请求发送到哪里。

new HttpEntity<>(resource, httpHeaders)：这是 HTTP 请求的请求体。HttpEntity 是 Spring Framework 提供的包装器，它包含请求体数据（resource）和请求头（httpHeaders）。resource 是一个文件流。httpHeaders 可以包含请求头信息，如授权信息、内容类型、自定义标头等。

String.class：这是期望的响应数据类型。在这种情况下，期望响应体被解析为字符串。

执行 postForEntity 方法会执行以下步骤：

RestTemplate 构建一个 HTTP POST 请求，将请求体数据（new HttpEntity<>(resource, httpHeaders)）包含在请求中。

RestTemplate 发送 HTTP POST 请求到指定的 redirectionUrl。

服务端响应返回时，RestTemplate 接收响应，包括响应头和响应体。

响应体的数据（通常是字符串）会被反序列化为 String 类型。

最后，postForEntity 方法返回一个 ResponseEntity 对象，其中包括响应状态码、响应头和反序列化后的响应体字符串。

responseEntity 包含了整个 HTTP POST 请求的响应信息，你可以使用它来获取响应状态码、响应头、响应体等信息。

HttpStatus statusCode = responseEntity.getStatusCode();  // 获取响应状态码
HttpHeaders responseHeaders = responseEntity.getHeaders();  // 获取响应头
String responseBody = responseEntity.getBody();  // 获取响应体

RestTemplate 对于与远程服务进行通信和处理响应非常有用！！！