在REST接口的設(shè)計(jì)中，利用RestTemplate進(jìn)行接口測試是種常見的方法，但在使用過程中，由于其方法參數(shù)眾多，很多同學(xué)又混淆了表單提交與Payload提交方式的差別，而且接口設(shè)計(jì)與傳統(tǒng)的瀏覽器使用的提交方式又有差異，經(jīng)常出現(xiàn)各種各樣的錯(cuò)誤，如405錯(cuò)誤，或者根本就得不到提交的數(shù)據(jù)，錯(cuò)誤樣例如下：

Exception in thread "main" org.springframework.web.client.HttpClientErrorException: 405 Method Not Allowed
    at org.springframework.web.client.DefaultResponseErrorHandler.handleError(DefaultResponseErrorHandler.java:63)
    at org.springframework.web.client.RestTemplate.handleResponse(RestTemplate.java:700)
    at org.springframework.web.client.RestTemplate.doExecute(RestTemplate.java:653)
    at org.springframework.web.client.RestTemplate.execute(RestTemplate.java:613)
    at org.springframework.web.client.RestTemplate.exchange(RestTemplate.java:531)

1. 用exchange方法提交

exchange既可以執(zhí)行POST方法，還可以執(zhí)行GET，所以應(yīng)用最為廣泛，使用方法如下：

String url = "http://localhost/mirana-ee/app/login";
RestTemplate client = new RestTemplate();
HttpHeaders headers = new HttpHeaders();
// 請勿輕易改變此提交方式，大部分的情況下，提交方式都是表單提交
headers.setContentType(MediaType.APPLICATION_FORM_URLENCODED);
// 封裝參數(shù)，千萬不要替換為Map與HashMap，否則參數(shù)無法傳遞
MultiValueMap<String, String> params= new LinkedMultiValueMap<String, String>();
// 也支持中文
params.add("username", "用戶名");
params.add("password", "123456");
HttpEntity<MultiValueMap<String, String>> requestEntity = new HttpEntity<MultiValueMap<String, String>>(params, headers);
// 執(zhí)行HTTP請求
ResponseEntity<String> response = client.exchange(url, HttpMethod.POST, requestEntity, String.class);
// 輸出結(jié)果
System.out.println(response.getBody());

2. 用postForEntity進(jìn)行提交

postForEntity是對exchange的簡化，僅僅只需要減少HttpMethod.POST參數(shù)，如下：

// 上面的代碼完全一樣
// 僅需替換exchange方法
ResponseEntity<String> response = client.postForEntity(url, requestEntity , String.class );

3. 關(guān)于表單提交與Payload提交的差異

在Controller的方法參數(shù)中，如果將“@ModelAttribute”改為“@RequestBody”注解，則此時(shí)的提交方式為Payload方式提交，代碼示例如下：

// 請注意@RequestBody注解
@RequestMapping(value="/login", method=RequestMethod.POST, consumes="application/json")
// 千萬不要畫蛇添足添加@ModelAttribute，否則會(huì)被其覆蓋，如下
// public Account getAccount(@RequestBody@ModelAttribute Account account)
public Account getAccount(@RequestBody Account account) {
  account.setVersion(new Date());
  return account;
}

再次強(qiáng)調(diào)一次，千萬不要畫蛇添足再次添加“@ModelAttribute”，因?yàn)槠鋬?yōu)先級比較高，所以系統(tǒng)會(huì)采用表單方式解析提交內(nèi)容。

對于Payload方式，提交的內(nèi)容一定要是String，且Header要設(shè)置為“application/json”，示例如下：

// 請求地址
String url = "http://localhost/mirana-ee/app/login";
RestTemplate client = new RestTemplate();
// 一定要設(shè)置header
HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_JSON_UTF8);
// 將提交的數(shù)據(jù)轉(zhuǎn)換為String
// 最好通過bean注入的方式獲取ObjectMapper
ObjectMapper mapper = new ObjectMapper();
Map<String, String> params= Maps.newHashMap();
params.put("username", "國米");
params.put("password", "123456");
String value = mapper.writeValueAsString(params);
HttpEntity<String> requestEntity = new HttpEntity<String>(value, headers);
// 執(zhí)行HTTP請求
ResponseEntity<String> response = client.postForEntity(url, requestEntity , String.class );
System.out.println(response.getBody());

如果內(nèi)容不是以String方式提交，那么一定會(huì)出現(xiàn)以下錯(cuò)誤：

Exception in thread "main" org.springframework.web.client.HttpClientErrorException: 400 Bad Request
    at org.springframework.web.client.DefaultResponseErrorHandler.handleError(DefaultResponseErrorHandler.java:63)
    at org.springframework.web.client.RestTemplate.handleResponse(RestTemplate.java:700)
    at org.springframework.web.client.RestTemplate.doExecute(RestTemplate.java:653)
    at org.springframework.web.client.RestTemplate.execute(RestTemplate.java:613)
    at org.springframework.web.client.RestTemplate.postForEntity(RestTemplate.java:407)

最后需要強(qiáng)調(diào)的是，通過@RequestBody是無法獲取到請求參數(shù)，如將上面服務(wù)端的代碼改為如下格式，則肯定得不到數(shù)據(jù)，但表單提交則相反。

@RequestMapping(value="/login", consumes="application/json", method=RequestMethod.POST)
public Account getAccount(@RequestBody Account account, HttpServletRequest request) {
  // 肯定得不到參數(shù)值
  System.out.println(request.getParameter("username"));
  account.setVersion(new Date());
  return account;
}

4. HttpEntity的結(jié)構(gòu)

HttpEntity是對HTTP請求的封裝，包含兩部分，header與body，header用于設(shè)置請求頭，而body則用于設(shè)置請求體，所以其的構(gòu)造器如下：

// value為請求體
// header為請求頭
HttpEntity<String> requestEntity = new HttpEntity<String>(value, headers);

5. HttpEntity與uriVariables

在RestTemplate的使用中，HttpEntity用于傳遞具體的參數(shù)值，而uriVariables則用于格式化Http地址，而不是地址參數(shù)，正確的用法如下：

// 在地址中加入格式化參數(shù)path
String url = "http://localhost/mirana-ee/app/{path}";
// 準(zhǔn)備格式化參數(shù)
Map<String, String> varParams = Maps.newHashMap();
varParams.put("path", "login");
// 其他代碼略
// 格式化提交地址
ResponseEntity<String> response = client.postForEntity(url, requestEntity , String.class, varParams);

6. 關(guān)于HttpMessageConverter的說明

在網(wǎng)上的很多例子中，我發(fā)現(xiàn)很多人為了處理Payload提交，都添加了自定義的HttpMessageConverter，如下：

// 完全沒有必要
client.getMessageConverters().add(new MappingJackson2HttpMessageConverter());
client.getMessageConverters().add(new StringHttpMessageConverter());

然后，經(jīng)過我查看源碼與調(diào)試發(fā)現(xiàn)，RestTemplate內(nèi)置了7種HttpMessageConverter，如下：

1. org.springframework.http.converter.ByteArrayHttpMessageConverter
2. org.springframework.http.converter.StringHttpMessageConverter
3. org.springframework.http.converter.ResourceHttpMessageConverter
4. org.springframework.http.converter.xml.SourceHttpMessageConverter
5. org.springframework.http.converter.support.AllEncompassingFormHttpMessageConverter
6. org.springframework.http.converter.xml.Jaxb2RootElementHttpMessageConverter
7. org.springframework.http.converter.json.MappingJackson2HttpMessageConverter
“`

結(jié)論

RestTemplate能大幅簡化了提交表單數(shù)據(jù)的難度，并且附帶了自動(dòng)轉(zhuǎn)換JSON數(shù)據(jù)的功能，但只有理解了HttpEntity的組成結(jié)構(gòu)（header與body），且理解了與uriVariables之間的差異，才能真正掌握其用法。

以上就是本文的全部內(nèi)容，希望對大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

最新評論