项目开发:@ControllerAdvice注解的基本应用

目录

简介

@ControllerAdvice 是 Spring 框架中提供的一个注解,用于定义一个组件,该组件可以集中处理来自不同控制器的异常或提供统一的拦截器功能。它主要用于以下几个方面:

  1. 全局异常处理 :通过结合 @ExceptionHandler 注解,可以捕获和处理在控制器中抛出的异常。
  2. 全局拦截器 :通过实现 HandlerInterceptor 接口,并在类上使用 @ControllerAdvice 注解,可以实现一个全局的拦截器,对控制器的方法调用进行拦截。
  3. 全局数据绑定 :通过结合 @InitBinder 注解,可以在控制器方法执行前对数据绑定进行预处理。

基本用法

全局异常处理

假设我们想要捕获并统一处理所有控制器抛出的 ArithmeticException 异常:

java 复制代码
@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(ArithmeticException.class)
    public ResponseEntity<Object> handleArithmeticException(ArithmeticException ex) {
        // 定义错误信息
        ApiError apiError = new ApiError("An arithmetic error occurred", ex.getMessage());
        // 返回错误响应
        return new ResponseEntity<>(apiError, HttpStatus.BAD_REQUEST);
    }
}

在这个例子中,任何控制器抛出的 ArithmeticException 都会被 GlobalExceptionHandler 类中的 handleArithmeticException 方法捕获,并返回一个包含错误信息的响应。

全局拦截器

创建一个全局拦截器来记录每个请求的处理时间:

java 复制代码
@ControllerAdvice
public class LoggingInterceptor implements HandlerInterceptor {

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("PreHandle: " + request.getRequestURI());
        return true;
    }

    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        System.out.println("PostHandle: " + request.getRequestURI());
    }

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        long timeTaken = System.currentTimeMillis() - request.getAttribute("startTime") == null ? 0 : (Long) request.getAttribute("startTime");
        System.out.println("AfterCompletion: " + request.getRequestURI() + ", Time Taken: " + timeTaken + "ms");
    }
}

preHandle 方法中,你可以在控制器方法执行前进行一些操作,例如记录开始时间。postHandle 方法在控制器方法执行后执行,而 afterCompletion 方法在视图渲染后执行,适合用于记录请求处理的总时间。

全局数据绑定

自定义数据绑定:

java 复制代码
@ControllerAdvice
public class MyDataBinder {

    @InitBinder
    public void initBinder(WebDataBinder binder) {
        // 可以在这里自定义属性编辑器
        binder.registerCustomEditor(MyObject.class, new MyObjectEditor());
    }
}

在这个例子中,我们通过 @InitBinder 注解定义了一个方法,该方法将在每个控制器方法调用之前执行,用于注册自定义的数据绑定行为。

注解参数

1.value(): String[]

用于指定要应用通知的包名。

例如:@ControllerAdvice("org.example.controllers")

2.basePackages(): String[]

与 value() 相同,用于指定要应用通知的包名。

例如:@ControllerAdvice(basePackages = "org.example.controllers")

3.basePackageClasses(): Class<?>[]

用于指定要应用通知的基础包类。

例如:@ControllerAdvice(basePackageClasses = MyController.class)

4.assignableTypes(): Class<?>[]

用于指定要应用通知的特定类型。

例如:@ControllerAdvice(assignableTypes = {ControllerInterface.class, AbstractController.class})

5.annotations(): Class<? extends Annotation>[]

用于指定要应用通知的注解类型。

例如:@ControllerAdvice(annotations = RestController.class)

三.注解组成

@ControllerAdvice 实际上是一个组合注解(meta-annotation),它由几个其他的 Spring 注解组成。

@ControllerAdvice 的注解定义大致如下:

java 复制代码
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Component
public @interface ControllerAdvice {
    // ... 参数定义
}

从这个定义中,我们可以看到 @ControllerAdvice 主要由以下注解组成:

  1. @Target(ElementType.TYPE)

    指定该注解可以应用于类级别。

  2. @Retention(RetentionPolicy.RUNTIME)

    指定该注解在运行时可用。

  3. @Documented

    表示该注解应该被包含在 JavaDoc 中。

  4. @Component

    这是最关键的组成部分。@Component 使得被 @ControllerAdvice 注解的类成为 Spring 容器管理的一个组件。

@Component 的存在意味着:

  • @ControllerAdvice 注解的类会被自动检测并注册为 Spring Bean。
  • 它允许该类被 Spring 的组件扫描机制识别和管理。

虽然 @ControllerAdvice 本身并不直接包含如 @ExceptionHandler、@InitBinder 或 @ModelAttribute 这样的功能性注解,但它为这些注解提供了一个全局的应用上下文。当与这些注解结合使用时,@ControllerAdvice 使得它们的作用范围扩展到了多个控制器。

重要的是要注意,@ControllerAdvice 本身并不提供任何具体的功能。它主要作为一个标记,告诉 Spring 框架这个类应该被特殊处理,允许其中的方法(通过其他注解如 @ExceptionHandler 等标记)应用于多个控制器。

总结

@ControllerAdvice 主要是通过 @Component 注解实现其核心功能,而其他的元注解(@Target, @Retention, @Documented)则提供了额外的元数据信息。这种组合使得 @ControllerAdvice 成为一个强大而灵活的工具,用于在 Spring MVC 应用中实现全局的控制器相关功能。

相关推荐
DKPT3 分钟前
Java设计模式之行为型模式(责任链模式)介绍与说明
java·笔记·学习·观察者模式·设计模式
L_autinue_Star19 分钟前
手写vector容器:C++模板实战指南(从0到1掌握泛型编程)
java·c语言·开发语言·c++·学习·stl
晨岳32 分钟前
CentOS 安装 JDK+ NGINX+ Tomcat + Redis + MySQL搭建项目环境
java·redis·mysql·nginx·centos·tomcat
执笔诉情殇〆39 分钟前
前后端分离(java) 和 Nginx在服务器上的完整部署方案(redis、minio)
java·服务器·redis·nginx·minio
元气小嘉40 分钟前
前端技术小结
开发语言·前端·javascript·vue.js·人工智能
YuTaoShao43 分钟前
【LeetCode 热题 100】24. 两两交换链表中的节点——(解法一)迭代+哨兵
java·算法·leetcode·链表
励志的大鹰哥1 小时前
V少JS基础班之第七弹
开发语言·javascript·ecmascript
程序员的世界你不懂1 小时前
(20)Java+Playwright自动化测试- 操作鼠标拖拽 - 上篇
java·python·计算机外设
AI360labs_atyun1 小时前
Java在AI时代的演进与应用:一个务实的视角
java·开发语言·人工智能·科技·学习·ai
凤年徐2 小时前
【数据结构与算法】203.移除链表元素(LeetCode)图文详解
c语言·开发语言·数据结构·算法·leetcode·链表·刷题