RestTemplate自定义请求失败异常处理示例解析
时间：2022-10-20 10:16:33 | 栏目：JAVA代码 | 点击：次
前言
本文是精讲RestTemplate第7篇，前篇的blog访问地址如下：
RestTemplate在Spring或非Spring环境下使用精讲
RestTemplate实现多种底层HTTP客户端类库的切换用法
RestTemplate发送HTTP GET请求使用方法详解
RestTemplate发送HTTP POST请求使用方法详解
RestTemplate的DELETE及PUT等请求方法使用精讲
一、异常现象
在使用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在Spring或非Spring环境下使用精讲
RestTemplate实现多种底层HTTP客户端类库的切换用法
这时再去执行第一小节中的示例代码，就不会抛出异常。而是得到一个HTTP Status 404的结果。我们可以根据这个结果，在程序中继续向下执行代码。
