spring的RestTemplate

参考资料:spring-framework-reference:
1.Accessing RESTful services on the Client
2.Bean scopes下的Session scope

使用java来调用RESTful服务,我们一般会通过HttpClient助手类.其中RestTemplate提供了6种主要Http方法(即DELETE,GET,HEAD,OPTIONS,POST,PUT)的每一种相应更高级别的方法,实现最佳实践.
我们可以简单地调用默认无参构造方法来创建RestTemplate实例,这是使用来自于java.net包的标准java类作为底层实现来创建HTTP请求.这个也可以指定ClientHttpRequestFactory的实现来重写.spring提供了使用Apache HttpComponents的实现HttpComponentsClientHttpRequestFactory来创建请求.使用org.apache.http.client.HttpClient的一个实例来配置HttpComponentsClientHttpRequestFactory,它能配置凭据信息或连接池功能.由spring使用jdk自带类实现的org.springframework.http.client.SimpleClientHttpRequestFactory并不具备存储用户会话的功能.
用法:RestTemplate template = new RestTemplate(new HttpComponentsClientHttpRequestFactory());

下面是使用RestTemplate的一个简单例子,至于RestTemplate的API就不介绍了.

1.引入httpclient依赖,在pom.xml加入

<dependency><groupId>org.apache.httpcomponents</groupId><artifactId>httpclient</artifactId><version>4.3.3</version></dependency>

2.在MvcConfig注册RestTemplate Bean.

@Bean@Scope(value = WebApplicationContext.SCOPE_SESSION,proxyMode = ScopedProxyMode.INTERFACES)public RestTemplate restTemplate(){ClientHttpRequestFactory clientHttpRequestFactory = new HttpComponentsClientHttpRequestFactory();return new RestTemplate(clientHttpRequestFactory);}

因为这样的模板工具是属于Web层的东西,放在Web配置更合理.再有,对于scope为session的Bean也必须在WebApplicationContext下使用,如果是在常规的spring容器(即非web环境)下使用会抛IllegalStateException,这点spring-framework-reference有提及.至于这里为什么要使用session的Bean,下面会做分析.

3.在Controller下使用,当然在单元测试也可以使用.

@Controller  public class DefaultController {      @Autowired      private RestOperations restOperations;      @RequestMapping("/test")      public String test(String url){          //get请求        String result=restOperations.getForObject(url, String.class);          System.out.println(result);                  //post请求,注意:参数不是传给uriVariables,uriVariables是用于设置uri参数变量的        final MultiValueMap<String, Object> params = new LinkedMultiValueMap<>();        params.add("username", "124124");        params.add("age", "28");        //params.add("file", new MockMultipartFile("test.txt", "sfasfsf".getBytes("UTF-8")));       result = new RestTemplate().postForObject(url, params, String.class);      //result = new RestTemplate().postForObject(url, new HttpEntity<>(params, null), String.class);                        return "user/add";      }  }  

这里注入RestTemplate的代理实例(因为上面代理是通过JDK生成的,所以这里要用接口注入)供Controller的方法使用.这里的意图就是,传入一个url,然后根据这个url发起请求(不传入参数,是为了简单),返回字符串形式的响应.对于普通的请求参数(不含上传文件),应使用MultiValueMap<String, String>类型,理由如下,先看org.springframework.http.converter.FormHttpMessageConverter#write

public void write(MultiValueMap<String, ?> map, MediaType contentType, HttpOutputMessage outputMessage)        throws IOException, HttpMessageNotWritableException {    if (!isMultipart(map, contentType)) {        writeForm((MultiValueMap<String, String>) map, contentType, outputMessage);    } else {        writeMultipart((MultiValueMap<String, Object>) map, outputMessage);    }}private boolean isMultipart(MultiValueMap<String, ?> map, MediaType contentType) {    if (contentType != null) {        return MediaType.MULTIPART_FORM_DATA.includes(contentType);    }    for (String name : map.keySet()) {        for (Object value : map.get(name)) {            if (value != null && !(value instanceof String)) {                return true;            }        }    }    return false;}

从isMultipart方法可以看出value不为空且全是String类型才认为不是Multipart请求,参数会以key1=value1&key2=value2形式写入请求体,在springMvc的controller方法public String list(String username,Integer age){}是可以正常映射.对于Multipart请求,请求的另一种形式--9EGuVcL0OtjH40Pnd-MjN5Cs6xyUM9FPzXContent-Disposition: form-data; name="username"Content-Type: text/plain;charset=ISO-8859-1Content-Length: 9124124--9EGuVcL0OtjH40Pnd-MjN5Cs6xyUM9FPzXContent-Disposition: form-data; name="age"Content-Type: application/json;charset=UTF-828这种传Multipart形式请求(如果有上传文件,不能用get请求传输,并且要指定为这种Multipart,我也郁闷没用restTemplate成功上传过文件),在springMvc不配MultipartResolver,参数是不能正常解析的.虽然可能不会报错.但只要在servletApplicationContext声明以下Bean就可以

<dependency>    <groupId>commons-fileupload</groupId>    <artifactId>commons-fileupload</artifactId>    <version>1.3.1</version></dependency>

@Beanpublic MultipartResolver multipartResolver() {    CommonsMultipartResolver bean = new CommonsMultipartResolver();    bean.setDefaultEncoding("UTF-8");    return bean;}

有了MultipartResolver之后,上面的params.add("age","28");改为params.add("age",28);完全没问题

4.测试.就拿前文作为服务端测试例子,此例对于要从/user/list获取数据,用户必须有"user_list"的权限,如果用户没登录,没有这权限,就会返回403,禁止访问.a.先模拟用户登录,在浏览器输入:http://localhost:8081/web2/test?url=http://localhost:8080/web1/user/login?id=1b.然后在用户登录的前提下去获取数据,再输入:http://localhost:8081/web2/test?url=http://localhost:8080/web1/user/list这测试都很顺利正常,下面分析为什么要用session的Bean(建议看spring-framework-reference的Session scope):因为对于不同的用户有不同的会话,如果使用singleton的话,那么会造成所有的用户都共用这个RestTemplate,并不希望有一个用户登录了,另一个用户根本没有登录,就可以前一个用户的身份去发请求,再有新登录的用户也会覆盖旧用户登录的信息.使用了session的restTemplate Bean即可解决此问题.这样使用,它的有效作用范围就是HTTP会话级别,即不同的会话,DefaultController的restOperations会注入不同的代理.(为什么要使用代理,建议去看spring-framework-reference的Scoped beans as dependencies,代理有两种,这里使用基于JDK).