1. @RestControllerAdvice注解詳解

1.1 概述

@RestControllerAdvice注解是Spring MVC和Spring Boot應(yīng)用程序中用于定義全局異常處理類的注解，它是@ControllerAdvice注解的特殊版本，用于RESTful風(fēng)格的應(yīng)用程序。

@RestControllerAdvice可以捕獲整個應(yīng)用程序中拋出的異常，并對它們進行處理。這樣可以實現(xiàn)在整個應(yīng)用程序范圍內(nèi)統(tǒng)一處理異常的目標(biāo)；

@RestControllerAdvice注解實際上是@ControllerAdvice和@ResponseBody注解的組合。這意味著，當(dāng)你使用@RestControllerAdvice注解時，異常處理方法的返回值將自動轉(zhuǎn)換為HTTP響應(yīng)的主體；

1.2 用途

@RestControllerAdvice注解用于創(chuàng)建全局異常處理類，用于捕獲和處理整個應(yīng)用程序中的異常。它適用于RESTful風(fēng)格的應(yīng)用程序，因為它自動將異常處理方法的返回值轉(zhuǎn)換為HTTP響應(yīng)的主體。

1.3 基本使用

要使用@RestControllerAdvice注解，只需在類上添加該注解。這個類應(yīng)包含一個或多個帶有@ExceptionHandler注解的方法，用于處理不同類型的異常。

例如：

@RestControllerAdvice
public class GlobalRestExceptionHandler {
    @ExceptionHandler(UserNotFoundException.class)
    public ResponseEntity<String> handleUserNotFoundException(UserNotFoundException ex) {
        return ResponseEntity.status(HttpStatus.NOT_FOUND).body(ex.getMessage());
    }
    @ExceptionHandler(IllegalArgumentException.class)
    public ResponseEntity<String> handleIllegalArgumentException(IllegalArgumentException ex) {
        return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(ex.getMessage());
    }
}

1.4 屬性

@RestControllerAdvice注解繼承了@ControllerAdvice注解的屬性：

annotations:

用于指定需要掃描的其他注解。只有帶有這些注解的類中的異常處理方法才會被全局異常處理類處理。

basePackages:

別名：value

用于指定需要掃描的包名。只有這些包下的類中的異常處理方法才會被全局異常處理類處理。

value：

是默認的屬性；

用于指定要處理的異常類型。如果沒有指定value屬性，則默認處理所有的異常類型；

basePackageClasses:

用于指定需要掃描的類。只有這些類中的異常處理方法才會被全局異常處理類處理。

assignableTypes:

用于指定需要掃描的類或接口。只有這些類或接口的實現(xiàn)類中的異常處理方法才會被全局異常處理類處理。

這些屬性可以幫助你限制全局異常處理類的作用范圍，使其只處理特定包、類或接口下的異常。

1.5 與@ExceptionHandler的結(jié)合

@RestControllerAdvice通常與@ExceptionHandler注解一起使用。在全局異常處理類中，你可以定義多個帶有@ExceptionHandler注解的方法，用于處理不同類型的異常。當(dāng)指定類型的異常在整個應(yīng)用程序中拋出時，相應(yīng)的`@ExceptionHandler方法將被調(diào)用以處理該異常。由于@RestControllerAdvice注解自動將異常處理方法的返回值轉(zhuǎn)換為HTTP響應(yīng)的主體，因此，你無需使用@ResponseBody`注解。

例如：

@RestControllerAdvice
public class GlobalRestExceptionHandler {
    @ExceptionHandler(UserNotFoundException.class)
    public ResponseEntity<String> handleUserNotFoundException(UserNotFoundException ex) {
        return ResponseEntity.status(HttpStatus.NOT_FOUND).body(ex.getMessage());
    }
    @ExceptionHandler(IllegalArgumentException.class)
    public ResponseEntity<String> handleIllegalArgumentException(IllegalArgumentException ex) {
        return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(ex.getMessage());
    }
    @ExceptionHandler(Exception.class)
    public ResponseEntity<String> handleException(Exception ex) {
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("An unexpected error occurred: " + ex.getMessage());
    }
}

在上面的代碼中，我們定義了一個全局RESTful異常處理類，并處理了三種類型的異常：UserNotFoundException、IllegalArgumentException和Exception。對于每種異常，我們分別返回一個帶有HTTP狀態(tài)碼和錯誤消息的ResponseEntity對象。由于我們使用了@RestControllerAdvice注解，異常處理方法的返回值將自動轉(zhuǎn)換為HTTP響應(yīng)的主體。

1.6 總結(jié)

@RestControllerAdvice注解是一個用于定義全局RESTful異常處理類的類級別注解。通過使用@RestControllerAdvice和@ExceptionHandler注解，你可以實現(xiàn)在整個應(yīng)用程序范圍內(nèi)統(tǒng)一處理RESTful風(fēng)格的異常。它自動將異常處理方法的返回值轉(zhuǎn)換為HTTP響應(yīng)的主體，使得代碼更加簡潔、可讀和可維護。

2. @RestControllerAdvice注解 與 @ControllerAdvice注解的區(qū)別

到此這篇關(guān)于SpringBoot中的@RestControllerAdvice注解詳解的文章就介紹到這了,更多相關(guān)@RestControllerAdvice注解內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論