RestTemplate().postForEntity的參數使用及說明

更新時間：2025年12月08日 09:42:33 作者：W風灬

`RestTemplate().postForEntity()`是SpringFramework中用于發(fā)送HTTP POST請求并獲取響應的方法,該方法接受目標URL、請求體、期望的響應類型以及可選的變量參數,并返回一個包含HTTP響應信息的`ResponseEntity`對象

RestTemplate().postForEntity的參數

RestTemplate().postForEntity() 是 Spring Framework 提供的一個用于發(fā)送 HTTP POST 請求并獲取響應的方法。

該方法的參數詳解

url（String 類型）：請求的目標 URL?？梢允且粋€字符串形式的 URL，也可以是一個 URI 對象。示例：“http://example.com/api”。
request（Object 類型）：表示要發(fā)送的請求體內容?？梢允且粋€簡單對象、一個 HttpEntity 對象或一個 MultiValueMap（用于傳遞表單數據）。根據實際需要確定所需的請求體內容。
responseType（Class 類型）：表示期望的響應類型?？梢允侨魏?Java 類型，包括自定義類型。例如，如果期望返回一個 User 對象，則可以將其設置為 User.class。
uriVariables（Object… 類型）：可選參數，用于填充 URL 中的占位符。如果 URL 中包含占位符，可以通過這個參數來提供具體的值。
uri（URI 類型）：可選參數，代替 url 參數，用于指定完整的請求目標 URI。

注意事項

如果使用 url 參數，uriVariables 參數將用于替換 URL 中的占位符。
如果使用 uri 參數，則忽略 url 和 uriVariables 參數。
如果請求需要設置請求頭或其他配置信息，可以使用 HttpEntity 對象構建請求。

方法返回一個 ResponseEntity 對象，其中包含 HTTP 響應的狀態(tài)碼、響應頭以及解析后的響應體。你可以通過 ResponseEntity 對象獲取所需的數據。

以下是一個使用 RestTemplate().postForEntity() 方法發(fā)送 POST 請求的示例代碼：

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

public class RestTemplateExample {
    public static void main(String[] args) {
        RestTemplate restTemplate = new RestTemplate();

        // 請求 URL
        String url = "http://example.com/api";

        // 構建請求體
        User user = new User("John", 30); // 自定義 User 類
        HttpEntity<User> request = new HttpEntity<>(user);

        // 發(fā)送 POST 請求并獲取響應
        ResponseEntity<String> response = restTemplate.postForEntity(url, request, String.class);

        // 獲取響應結果
        HttpStatus statusCode = response.getStatusCode();
        HttpHeaders headers = response.getHeaders();
        String body = response.getBody();

        // 處理響應結果
        System.out.println("Status Code: " + statusCode);
        System.out.println("Response Headers: " + headers);
        System.out.println("Response Body: " + body);
    }
}

也可以使用Map傳遞Json數據，例如

Map<String, Object> requestMap = new HashMap<>();
  // 發(fā)動機型號
requestMap.put("engine_model", "1234");
// 發(fā)動機編號
requestMap.put("engine_code", "6789"); 
  // 請求 URL
String url = "http://example.com/api";
 // 調對方接口
ResponseEntity<String> responseEntity = new RestTemplate().postForEntity(url, requestMap , String.class);
Map<String, Object> responseBodyMap = GsonUtil.gsonToMaps(responseEntity.getBody());
 // 對方接口返回值  true傳輸成功 false  失敗
Map<String, Object> result = (Map<String, Object>) responseBodyMap.get("result");
boolean isSuccess = (Boolean) result.get("success");

根據上述的布爾值判斷接口是否調用成功，進行后續(xù)邏輯。