RestTemplate自定義請求失敗異常處理示例解析

更新時間：2022年03月17日 10:46:05 作者：字母哥哥

這篇文章主要為大家介紹了RestTemplate自定義請求失敗異常處理的示例解析，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步早日升職加薪

前言

本文是精講RestTemplate第7篇，前篇的blog訪問地址如下：

RestTemplate在Spring或非Spring環(huán)境下使用精講

RestTemplate實現(xiàn)多種底層HTTP客戶端類庫的切換用法

RestTemplate發(fā)送HTTP GET請求使用方法詳解

RestTemplate發(fā)送HTTP POST請求使用方法詳解

RestTemplate的DELETE及PUT等請求方法使用精講

RestTemplate文件上傳下載與大文件流式下載

一、異常現(xiàn)象

在使用RestTemplate進行遠程接口服務(wù)調(diào)用的時候，當請求的服務(wù)出現(xiàn)異常：超時、服務(wù)不存在等情況的時候（響應(yīng)狀態(tài)非200、而是400、500HTTP狀態(tài)碼），就會拋出如下異常：

該異常我是模擬出來的，將正確的請求服務(wù)地址由“/posts/1”改成“/postss/1”。服務(wù)不存在所以拋出404異常。

@Test
public void testEntity() {
   String url = "http://jsonplaceholder.typicode.com/postss/1";
   ResponseEntity<String> responseEntity
               = restTemplate.getForEntity(url, String.class);  //這行拋出異常
   //下面兩行代碼執(zhí)行不到
   HttpStatus statusCode = responseEntity.getStatusCode(); // 獲取響應(yīng)碼
   System.out.println("HTTP 響應(yīng)狀態(tài)：" + statusCode);
}

異常拋出之后，程序后面的代碼就執(zhí)行不到了，無法進行后面的代碼執(zhí)行。實際的業(yè)務(wù)開發(fā)中，有的時候我們更期望的結(jié)果是：不管你服務(wù)端是超時了還是服務(wù)不存在，我們都應(yīng)該獲得最終的請求結(jié)果（HTTP請求結(jié)果狀態(tài)400、500），而不是獲得一個拋出的異常。

二、源碼解析-默認實現(xiàn)

首先我要說一個結(jié)論：RestTemplate請求結(jié)果異常是可以自定義處理的。在開始進行自定義的異常處理邏輯之前，我們有必要看一下異常處理的默認實現(xiàn)。也就是：為什么會產(chǎn)生上面小節(jié)提到的現(xiàn)象？

ResponseErrorHandler是RestTemplate請求結(jié)果的異常處理器接口

接口的第一個方法hasError用于判斷HttpResponse是否是異常響應(yīng)（通過狀態(tài)碼）
接口的第二個方法handleError用于處理異常響應(yīng)結(jié)果（非200狀態(tài)碼段）

DefaultResponseErrorHandler是ResponseErrorHandler的默認實現(xiàn)

所以我們就來看看DefaultResponseErrorHandler是如何來處理異常響應(yīng)的？從HttpResponse解析出Http StatusCode，如果狀態(tài)碼StatusCode為null，就拋出UnknownHttpStatusCodeException異常。

如果StatusCode存在，則解析出StatusCode的series，也就是狀態(tài)碼段（除了200段，其他全是異常狀態(tài)碼）,解析規(guī)則是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 ，服務(wù)端異常
}

進一步針對客戶端異常和服務(wù)端異常進行處理，處理的方法是拋出HttpClientErrorException。也就是第一小節(jié)出現(xiàn)的異常的原因

三、RestTemplate自定義異常處理

所以我們要實現(xiàn)自定義異常，實現(xiàn)ResponseErrorHandler 接口就可以。

public class MyRestErrorHandler implements ResponseErrorHandler {
    /**
     * 判斷返回結(jié)果response是否是異常結(jié)果
     * 主要是去檢查response 的HTTP Status
     * 仿造DefaultResponseErrorHandler實現(xiàn)即可
     */
    @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 {
        // 里面可以實現(xiàn)你自己遇到了Error進行合理的處理
        //TODO 將接口請求的異常信息持久化
    }
}

將MyRestErrorHandler 在RestTemplate實例化的時候進行注冊。

參考：

RestTemplate在Spring或非Spring環(huán)境下使用精講

RestTemplate實現(xiàn)多種底層HTTP客戶端類庫的切換用法