Spring AOP通知（Advice）详解

Spring 的 AOP 功能中一个关键概念是通知（Advice），与切点（Pointcut）表达式相关联在特定节点织入一些逻辑，Spring 提供了五种类型的通知。

理解 AOP 概念参阅：

《Spring的AOP和动态代理》

配置 AOP 参阅：

《Spring基于注解配置AOP》

《Spring基于XML配置AOP》

一、概述

AOP 中的通知是基于连接点（Join point）业务逻辑的一种增强，Spring AOP 提供了下面五种通知类型：

• Before advice（前置通知）：连接点前面执行，不能终止后续流程，除非抛异常

• After returning advice（后置通知）：连接点正常返回时执行，有异常不执行

• Around advice（环绕通知）：围绕连接点前后执行，也能捕获异常处理

• After advice（最终通知）：连接点退出时执行，无论是正常退出还是异常退出

• After throwing advice（异常通知）：连接点方法抛出异常时执行

AOP 的连接点一般是指目标类的方法，五种通知类型执行的节点如下：

二、通知的定义

Spring AOP 可以基于 XML 方式和基于注解方式定义，只是写法不同，这里只使用注解的方式来讲解通知的详细用法。

1. 前置通知

在 @Aspect 切面类中使用 @Before 注解简单地定义一个前置通知。

@Aspect
@Component
public class DemoAspect {

    @Before("execution(* cn.codeartist.spring.aop.advice.*.*(..))")
    public void doBefore() {
        // 自定义逻辑
    }
}

2. 后置通知

方法正常返回，会执行后置通知，使用 @AfterReturning 注解定义后置通知。

@AfterReturning("execution(* cn.codeartist.spring.aop.advice.*.*(..))")
public void doAfterReturning() {
    // 自定义逻辑
}

注解的 returning 属性可以绑定目标方法返回值，用于在通知中获取目标方法执行完成后的返回结果。

@AfterReturning(pointcut = "pointcut()", returning = "retVal")
public void doAfterReturning(Object retVal) {
    // 自定义逻辑（通过参数绑定方法切入点方法的返回值）
}

当注解使用了 returning 属性时，切入点会增加返回值类型的限制，上面使用的 Object 类型可以匹配到所有返回值类型的目标方法。

例如下面的情况，后置通知的代码不会被执行：

// 目标方法
public String doService() {
    return "码匠公众号";
}

// 后置通知定义
@AfterReturning(pointcut = "pointcut()", returning = "retVal")
public void doAfterReturning(Integer retVal) {
    // 目标方法返回值是String类型，结果参数绑定类型是Integer，该通知不会被执行
}

3. 环绕通知

环绕通知可以在方法执行的任何节点添加逻辑，它可以实现另外 4 种通知的功能。

如果需要以线程安全的方式在方法执行前后共享状态，可以使用环绕通知。

用 @Around 注解来定义环绕通知，需要使用 ProceedingJoinPoint 作为参数，来执行目标方法调用。

@Around("execution(* cn.codeartist.spring.aop.advice.*.*(..))")
public Object doAround(ProceedingJoinPoint joinPoint) throws Throwable {
    // 方法执行前逻辑
    Object retVal = joinPoint.proceed();
    // 方法执行后逻辑
    return retVal;
}

joinPoint.proceed() 会调用目标方法，或者是调用另一个切面。

虽然环绕通知可以实现另外几种通知的功能，但在使用中都能实现功能的情况下，优先使用其他通知方式。

4. 最终通知

最终通知在方法退出的时候执行，使用 @After 注解定义，最终通知在方法正常退出和抛出异常时都会执行，通常用于资源的释放。

@After("execution(* cn.codeartist.spring.aop.advice.*.*(..))")
public void doAfter() {
    // 自定义逻辑
}

5. 异常通知

方法抛出异常的时候会执行异常通知，使用 @AfterThrowing 定义异常通知。

@AfterThrowing("execution(* cn.codeartist.spring.aop.advice.*.*(..))")
public void doAfterThrowing() {
    // 自定义逻辑
}

注解的 throwing 属性用来绑定目标方法抛出的异常，用于在通知中获取目标方法抛出的异常实例。

@AfterThrowing(pointcut = "pointcut()", throwing = "ex")
public void doAfterThrowing(Throwable ex) {
    // 自定义逻辑（通过参数绑定方法切入点方法抛出的异常）
}

当注解使用了 throwing 属性时，切入点会增加异常类型的限制，上面使用的 Throwable 类型可以匹配到所有异常类型。

例如下面的情况，异常通知的代码不会被执行：

// 目标方法
public void doServiceThrow() {
    throw new RuntimeException("Test exception");
}

// 异常通知定义
@AfterThrowing(pointcut = "pointcut()", throwing = "ex")
public void doAfterThrowing(NullPointerException ex) {
    // 目标方法抛出的是RuntimeException，参数绑定类型是NullPointerException，该通知不会被执行
}

三、通知的参数

在定义通知的方法签名上可以指定参数来绑定目标方法的一些信息（例如前面讲到的后置通知和异常通知）。

1. 切入点

在定义通知方法的时候，一般可以使用 JoinPoint 作为参数，环绕通知使用 ProceedingJoinPoint。常用接口方法如下：

JoinPoint

public interface JoinPoint {

  // 获取代理对象
    Object getThis();

    // 获取目标对象
    Object getTarget();

    // 获取连接点方法的参数
    Object[] getArgs();

    // 获取连接点方法的签名
    Signature getSignature();

}

ProceedingJoinPoint

public interface ProceedingJoinPoint extends JoinPoint {

    // 执行下一个切面的通知或者目标方法
    public Object proceed() throws Throwable;

    // 执行下一个切面的通知或者目标方法（带参数）
    public Object proceed(Object[] args) throws Throwable;

}

切面的切入点一般为方法，所以 Signature 可以转换为 MethodSignature 使用。

2. 通知的参数传递

通知的参数可以通过切点表达式 args 来指定，具体用法会在后面切点表达式详解中讲到。

@Before("pointcut() && args(name,..)")
public void doBefore(String name) {
    // 切点表达式增加参数匹配
}

args(name,..) 也会增加切入点的限制，目标方法的参数个数至少为一个，且第一个参数类型为 String。

四、通知的顺序

Spring AOP 中一个目标类可以被多个切面切入，多个切面也可以切入一个目标类。

使用 @Order 注解来指定切面的优先级，来控制切面的执行顺序。

在注册切面 Bean 的时候指定 @Order，如下：

@Order(1)
@Aspect
@Component
public class FirstAspect {

    // ......
}

优先级高的切面先执行，通知执行的顺序如下：

可以得出：

• 优先级高的切面，前置通知先执行

• 优先级低的切面，后置通知先执行

Order 值越小，优先级越大。

Spring AOP 是基于动态代理的拦截器模式实现的，切面模型与拦截器模型相似，如下：

五、附录

1. 常用注解

注解	描述
@Aspect	定义切面类
@Before	定义前置通知
@AfterReturning	定义后置通知
@Around	定义环绕通知
@After	定义最终通知
@AfterThrowing	定义异常通知

表格可以左右滑动

2. 示例代码

Gitee 仓库：

https://gitee.com/code_artist/spring