SpringBoot中的@RestControllerAdvice注解详解

1. @RestControllerAdvice注解详解

1.1 概述

@RestControllerAdvice注解是Spring MVC和Spring Boot应用程序中用于定义全局异常处理类的注解，它是@ControllerAdvice注解的特殊版本，用于RESTful风格的应用程序。

@RestControllerAdvice可以捕获整个应用程序中抛出的异常，并对它们进行处理。这样可以实现在整个应用程序范围内统一处理异常的目标；

@RestControllerAdvice注解实际上是@ControllerAdvice和@ResponseBody注解的组合。这意味着，当你使用@RestControllerAdvice注解时，异常处理方法的返回值将自动转换为HTTP响应的主体；

1.2 用途

@RestControllerAdvice注解用于创建全局异常处理类，用于捕获和处理整个应用程序中的异常。它适用于RESTful风格的应用程序，因为它自动将异常处理方法的返回值转换为HTTP响应的主体。

1.3 基本使用

要使用@RestControllerAdvice注解，只需在类上添加该注解。这个类应包含一个或多个带有@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:

用于指定需要扫描的类或接口。只有这些类或接口的实现类中的异常处理方法才会被全局异常处理类处理。

这些属性可以帮助你限制全局异常处理类的作用范围，使其只处理特定包、类或接口下的异常。

1.5 与@ExceptionHandler的结合

@RestControllerAdvice通常与@ExceptionHandler注解一起使用。在全局异常处理类中，你可以定义多个带有@ExceptionHandler注解的方法，用于处理不同类型的异常。当指定类型的异常在整个应用程序中抛出时，相应的`@ExceptionHandler方法将被调用以处理该异常。由于@RestControllerAdvice注解自动将异常处理方法的返回值转换为HTTP响应的主体，因此，你无需使用@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状态码和错误消息的ResponseEntity对象。由于我们使用了@RestControllerAdvice注解，异常处理方法的返回值将自动转换为HTTP响应的主体。

1.6 总结

@RestControllerAdvice注解是一个用于定义全局RESTful异常处理类的类级别注解。通过使用@RestControllerAdvice和@ExceptionHandler注解，你可以实现在整个应用程序范围内统一处理RESTful风格的异常。它自动将异常处理方法的返回值转换为HTTP响应的主体，使得代码更加简洁、可读和可维护。

2. @RestControllerAdvice注解 与 @ControllerAdvice注解的区别

到此这篇关于SpringBoot中的@RestControllerAdvice注解详解的文章就介绍到这了,更多相关@RestControllerAdvice注解内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

最新评论