JAVA Spring Boot Aspect 注解的使用和注意事项

微笑的曙光（StevenLi）

已于 2025-03-12 10:25:01 修改

阅读量1.1k

点赞数 24

分类专栏： JAVA 文章标签： java spring boot 开发语言

于 2025-03-12 10:22:07 首次发布

本文链接：https://blog.youkuaiyun.com/LYTIT/article/details/146197803

版权

JAVA 专栏收录该内容

10 篇文章

订阅专栏

Java Spring Boot的Aspect注解，作为面向切面编程的利器，其强大之处在于能够无缝地将横切关注点融入业务逻辑中，而无需修改原有代码。通过动态代理机制，Aspect可以在运行时灵活地织入日志、事务管理、权限校验等额外逻辑，极大地提高了系统的灵活性和可维护性。此外，Aspect还支持多种通知类型，如前置通知、后置通知、环绕通知等，满足了不同场景下的需求。这种松耦合、高内聚的设计思想，是现代软件开发中的宝贵财富，为构建高效、可扩展的系统提供了有力支持。

在Spring Boot中使用AspectJ切面编程（通过@Aspect注解）可以高效处理横切关注点（如日志、事务、权限等）。以下是详细的使用步骤和注意事项：

一、核心应用

1. 添加依赖

在pom.xml中添加Spring AOP依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-aop</artifactId>
</dependency>

2. 创建切面类

使用@Aspect和@Component注解定义切面类：

@Aspect
@Component
public class LoggingAspect {
    // 切入点和方法通知在此定义
}

3. 定义切入点（Pointcut）

通过@Pointcut注解定义拦截规则，支持表达式或注解匹配：

示例1：匹配包下的所有方法

@Pointcut("execution(* com.example.service.*.*(..))")
public void serviceMethods() {}

示例2：匹配自定义注解

@Pointcut("@annotation(com.example.annotation.LogExecution)")
public void logAnnotation() {}

4. 编写通知（Advice）

常用通知类型：@Before、@After、@AfterReturning、@AfterThrowing、@Around。

示例：记录方法执行时间

@Around("serviceMethods()")
public Object logExecutionTime(ProceedingJoinPoint joinPoint) throws Throwable {
    long start = System.currentTimeMillis();
    Object result = joinPoint.proceed(); // 执行目标方法
    long duration = System.currentTimeMillis() - start;
    System.out.println(joinPoint.getSignature() + " executed in " + duration + "ms");
    return result;
}

5. 获取方法参数和注解信息

通过JoinPoint或ProceedingJoinPoint访问方法上下文：

@Before("logAnnotation()")
public void logMethodParams(JoinPoint joinPoint) {
    Object[] args = joinPoint.getArgs();
    MethodSignature signature = (MethodSignature) joinPoint.getSignature();
    LogExecution annotation = signature.getMethod().getAnnotation(LogExecution.class);
    System.out.println("操作名称: " + annotation.value());
}

二、注意事项

1. 代理机制

JDK动态代理：默认用于接口实现的类。
CGLIB代理：用于无接口的类，可通过spring.aop.proxy-target-class=true强制启用。

2. 自调用问题

同类内部方法调用不会触发切面，需通过代理对象调用：

@Autowired
private ApplicationContext context;

public void internalMethod() {
    MyService proxy = context.getBean(MyService.class);
    proxy.targetMethod(); // 通过代理调用以触发切面
}

3. 切面执行顺序

使用@Order注解控制多个切面的执行顺序，值越小优先级越高：

@Aspect
@Component
@Order(1)
public class FirstAspect { /* ... */ }

4. 异常处理

在@Around中捕获异常需谨慎，避免意外屏蔽错误。

@AfterThrowing专门处理异常场景：

@AfterThrowing(pointcut = "serviceMethods()", throwing = "ex")
public void logException(JoinPoint joinPoint, Exception ex) {
    System.err.println("Exception in method: " + ex.getMessage());
}

5. 切入点表达式优化

避免过于宽泛的表达式（如execution(* *(..))），影响性能。
优先使用注解匹配，提升代码可读性。

6. 性能影响

高频方法中避免复杂切面逻辑，尤其在@Around中。

7、日志切面

@Aspect
@Component
public class LoggingAspect {

    @Pointcut("@annotation(com.example.annotation.LogExecution)")
    public void logAnnotation() {}

    @Around("logAnnotation()")
    public Object logMethod(ProceedingJoinPoint joinPoint) throws Throwable {
        MethodSignature signature = (MethodSignature) joinPoint.getSignature();
        String methodName = signature.getMethod().getName();
        System.out.println("Entering method: " + methodName);
        
        try {
            Object result = joinPoint.proceed();
            System.out.println("Exiting method: " + methodName);
            return result;
        } catch (Exception e) {
            System.out.println("Error in method: " + methodName);
            throw e;
        }
    }
}