乐趣区

关于spring:精讲RestTemplate第7篇自定义请求失败异常处理

jiezi

本文是精讲 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 深入浅出系列》
退出移动版