Spring Boot中很多Advice后缀的注解和类,都是干什么的

在Spring Boot中,"Advice"这个词确实出现在不同的上下文中,主要分为两大职责:面向切面编程(AOP)中的增强(Advice)用于全局控制器增强的特定注解(如 @ControllerAdvice 。它们的核心思想都是提供一种拦截和增强原有逻辑的能力。

下面这个表格帮你快速梳理这些概念的区别和联系。

概念类别 具体名称 主要职责 关键注解/类
AOP 增强 (Advice) 通知/增强 在目标方法执行的特定点(如前后、异常时)注入通用逻辑(如日志、事务、安全)。 @Before, @After, @Around
控制器增强 (Controller Advice) 控制器增强 为所有或多个控制器提供统一的异常处理、数据绑定、模型数据预处理。 @ControllerAdvice, @RestControllerAdvice

💡 详解 AOP 中的增强(Advice)

AOP 允许你将遍布在应用多处的通用功能(横切关注点)模块化。Advice定义了 "做什么""何时做"

  • @Before :在目标方法执行前运行通知。适用于参数校验、权限检查等 。
  • @AfterReturning :仅在目标方法成功执行后运行通知。适用于记录返回结果等 。
  • @AfterThrowing :在目标方法抛出异常后运行通知。适用于专门的异常日志记录和错误报警 。
  • @After :在目标方法执行后运行通知,无论成功还是异常。适用于资源清理等 。
  • @Around :功能最强大的通知,可以完全控制目标方法的执行。它可以在方法执行前后添加自定义行为,甚至可以决定是否执行目标方法。适用于性能监控、事务管理等 。

执行顺序 :当多个通知作用于同一个连接点时,它们的执行顺序是有规律的。例如,一个 @Around通知会包裹整个执行过程,其内部会按 @Before→ 目标方法 → @AfterReturning/@AfterThrowing@After的顺序执行 。

🌐 理解控制器的增强(Controller Advice)

@ControllerAdvice@RestControllerAdvice(后者是 @ControllerAdvice@ResponseBody的组合)用于编写全局的控制器增强器,它们可以应用到所有的控制器上,实现三大功能 :

  • 全局异常处理 (@ExceptionHandler) :在一个地方集中处理从各个控制器抛出的异常,避免在每个控制器中重复编写 try-catch 块 。
  • 全局数据绑定 (@InitBinder) :预配置如何将 HTTP 请求参数绑定到模型数据上。例如,全局定义日期字符串的格式 。
  • 全局模型属性 (@ModelAttribute) :在控制器方法执行前,自动向模型(Model)中添加一些公共数据,比如当前登录用户信息 。

两者如何选择?

  • 当你需要拦截并增强 任意类的方法 (如Service层的方法)时,应使用 AOP Advice
  • 当你需要对 控制器(Controller) 进行统一的增强,如异常处理、数据预处理时,应使用 @ControllerAdvice

简单实例

AOP Advice 示例(记录方法执行时间)

less 复制代码
@Aspect
@Component
public class LoggingAspect {
    @Around("execution(* com.example.service.*.*(..))")
    public Object logExecutionTime(ProceedingJoinPoint joinPoint) throws Throwable {
        long start = System.currentTimeMillis();
        Object proceed = joinPoint.proceed(); // 执行目标方法
        long executionTime = System.currentTimeMillis() - start;
        System.out.println(joinPoint.getSignature() + " executed in " + executionTime + "ms");
        return proceed;
    }
}

@ControllerAdvice 示例(全局异常处理)

kotlin 复制代码
@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(UserNotFoundException.class)
    public ResponseEntity<String> handleUserNotFound(UserNotFoundException ex) {
        return ResponseEntity.status(HttpStatus.NOT_FOUND).body(ex.getMessage());
    }
}
相关推荐
阳光是sunny9 小时前
LangGraph中的Reducer是什么
前端·人工智能·后端
灯澜忆梦9 小时前
GO_并发编程---定时器
开发语言·后端·golang
阳光是sunny9 小时前
从链到图:LangGraph 入门基础全解析
前端·人工智能·后端
皮皮林55110 小时前
开源实力派,给本地 AI 装上深度调研能力,一张 3090 跑到 95.7 分!
后端
努力的小雨10 小时前
把 Windows 桌面图标做成一个会自己运转的小世界
后端
武子康11 小时前
Search Console Platform Properties 扩大 SEO 资产边界:从 Page Ranking 到 Topic Coverage(5 类误读边界 + 3 表数据层设计)
前端·人工智能·后端
腾渊信息科技公司12 小时前
Spring Boot对接MES实战:视觉检测数据自动同步方案
java·人工智能·spring boot·后端·计算机视觉·ai·软件需求
IT_陈寒13 小时前
Vue这个特性差点让我加班到凌晨,谁懂啊
前端·人工智能·后端
段一凡-华北理工大学13 小时前
向量数据库实战:选型、调优与落地~系列文章12:文本分块策略实战:chunk_size 怎么选?重叠多少?
开发语言·数据库·后端·oracle·rust·工业智能体·高炉智能化
码事漫谈13 小时前
1999年的电商前夜和2026年的AI前夜 历史押韵但从不重复
后端