共计 2733 个字符,预计需要花费 7 分钟才能阅读完成。
本文是精讲 RestTemplate 第 7 篇,前篇的 blog 拜访地址如下:
- 精讲 RestTemplate 第 1 篇 - 在 Spring 或非 Spring 环境下如何应用
- 精讲 RestTemplate 第 2 篇 - 多种底层 HTTP 客户端类库的切换
- 精讲 RestTemplate 第 3 篇 -GET 申请应用办法详解
- 精讲 RestTemplate 第 4 篇 -POST 申请办法应用详解
- 精讲 RestTemplate 第 5 篇 -DELETE、PUT 等申请办法应用详解
- 精讲 RestTemplate 第 6 篇 - 文件上传下载与大文件流式下载
一、异常现象
在应用 RestTemplate 进行近程接口服务调用的时候,当申请的服务出现异常:超时、服务不存在等状况的时候(响应状态非 200、而是 400、500HTTP 状态码),就会抛出如下异样:
该异样我是模仿进去的,将正确的申请服务地址由“/posts/1”改成“/postss/1”。服务不存在所以抛出 404 异样。
@Test
public void testEntity() {
String url = "http://jsonplaceholder.typicode.com/postss/1";
ResponseEntity<String> responseEntity
= restTemplate.getForEntity(url, String.class); // 这行抛出异样
// 上面两行代码执行不到
HttpStatus statusCode = responseEntity.getStatusCode(); // 获取响应码
System.out.println("HTTP 响应状态:" + statusCode);
}
异样抛出之后,程序前面的代码就执行不到了,无奈进行前面的代码执行。理论的业务开发中,有的时候咱们更冀望的后果是:不论你服务端是超时了还是服务不存在,咱们都应该取得最终的申请后果(HTTP 申请后果状态 400、500),而不是取得一个抛出的异样。
二、源码解析 - 默认实现
首先我要说一个论断:RestTemplate 申请后果异样是能够自定义解决的。在开始进行自定义的异样解决逻辑之前,咱们有必要看一下异样解决的默认实现。也就是:为什么会产生下面大节提到的景象?
-
ResponseErrorHandler 是 RestTemplate 申请后果的异样处理器接口
- 接口的第一个办法 hasError 用于判断 HttpResponse 是否是异样响应(通过状态码)
- 接口的第二个办法 handleError 用于解决异样响应后果(非 200 状态码段)
- DefaultResponseErrorHandler 是 ResponseErrorHandler 的默认实现
所以咱们就来看看 DefaultResponseErrorHandler 是如何来解决异样响应的?从 HttpResponse 解析出 Http StatusCode,如果状态码 StatusCode 为 null,就抛出 UnknownHttpStatusCodeException 异样。
如果 StatusCode 存在,则解析出 StatusCode 的 series,也就是状态码段(除了 200 段,其余全是异样状态码), 解析规定是 StatusCode/100 取整。
public enum Series {INFORMATIONAL(1), // 1xx/100
SUCCESSFUL(2), // 2xx/100
REDIRECTION(3), // 3xx/100
CLIENT_ERROR(4), // 4xx/100 , 客户端异样
SERVER_ERROR(5); // 5xx/100,服务端异样
}
进一步针对客户端异样和服务端异样进行解决,解决的办法是抛出 HttpClientErrorException。也就是第一大节呈现的异样的起因
三、RestTemplate 自定义异样解决
所以咱们要实现自定义异样,实现 ResponseErrorHandler 接口就能够。
public class MyRestErrorHandler implements ResponseErrorHandler {
/**
* 判断返回后果 response 是否是异样后果
* 次要是去查看 response 的 HTTP Status
* 仿造 DefaultResponseErrorHandler 实现即可
*/
@Override
public boolean hasError(ClientHttpResponse response) throws IOException {int rawStatusCode = response.getRawStatusCode();
HttpStatus statusCode = HttpStatus.resolve(rawStatusCode);
return (statusCode != null ? statusCode.isError(): hasError(rawStatusCode));
}
protected boolean hasError(int unknownStatusCode) {HttpStatus.Series series = HttpStatus.Series.resolve(unknownStatusCode);
return (series == HttpStatus.Series.CLIENT_ERROR || series == HttpStatus.Series.SERVER_ERROR);
}
@Override
public void handleError(ClientHttpResponse response) throws IOException {
// 外面能够实现你本人遇到了 Error 进行正当的解决
//TODO 将接口申请的异样信息长久化
}
}
将 MyRestErrorHandler 在 RestTemplate 实例化的时候进行注册。参考:《精讲 RestTemplate 第 1 篇 - 在 Spring 或非 Spring 环境下如何应用》和《精讲 RestTemplate 第 2 篇 - 多种底层 HTTP 客户端类库的切换》进行实现
这时再去执行第一大节中的示例代码,就不会抛出异样。而是失去一个 HTTP Status 404 的后果。咱们能够依据这个后果,在程序中持续向下执行代码。
欢送关注我的博客,外面有很多精品合集
- 本文转载注明出处(必须带连贯,不能只转文字):字母哥博客。
感觉对您有帮忙的话,帮我点赞、分享!您的反对是我不竭的创作能源!。另外,笔者最近一段时间输入了如下的精品内容,期待您的关注。
- 《手摸手教你学 Spring Boot2.0》
- 《Spring Security-JWT-OAuth2 一本通》
- 《实战前后端拆散 RBAC 权限管理系统》
- 《实战 SpringCloud 微服务从青铜到王者》
- 《VUE 深入浅出系列》