SpringBoot学习记录(九)：使用RestTemplate发送http请求详解
RestTemplate简介
RestTemplate是Spirng提供的远程访问http的工具，大幅度降低了提交表单的难度，并附带自动转换JSON的功能。工具底层默认使用SimpleClientHttpRequestFactory作为连接工具，当然也可以通过setRequestFactory进行连接方式覆盖。
方法列表
| 方式 | 方法名 |
|---|---|
| GET | getForentity getForObject |
| POST | postForentity postForObject |
| PUT | put |
| DELETE | delete |
方法案例
测试之前首先创建一个restful服务
@RestController
public class TestController {
@RequestMapping(value="/test1{test}")
public String getTest1(@RequestParam String test) {
return "this is server source ----" + test;
}
@RequestMapping(value="/test2")
public String getTest2() {
return "this is server source ---- null";
}
}
再创建一个SpringBoot项目
RestTemplate配置类
@Configuration
public class RestTemplateConfig {
@Bean
public RestTemplate templateConfig() {
SimpleClientHttpRequestFactory requestFactory = new SimpleClientHttpRequestFactory();
//设置连接超时
requestFactory.setConnectTimeout(5000);
//设置请求超时
requestFactory.setReadTimeout(2000);
//设置是否缓存数据,当大量做增加或删除时建议关闭缓存,避免内存耗光
requestFactory.setBufferRequestBody(false);
RestTemplate restTemplate = new RestTemplate();
restTemplate.setRequestFactory(requestFactory);
//设置字符集编码
restTemplate.getMessageConverters().set(1, new StringHttpMessageConverter(Charset.forName("utf-8")));
//设置异常处理方式
restTemplate.setErrorHandler(new DefaultResponseErrorHandler());
return restTemplate;
}
}
使用Junit测试
1、getForEntity 无参数
@Test
public void contextLoads() {
RestTemplate restTemplate = new RestTemplate();
//执行
ResponseEntity<String> response = restTemplate.getForEntity("http://localhost:8111/test2", String.class);
//响应体
System.out.println("响应体——"+response.getBody());
//响应码
System.out.println("响应码——"+response.getStatusCode());
//响应头
System.out.println("响应头——"+response.getHeaders());
}
输出结果
响应体——this is server source ---- null
响应码——200 OK
响应头——{Content-Type=[text/plain;charset=UTF-8], Date=[Wed, 23 Oct 2019 02:52:57 GMT], Content-Length=[32]}
1.1、getForEntity 有参数
@Test
public void contextLoads() {
//使用map装载参数
Map<String, Object> map = new HashMap<String, Object>();
map.put("test", "admin");
RestTemplate restTemplate = new RestTemplate();
//执行
ResponseEntity<String> response = restTemplate.getForEntity("http://localhost:8111/test1?test={test}", String.class,map);
//响应体
System.out.println("响应体——"+response.getBody());
//响应码
System.out.println("响应码——"+response.getStatusCode());
//响应头
System.out.println("响应头——"+response.getHeaders());
}
输出结果
响应体——this is server source ----admin
响应码——200 OK
响应头——{Content-Type=[text/plain;charset=UTF-8], Date=[Wed, 23 Oct 2019 02:51:08 GMT], Content-Length=[31]}
2、getForObject 有参数
@Test
public void contextLoads() {
//使用map装载参数
Map<String, Object> map = new HashMap<String, Object>();
map.put("test", "admin");
RestTemplate restTemplate = new RestTemplate();
//执行
Object response = restTemplate.getForObject("http://localhost:8111/test1?test={test}", String.class,map);
System.out.println(response);
/*
* //响应体 System.out.println("响应体——"+response.getBody()); //响应码
* System.out.println("响应码——"+response.getStatusCode()); //响应头
* System.out.println("响应头——"+response.getHeaders());
*/
}
执行结果
this is server source ----admin
3、postForEntity 无参数
@Test
public void contextLoads() {
//设置请求头
HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.parseMediaType("application/json;charset=utf-8"));
HttpEntity<String> entity = new HttpEntity<String>(headers);
RestTemplate restTemplate = new RestTemplate();
//执行
ResponseEntity<String> response = restTemplate.postForEntity("http://localhost:8111/test2",entity,String.class);
//响应体
System.out.println("响应体——"+response.getBody());
//响应码
System.out.println("响应码——"+response.getStatusCode());
//响应头
System.out.println("响应头——"+response.getHeaders());
}
执行结果
响应体——this is server source ---- null
响应码——200 OK
响应头——{Content-Type=[text/plain;charset=UTF-8], Date=[Wed, 23 Oct 2019 03:29:12 GMT], Content-Length=[32]}
3.1 postForEntity 有参数
@Test
public void contextLoads() {
//设置请求头
HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.parseMediaType("application/json;charset=utf-8"));
//使用map装载参数
Map<String, Object> map = new HashMap<String, Object>();
map.put("test", "admin");
//设置请求体
HttpEntity<String> entity = new HttpEntity<String>(headers);
RestTemplate restTemplate = new RestTemplate();
//执行
ResponseEntity<String> response = restTemplate.postForEntity("http://localhost:8111/test1?test={test}",entity,String.class,map);
//响应体
System.out.println("响应体——"+response.getBody());
//响应码
System.out.println("响应码——"+response.getStatusCode());
//响应头
System.out.println("响应头——"+response.getHeaders());
}
执行结果
响应体——this is server source ----admin
响应码——200 OK
响应头——{Content-Type=[text/plain;charset=UTF-8], Date=[Wed, 23 Oct 2019 03:31:06 GMT], Content-Length=[31]}
4、postForObject
@Test
public void contextLoads() {
//设置请求头
HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.parseMediaType("application/json;charset=utf-8"));
//使用map装载参数
Map<String, Object> map = new HashMap<String, Object>();
map.put("test", "admin");
//设置请求体
HttpEntity<String> entity = new HttpEntity<String>(headers);
RestTemplate restTemplate = new RestTemplate();
//执行
String response = restTemplate.postForObject("http://localhost:8111/test1?test={test}",entity,String.class,map);
System.out.println(response);
}
执行结果
this is server source ----admin
1
总结
entity和object两种方法的区别就在于object比entity多出了自动封装成pojo的功能，但object无法处理response中头部、状态码等信息，而entity可以。
5、Exchange
Exchange与其它接口不同的是：允许调用者指定请求的方法，例如:GET POST
现在将服务接口的请求方式设置为POST
设置restTemplate的请求方式为get
//执行
ResponseEntity<String> response = restTemplate.exchange("http://localhost:8111/test1?test={test}",HttpMethod.GET,entity,String.class,map);
结果就报错了，因为请求方式不一致导致报错
org.springframework.web.client.HttpClientErrorException$MethodNotAllowed: 405 null
现在将请求方式改为POST再执行
//执行
ResponseEntity<String> response = restTemplate.exchange("http://localhost:8111/test1?test={test}",HttpMethod.POST,entity,String.class,map);
然后就执行成功了。
PS ： 学习记录，若有错误请留言指出 谢谢！