关注我,可以获取最新知识、经典面试题以及微服务技术分享
在微服务中,rest
服务互相调用是很普遍的,我们该如何优雅地调用,其实在Spring框架使用RestTemplate
类可以优雅地进行rest
服务互相调用,它简化了与http
服务的通信方式,统一了RESTful
的标准,封装了http
链接,操作使用简便,还可以自定义RestTemplate所需的模式。其中:
RestTemplate
默认使用HttpMessageConverter
实例将HTTP
消息转换成POJO
或者从POJO
转换成HTTP
消息。默认情况下会注册主mime
类型的转换器,但也可以通过setMessageConverters
注册自定义转换器。
RestTemplate
使用了默认的DefaultResponseErrorHandler
,对40X Bad Request
或50X internal
异常error
等错误信息捕捉。
RestTemplate
还可以使用拦截器interceptor
,进行对请求链接跟踪,以及统一head的设置。
其中,RestTemplate
还定义了很多的REST
资源交互的方法,其中的大多数都对应于HTTP
的方法,如下:
方法 | 解析 |
---|---|
delete() | 在特定的URL上对资源执行HTTP DELETE操作 |
exchange() | 在URL上执行特定的HTTP方法,返回包含对象的ResponseEntity |
execute() | 在URL上执行特定的HTTP方法,返回一个从响应体映射得到的对象 |
getForEntity() | 发送一个HTTP GET请求,返回的ResponseEntity包含了响应体所映射成的对象 |
getForObject() | 发送一个HTTP GET请求,返回的请求体将映射为一个对象 |
postForEntity() | POST 数据到一个URL,返回包含一个对象的ResponseEntity |
postForObject() | POST 数据到一个URL,返回根据响应体匹配形成的对象 |
headForHeaders() | 发送HTTP HEAD请求,返回包含特定资源URL的HTTP头 |
optionsForAllow() | 发送HTTP OPTIONS请求,返回对特定URL的Allow头信息 |
postForLocation() | POST 数据到一个URL,返回新创建资源的URL |
put() | PUT 资源到特定的URL |
1. RestTemplate源码
1.1 默认调用链路
restTemplate
进行API调用时,默认调用链:
###########1.使用createRequest创建请求########
resttemplate->execute()->doExecute()
HttpAccessor->createRequest()
//获取拦截器Interceptor,InterceptingClientHttpRequestFactory,SimpleClientHttpRequestFactory
InterceptingHttpAccessor->getRequestFactory()
//获取默认的SimpleBufferingClientHttpRequest
SimpleClientHttpRequestFactory->createRequest()
#######2.获取响应response进行处理###########
AbstractClientHttpRequest->execute()->executeInternal()
AbstractBufferingClientHttpRequest->executeInternal()
###########3.异常处理#####################
resttemplate->handleResponse()
##########4.响应消息体封装为java对象#######
HttpMessageConverterExtractor->extractData()
1.2 restTemplate->doExecute()
在默认调用链中,restTemplate
进行API调用都会调用 doExecute
方法,此方法主要可以进行如下步骤:
1)使用createRequest
创建请求,获取响应
2)判断响应是否异常,处理异常
3)将响应消息体封装为java对象
@Nullable
protected <T> T doExecute(URI url, @Nullable HttpMethod method, @Nullable RequestCallback requestCallback,
@Nullable ResponseExtractor<T> responseExtractor) throws RestClientException {
Assert.notNull(url, "URI is required");
Assert.notNull(method, "HttpMethod is required");
ClientHttpResponse response = null;
try {
//使用createRequest创建请求
ClientHttpRequest request = createRequest(url, method);
if (requestCallback != null) {
requestCallback.doWithRequest(request);
}
//获取响应response进行处理
response = request.execute();
//异常处理
handleResponse(url, method, response);
//响应消息体封装为java对象
return (responseExtractor != null ? responseExtractor.extractData(response) : null);
}catch (IOException ex)