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

39次阅读

共计 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 深入浅出系列》

正文完
 0