二者的主要區(qū)別在于，postForObject()返回值是HTTP協(xié)議的響應(yīng)體。postForEntity()返回的是ResponseEntity，ResponseEntity是對HTTP響應(yīng)的封裝，除了包含響應(yīng)體，還包含HTTP狀態(tài)碼、contentType、contentLength、Header等信息。

一、postForObject發(fā)送JSON格式請求

寫一個單元測試用例，測試用例的內(nèi)容是向指定的URL提交一個Post(帖子).

@SpringBootTest
class PostTests {
   @Resource
   private RestTemplate restTemplate;
   @Test
   void testSimple()  {
      // 請求地址
      String url = "http://jsonplaceholder.typicode.com/posts";
      // 要發(fā)送的數(shù)據(jù)對象
      PostDTO postDTO = new PostDTO();
      postDTO.setUserId(110);
      postDTO.setTitle("zimug 發(fā)布文章");
      postDTO.setBody("zimug 發(fā)布文章 測試內(nèi)容");
      // 發(fā)送post請求，并輸出結(jié)果
      PostDTO result = restTemplate.postForObject(url, postDTO, PostDTO.class);
      System.out.println(result);
   }
}

jsonplaceholder.typicode.com是一個可以提供在線免費(fèi)RESTful測試服務(wù)的一個網(wǎng)站”

/posts"服務(wù)接收PostDTO 參數(shù)對象，并將請求結(jié)果以JSON字符串的形式進(jìn)行響應(yīng)。響應(yīng)結(jié)果就是請求參數(shù)對象對應(yīng)的JSON字符串。

所以postForObject方法第二個參數(shù)是請求數(shù)據(jù)對象，第三個參數(shù)是返回值類型

最終將返回值的打印結(jié)果如下：

二、postForObject模擬表單數(shù)據(jù)提交

下面給大家寫一個使用postForObject模擬表單數(shù)據(jù)提交的例子，即：提交x-www-form-urlencoded格式的數(shù)據(jù)

@Test
public void testForm() {
   // 請求地址
   String url = "http://jsonplaceholder.typicode.com/posts";
   // 請求頭設(shè)置,x-www-form-urlencoded格式的數(shù)據(jù)
   HttpHeaders headers = new HttpHeaders();
   headers.setContentType(MediaType.APPLICATION_FORM_URLENCODED);
   //提交參數(shù)設(shè)置
   MultiValueMap<String, String> map = new LinkedMultiValueMap<>();
   map.add("title", "zimug 發(fā)布文章第二篇");
   map.add("body", "zimug 發(fā)布文章第二篇 測試內(nèi)容");
   // 組裝請求體
   HttpEntity<MultiValueMap<String, String>> request =
               new HttpEntity<MultiValueMap<String, String>>(map, headers);
   // 發(fā)送post請求，并打印結(jié)果，以String類型接收響應(yīng)結(jié)果JSON字符串
   String result = restTemplate.postForObject(url, request, String.class);
   System.out.println(result);
}

請求數(shù)據(jù)打印結(jié)果如下：

三、 url支持占位符語法

如果url地址上面需要傳遞一些動態(tài)參數(shù)，可以使用占位符的方式：

String url = "http://jsonplaceholder.typicode.com/{1}/{2}";
String url = "http://jsonplaceholder.typicode.com/{type}/{id}";

具體的用法和使用GET方法請求是一致的

所以請參考： RestTemplate發(fā)送HTTP GET請求使用方法詳解

四、postForEntity()方法

上面的所有的postForObject請求傳參方法，postForEntity都可以使用，使用方法上也幾乎是一致的，只是在返回結(jié)果接收的時候略有差別。

使用ResponseEntity<T> responseEntity來接收響應(yīng)結(jié)果。用responseEntity.getBody()獲取響應(yīng)體。響應(yīng)體內(nèi)容同postForObject方法返回結(jié)果一致。剩下的這些響應(yīng)信息就是postForEntity比postForObject多出來的內(nèi)容。

HttpStatus statusCode = responseEntity.getStatusCode();獲取整體的響應(yīng)狀態(tài)信息

int statusCodeValue = responseEntity.getStatusCodeValue(); 獲取響應(yīng)碼值

HttpHeaders headers = responseEntity.getHeaders();獲取響應(yīng)頭等

@Test
public void testEntityPoJo() {
   // 請求地址
   String url = "http://jsonplaceholder.typicode.com/posts";
   // 要發(fā)送的數(shù)據(jù)對象
   PostDTO postDTO = new PostDTO();
   postDTO.setUserId(110);
   postDTO.setTitle("zimug 發(fā)布文章");
   postDTO.setBody("zimug 發(fā)布文章 測試內(nèi)容");
   // 發(fā)送post請求，并輸出結(jié)果
   ResponseEntity<String> responseEntity
               = restTemplate.postForEntity(url, postDTO, String.class);
   String body = responseEntity.getBody(); // 獲取響應(yīng)體
   System.out.println("HTTP 響應(yīng)body：" + postDTO.toString());
   //以下是postForEntity比postForObject多出來的內(nèi)容
   HttpStatus statusCode = responseEntity.getStatusCode(); // 獲取響應(yīng)碼
   int statusCodeValue = responseEntity.getStatusCodeValue(); // 獲取響應(yīng)碼值
   HttpHeaders headers = responseEntity.getHeaders(); // 獲取響應(yīng)頭
   System.out.println("HTTP 響應(yīng)狀態(tài)：" + statusCode);
   System.out.println("HTTP 響應(yīng)狀態(tài)碼：" + statusCodeValue);
   System.out.println("HTTP Headers信息：" + headers);
}

輸出打印結(jié)果

五、postForLocation() 方法的使用

postForLocation的傳參的類型、個數(shù)、用法基本都和postForObject()或postForEntity()一致。和前兩者的唯一區(qū)別在于返回值是一個URI。該URI返回值體現(xiàn)的是：用于提交完成數(shù)據(jù)之后的頁面跳轉(zhuǎn)，或數(shù)據(jù)提交完成之后的下一步數(shù)據(jù)操作URI。

@Test
public void testURI() {
   // 請求地址
   String url = "http://jsonplaceholder.typicode.com/posts";
   PostDTO postDTO = new PostDTO();
   postDTO.setUserId(110);
   postDTO.setTitle("zimug 發(fā)布文章");
   postDTO.setBody("zimug 發(fā)布文章 測試內(nèi)容");
   // 發(fā)送post請求，并輸出結(jié)果
   URI uri = restTemplate.postForLocation(url,postDTO);
   System.out.println(uri);
}

輸出結(jié)果如下，含義是：提交了post之后，該post的id是101，可以通過如下的連接去獲取數(shù)據(jù)。