Java RestTemplate發送POST請求

一、RestTemplate簡介

RestTemplate是Spring框架提供的一個核心類，用於發送HTTP請求，它集成了多種發送HTTP請求的方法，可以大大簡化發送HTTP請求的代碼編寫。

二、使用RestTemplate發送POST請求

使用RestTemplate發送POST請求很簡單，只需要使用其中的postForObject()方法即可。下面是發送POST請求的示例代碼：

HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_JSON);
JSONObject params = new JSONObject();
params.put("name", "張三");
params.put("age", 20);
HttpEntity request = new HttpEntity(params.toJSONString(), headers);
String url = "http://localhost:8080/user";
RestTemplate restTemplate = new RestTemplate();
String result = restTemplate.postForObject(url, request, String.class);
System.out.println(result);

上面的代碼中，我們首先創建了一個HttpHeaders對象，並設置其Content-Type為application/json，然後使用JSONObject對象創建了一個包含姓名和年齡的JSON字元串，並將其設置為HttpEntity的body。接著，我們創建了一個RestTemplate對象，並使用postForObject()方法發送POST請求，並傳遞了URL、HttpEntity和返回值類型作為參數。最後，我們列印出了伺服器返回的結果。

三、處理伺服器返回值

當伺服器返回的結果是JSON字元串時，我們可以使用JSON庫（如fastjson）將其轉換為Java對象。下面是示例代碼：

String result = restTemplate.postForObject(url, request, String.class);
JSONObject jsonResult = JSON.parseObject(result);
User user = JSONObject.toJavaObject(jsonResult.getJSONObject("user"), User.class);

上述代碼中，我們首先使用RestTemplate發送POST請求並得到伺服器返回的JSON字元串，然後使用fastjson將其轉換為JSONObject對象，並從中獲取User對象並轉換為Java對象。

四、處理異常情況

在發送HTTP請求時，可能會出現一些異常情況，例如連接超時、伺服器返回錯誤等。為了避免這些異常影響我們的程序正常運行，我們可以捕獲這些異常並進行相應的處理。下面是示例代碼：

try {
    String result = restTemplate.postForObject(url, request, String.class);
    JSONObject jsonResult = JSON.parseObject(result);
    User user = JSONObject.toJavaObject(jsonResult.getJSONObject("user"), User.class);
} catch (HttpStatusCodeException e) {
    String responseBodyAsString = e.getResponseBodyAsString();
    log.error("伺服器返回錯誤：" + responseBodyAsString);
} catch (RestClientException e) {
    log.error("發送HTTP請求失敗：" + e.getMessage());
} catch (Exception e) {
    log.error("未知異常：" + e.getMessage());
}

上述代碼中，我們使用try-catch語句捕獲了HTTP狀態碼錯誤和其他RestClientException異常，分別輸出了錯誤信息。同時，我們也捕獲了其他未知異常，並輸出了其異常信息。

五、使用RestTemplate發送帶有Header的POST請求

有些情況下，我們需要在HTTP請求頭中添加一些定製化的信息，例如Authorization等，此時我們需要在HttpHeaders中設置對應的Header信息，然後將其作為HttpEntity的頭信息發送。下面是示例代碼：

HttpHeaders headers = new HttpHeaders();
headers.set("Authorization", "Bearer " + accessToken);
headers.setContentType(MediaType.APPLICATION_JSON);
JSONObject params = JSONObject.parseObject("{\"name\": \"張三\", \"age\": 20}");
HttpEntity request = new HttpEntity(params.toJSONString(), headers);
String url = "http://localhost:8080/user";
RestTemplate restTemplate = new RestTemplate();
String result = restTemplate.postForObject(url, request, String.class);
System.out.println(result);

上述代碼中，我們使用HttpHeaders對象設置了Authorization和Content-Type兩個Header信息，然後將其作為HttpEntity的頭信息發送了POST請求，其中accessToken是我們自己的token。

六、使用RestTemplate發送帶有附件的POST請求

有些情況下，我們需要在POST請求中攜帶附件，例如PDF、圖片等文件，此時我們需要將文件流作為附件添加到HttpEntity中，並設置對應的Content-Disposition頭信息。下面是示例代碼：

HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.MULTIPART_FORM_DATA);
FileSystemResource fileSystemResource = new FileSystemResource(new File("filepath.pdf"));
MultiValueMap form = new LinkedMultiValueMap();
form.add("file", fileSystemResource);
form.add("type", "pdf");
HttpEntity<MultiValueMap> requestEntity = new HttpEntity(form, headers);
String url = "http://localhost:8080/file/upload";
RestTemplate restTemplate = new RestTemplate();
String result = restTemplate.postForObject(url, requestEntity, String.class);
System.out.println(result);

上述代碼中，我們首先創建了一個HttpHeaders對象，並將其Content-Type設置為multipart/form-data，然後使用FileSystemResource對象讀取文件並創建MultiValueMap。接著，我們將MultiValueMap作為HttpEntity的body，並設置Content-Disposition頭信息，最後使用RestTemplate發送POST請求，並獲取伺服器返回的結果。

七、小結

使用RestTemplate發送POST請求是非常簡單的，只需要參照上述示例代碼，根據具體場景設置正確的請求頭信息和請求參數即可。同時，對於異常情況的處理也是非常重要的，必要時我們需要列印詳細的錯誤信息以便快速定位問題。