以前发送HTTP请求都是基于 HttpClient 的
使用CloseableHttpClient发送HTTP请求
今天看到有人用RestTemplate发送请求,代码特别简单,了解一下。
先了解如何使用,再做说明
org.springframework.boot
spring-boot-starter-web
RestTemplate 本身就像是一个工具类,这里就不再封装了。直接创建对象使用还是创建对象后放到Spring容器里都可以
RestTemplate restTemplate = new RestTemplate();
// 发送POST请求
ResponseEntity<Result> response = restTemplate.postForEntity(url, params, Result.class);
RestTemplate是Spring用于同步client端的核心类,简化了与http服务的通信,并满足RestFul原则,程序代码可以给它提供URL,并提取结果。默认情况下,RestTemplate默认依赖jdk的HTTP连接工具。当然你也可以 通过setRequestFactory属性切换到不同的HTTP源,比如Apache HttpComponents、Netty和OkHttp。
在RestTemplate中,对GET请求有两种方式。getForEntity
和getForObject
getForEntity 方法的返回值是一个ResponseEntity
,T
表示返回值类型,ResponseEntity
是 Spring 对 HTTP 请求响应的封装,包括了几个重要的元素,如响应码、contentType、contentLength、响应消息体等。
{
"body":"getForEntity",
"headers":{
"Content-Type":[
"text/plain;charset=UTF-8"
],
"Content-Length":[
"12"
],
"Date":[
"Mon, 16 Nov 2020 08:25:48 GMT"
]
},
"statusCode":"OK",
"statusCodeValue":200
}
public ResponseEntity getForEntity(URI url, Class responseType)
RestTemplate restTemplate = new RestTemplate();
String url = "http://localhost:8080/getForEntity";
ResponseEntity<String> responseEntity = restTemplate.getForEntity(url, String.class);
public ResponseEntity getForEntity(String url, Class responseType, Object... uriVariables)
RestTemplate restTemplate = new RestTemplate();
String url = "http://localhost:8080/getForEntity?param1={param1}¶m2={param2}";
ResponseEntity<String> responseEntity = restTemplate.getForEntity(url, String.class, "参数1", "参数2");
public ResponseEntity getForEntity(String url, Class responseType, Map uriVariables)
RestTemplate restTemplate = new RestTemplate();
String url = "http://localhost:8080/getForEntity?param1={param1}¶m2={param2}";
Map<String, Object> paramMap = new HashMap<>();
paramMap.put("param1","参数1");
paramMap.put("param2","参数2");
ResponseEntity<String> responseEntity = restTemplate.getForEntity(url, String.class, paramMap);
getForObject 函数实际上是对 getForEntity 函数的进一步封装,如果你只关注返回的消息体的内容,对其他信息都不关注,此时可以使用 getForObject
getForEntity
的body
在 RestTemplate 中,POST 请求可以通过如下三个方法来发起:postForEntity
、postForObject
、postForLocation
postForEntity
和postForObject
跟上面的get类似,唯一的不同点是参数列表不同,post请求可以发送实体类
注意:当参数列表中指定实体类时, post 发送的 Content-Type
为application/json
postForLocation
:postForLocation 也是提交新资源,提交成功之后,返回新资源的 URI,postForLocation 的参数和前面两种的参数基本一致,只不过该方法的返回值为 URI ,这个只需要服务提供者返回一个 URI 即可,该 URI 表示新资源的位置。
方法跟上面的getForObject
、getForEntity
、postForObject
、postForEntity
等方法不同之处在于它可以指定请求的HTTP类型;并且可以设置请求头信息
public ResponseEntity exchange(String url, HttpMethod method, @Nullable HttpEntity> requestEntity, Class responseType, Object... uriVariables)
public ResponseEntity exchange(String url, HttpMethod method, @Nullable HttpEntity> requestEntity, Class responseType, Map uriVariables)
public ResponseEntity exchange(URI url, HttpMethod method, @Nullable HttpEntity> requestEntity, Class responseType)
通常用的方法是与上面 GET、POST 的三个重载方法类似的方法,但是 exchange的方法中似乎都有都有@Nullable HttpEntity requestEntity
这个参数,可以通过该参数来配置请求体
示例:
String url = "http://localhost:8080/exchange?param1={param1}¶m2={param2}";
HttpHeaders headers = new HttpHeaders();
// 请求头添加 loginId、Content-Type、Accept-Charset
headers.set("loginId", "user001");
headers.set("Content-Type", MediaType.TEXT_PLAIN_VALUE);
headers.set("Accept-Charset", "utf-8");
Map<String, Object> paramMap = new HashMap<>();
paramMap.put("param1", "param1");
paramMap.put("param2", "param2");
HttpEntity httpEntity = new HttpEntity(paramMap, headers);
RestTemplate restTemplate = new RestTemplate();
// GET请求
ResponseEntity<String> exchange = restTemplate.exchange(url, HttpMethod.GET, httpEntity, String.class);
// POST请求
ResponseEntity<String> exchange = restTemplate.exchange(url, HttpMethod.POST, httpEntity, String.class);
System.out.println(JSONObject.toJSONString(exchange));
更详细的讲解