|
对于最新的稳定版本，请使用 Spring Framework 7.0.6! |
控制器通知
@ExceptionHandler, @InitBinder, 和 @ModelAttribute 方法仅适用于声明它们的
@Controller 类或类层次结构。如果它们是在 @ControllerAdvice 或 @RestControllerAdvice 类中声明的，那么它们适用于任何控制器。此外，从 5.3 版本开始，@ExceptionHandler 方法在 @ControllerAdvice
中可以用来处理任何 @Controller 或其他处理器抛出的异常。
@ControllerAdvice 被元注解 @Component 注解，因此可以通过 组件扫描 注册为 Spring Bean。 @RestControllerAdvice 被元注解 @ControllerAdvice 和 @ResponseBody 注解，这意味着 @ExceptionHandler 方法的返回值将通过响应体消息转换进行呈现，而不是通过 HTML 视图。
启动时，RequestMappingHandlerMapping 和 ExceptionHandlerExceptionResolver 会检测控制器建议 Bean 并在运行时应用它们。全局 @ExceptionHandler 方法，从 @ControllerAdvice 中，会在本地方法（来自 @Controller）之后应用。相比之下，全局 @ModelAttribute 和 @InitBinder 方法会在本地方法之前应用。
@ControllerAdvice 注解具有可以缩小它们适用的控制器和处理程序集合的属性。例如：
-
Java
-
Kotlin
// Target all Controllers annotated with @RestController
@ControllerAdvice(annotations = RestController.class)
public class ExampleAdvice1 {}
// Target all Controllers within specific packages
@ControllerAdvice("org.example.controllers")
public class ExampleAdvice2 {}
// Target all Controllers assignable to specific classes
@ControllerAdvice(assignableTypes = {ControllerInterface.class, AbstractController.class})
public class ExampleAdvice3 {}// Target all Controllers annotated with @RestController
@ControllerAdvice(annotations = [RestController::class])
class ExampleAdvice1
// Target all Controllers within specific packages
@ControllerAdvice("org.example.controllers")
class ExampleAdvice2
// Target all Controllers assignable to specific classes
@ControllerAdvice(assignableTypes = [ControllerInterface::class, AbstractController::class])
class ExampleAdvice3在前面的示例中，选择器在运行时进行评估，如果广泛使用可能会对性能产生负面影响。有关详细信息，请参阅
@ControllerAdvice
Javadoc。