RestTemplate提交表单数据的三种方法

用exchange方法提交

exchange既能够执行POST方法，还能够执行GET，因此应用最为普遍，使用方法以下：

String url = "http://localhost/mirana-ee/app/login";
RestTemplate client = new RestTemplate();
HttpHeaders headers = new HttpHeaders();
//  请勿轻易改变此提交方式，大部分的状况下，提交方式都是表单提交
headers.setContentType(MediaType.APPLICATION_FORM_URLENCODED);
//  封装参数，千万不要替换为Map与HashMap，不然参数没法传递
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);
//  执行HTTP请求
ResponseEntity<String> response = client.exchange(url, HttpMethod.POST, requestEntity, String.class);
//  输出结果
System.out.println(response.getBody());

用postForEntity进行提交

postForEntity是对exchange的简化，仅仅只须要减小HttpMethod.POST参数，以下：

//  上面的代码彻底同样
//  仅需替换exchange方法
ResponseEntity<String> response = client.postForEntity(url, requestEntity , String.class );

关于表单提交与Payload提交的差别

在Controller的方法参数中，若是将“@ModelAttribute”改成“@RequestBody”注解，则此时的提交方式为Payload方式提交，详细的差别请参见《 $.ajax使用总结(一)：Form提交与Payload提交》，代码示例以下：

//  请注意@RequestBody注解
@RequestMapping(value="/login", method=RequestMethod.POST, consumes="application/json")
//  千万不要多此一举添加@ModelAttribute，不然会被其覆盖，以下
//  public Account getAccount(@RequestBody@ModelAttribute Account account)
public Account getAccount(@RequestBody Account account) {
    account.setVersion(new Date());
    return account;
}

再次强调一次，千万不要多此一举再次添加“@ModelAttribute”，由于其优先级比较高，因此系统会采用表单方式解析提交内容。

对于Payload方式，提交的内容必定要是String，且Header要设置为“application/json”，示例以下：

//  请求地址
String url = "http://localhost/mirana-ee/app/login";
RestTemplate client = new RestTemplate();
//  必定要设置header
HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_JSON_UTF8);
//  将提交的数据转换为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);
//  执行HTTP请求
ResponseEntity<String> response = client.postForEntity(url, requestEntity , String.class );
System.out.println(response.getBody());

若是内容不是以String方式提交，那么必定会出现如下错误：

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)

最后须要强调的是，经过@RequestBody是没法获取到请求参数，如将上面服务端的代码改成以下格式，则确定得不到数据，但表单提交则相反。

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

HttpEntity的结构

在RestTemplate的使用中，HttpEntity用于传递具体的参数值，而uriVariables则用于格式化Http地址，而不是地址参数，正确的用法以下：

入格式化参数path
String url = "http://localhost/mirana-ee/app/{path}";
//  准备格式化参数
Map<String, String> varParams = Maps.newHashMap();
varParams.put("path", "login");
//  其余代码略
//  格式化提交地址
ResponseEntity<String> response = client.postForEntity(url, requestEntity , String.class, varParams);

关于HttpMessageConverter的说明

在网上的不少例子中，我发现不少人为了处理Payload提交，都添加了自定义的HttpMessageConverter，以下：

//  彻底没有必要
client.getMessageConverters().add(new MappingJackson2HttpMessageConverter());
client.getMessageConverters().add(new StringHttpMessageConverter());

而后，通过我查看源码与调试发现，RestTemplate内置了7种HttpMessageConverter，以下：

org.springframework.http.converter.ByteArrayHttpMessageConverter 
org.springframework.http.converter.StringHttpMessageConverter 
org.springframework.http.converter.ResourceHttpMessageConverter 
org.springframework.http.converter.xml.SourceHttpMessageConverter 
org.springframework.http.converter.support.AllEncompassingFormHttpMessageConverter 
org.springframework.http.converter.xml.Jaxb2RootElementHttpMessageConverter 
org.springframework.http.converter.json.MappingJackson2HttpMessageConverter

结论

RestTemplate能大幅简化了提交表单数据的难度，而且附带了自动转换JSON数据的功能，但只有理解了HttpEntity的组成结构（header与body），且理解了与uriVariables之间的差别，才能真正掌握其用法。