RestTemplate.postForEntity 方法进行 HTTP POST 请求

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

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

参数说明：

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

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

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

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

工作原理：

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

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

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

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

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

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

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 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 responseEntity = restTemplate.postForEntity(redirectionUrl, new HttpEntity<>(resource, httpHeaders), String.class);

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

ResponseEntity 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 对于与远程服务进行通信和处理响应非常有用！！！