RestTemplate().postForEntity的參數(shù)使用及說(shuō)明

更新時(shí)間：2025年12月08日 09:42:33 作者：W風(fēng)灬

`RestTemplate().postForEntity()`是SpringFramework中用于發(fā)送HTTP POST請(qǐng)求并獲取響應(yīng)的方法,該方法接受目標(biāo)URL、請(qǐng)求體、期望的響應(yīng)類(lèi)型以及可選的變量參數(shù),并返回一個(gè)包含HTTP響應(yīng)信息的`ResponseEntity`對(duì)象

RestTemplate().postForEntity的參數(shù)

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

該方法的參數(shù)詳解

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

注意事項(xiàng)

如果使用 url 參數(shù)，uriVariables 參數(shù)將用于替換 URL 中的占位符。
如果使用 uri 參數(shù)，則忽略 url 和 uriVariables 參數(shù)。
如果請(qǐng)求需要設(shè)置請(qǐng)求頭或其他配置信息，可以使用 HttpEntity 對(duì)象構(gòu)建請(qǐng)求。

方法返回一個(gè) ResponseEntity 對(duì)象，其中包含 HTTP 響應(yīng)的狀態(tài)碼、響應(yīng)頭以及解析后的響應(yīng)體。你可以通過(guò) ResponseEntity 對(duì)象獲取所需的數(shù)據(jù)。

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

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

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

        // 請(qǐng)求 URL
        String url = "http://example.com/api";

        // 構(gòu)建請(qǐng)求體
        User user = new User("John", 30); // 自定義 User 類(lèi)
        HttpEntity<User> request = new HttpEntity<>(user);

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

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

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

也可以使用Map傳遞Json數(shù)據(jù)，例如

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

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