第12章-Spring基于注解配置AOP

Spring 的 AOP 功能是基于 AspectJ 实现的，支持使用注解声明式定义 AOP 切面。

理解 AOP 概念参阅：《Spring的AOP和动态代理》

一、概述

Spring 项目使用 AOP 功能需要定义三个部分：切面、切点和通知。

二、AOP 使用

Spring 基于注解配置 AOP 需要启用 AspectJ 自动代理功能。

基于 Java 配置

@Configuration
@EnableAspectJAutoProxy
public class AppConfig {

}

基于 XML 配置

<aop:aspectj-autoproxy/>

1. 定义切面

在 Spring 管理的 Bean 类上使用 @Aspect 注解就可以定义一个切面。

@Aspect
@Component
public class DemoAspect {

}

2. 定义切点

在切面类的方法使用 @Pointcut 注解来定义切点，然后在通知注解中使用方法签名来指定切点。
切点表达式用来匹配切入的目标类和方法。目标类只能是 Spring 容器管理的类，切面只能切入 Bean 中的方法。

@Aspect
@Component
public class DemoAspect {

    @Pointcut("execution(* cn.codeartist.spring.aop.aspectj.*.*(..))")
    public void pointcut() {
    }

    @Before("pointcut()")
    public void doBefore(JoinPoint joinPoint) {
        // do something
    }
}

切点表达式也可以在定义通知的时候指定，而不需要使用 @Pointcut 注解。

@Aspect
@Component
public class DemoAspect {

    @Before("execution(* cn.codeartist.spring.aop.aspectj.*.*(..))")
    public void doBefore(JoinPoint joinPoint) {
        // do something
    }
}

3. 定义通知

定义通知的时候需要指定切点，通知的类型决定了切入的节点。

前置通知

使用 @Before 注解定义前置通知，在方法执行前添加操作。

@Aspect
@Component
public class DemoAspect {

    @Before("pointcut()")
    public void doBefore(JoinPoint joinPoint) {
        // do something
    }
}

后置通知

使用 @AfterReturning 注解定义后置通知，在方法正常返回时执行，方法抛异常不执行。

@Aspect
@Component
public class DemoAspect {

    @AfterReturning("pointcut()")
    public void doAfterReturning(JoinPoint joinPoint) {
        // do something
    }
}

环绕通知

使用 @Around 注解定义环绕通知，切入方法前后，相当于拦截器的功能，可以捕获异常处理。
环绕通知的切入点参数为 ProceedingJoinPoint，并且需要手动调用 proceed() 来执行切入点方法的逻辑。

@Aspect
@Component
public class DemoAspect {

    @Around("pointcut()")
    public Object doAround(ProceedingJoinPoint joinPoint) throws Throwable {
        // do something
        Object proceed = joinPoint.proceed();
        // do something
        return proceed;
    }
}

最终通知

使用 @After 注解定义最终通知，在方法退出时执行，无论是正常退出还是异常退出。

@Aspect
@Component
public class DemoAspect {

    @After("pointcut()")
    public void doAfter(JoinPoint joinPoint) {
        // do something
    }
}

异常通知

使用 @AfterThrowing 注解定义异常通知，在方法抛出异常时执行。

@Aspect
@Component
public class DemoAspect {

    @AfterThrowing("pointcut()")
    public void doAfterThrowing(JoinPoint joinPoint) {
        // do something
    }
}

4. 通过 Advisor 实现

使用 Advisor 能以编程的方式创建切面，需要实现通知的 API 来定义通知的类型。
比起使用注解定义切点，这种方式指定切点表达式更灵活。

@Bean
public AspectJExpressionPointcutAdvisor aspectJExpressionPointcutAdvisor() {
    AspectJExpressionPointcutAdvisor advisor = new AspectJExpressionPointcutAdvisor();
    advisor.setExpression("execution(* cn.codeartist.spring.aop.aspectj.*.*(..))");
    advisor.setAdvice((MethodBeforeAdvice) (method, args, target) -> {
        // do something
    });
    return advisor;
}

三、附录

1. 常用配置

配置	描述
<aop:aspectj-autoproxy/>	启用 AspectJ 自动代理，通过注解定义切面

2. 常用注解

注解	描述
@EnableAspectJAutoProxy	启用 AspectJ 自动代理，通过注解定义切面
@Aspect	定义切面类
@Pointcut	定义切点，指定切点表达式
@Before	定义前置通知
@AfterReturning	定义后置通知
@Around	定义环绕通知
@After	定义最终通知
@AfterThrowing	定义异常通知

3. 示例代码

Gitee 仓库：https://gitee.com/code_artist/spring
项目模块：spring-aop
示例路径：cn.codeartist.spring.aop.aspectj

最新文章关注 CodeArtist 码匠公众号。

更多：Spring高效实践专栏