如何在编译后动态定制 AspectJ 切点表达式（基于抽象切面与继承机制）-java教程-PHP中文网

通过将切点声明为抽象方法，使下游项目可继承并重写具体包路径的 pointcut 表达式，从而实现无需修改已编译 aspect jar 即可灵活适配不同包范围的日志切面能力。

通过将切点声明为抽象方法，使下游项目可继承并重写具体包路径的 pointcut 表达式，从而实现无需修改已编译 aspect jar 即可灵活适配不同包范围的日志切面能力。

在使用 AspectJ 进行编译时织入（CTW）的场景中，一个常见需求是：将通用日志切面打包为独立 Maven 依赖（如 aspectj-tool.jar），供多个业务项目复用；同时又希望各业务方能按需指定“需要被自动增强的包路径”，而非硬编码在原始切面中。由于 Java 注解值必须是编译期常量，无法通过配置或参数动态替换 @Pointcut 字符串，因此直接修改已编译 .class 中的切点表达式不可行。

核心解法是采用面向对象的抽象化设计：将切面定义为抽象类，并将可变切点声明为抽象 @Pointcut 方法。

✅ 步骤一：定义抽象基切面（发布到中央仓库）

@Aspect
public abstract class AutoLogAspect {

    private static final Logger log = Logger.getLogger(AutoLogAspect.class);

    // 固定切点：基于 @Log 注解的方法
    @Pointcut("execution(@com.stellariver.milky.aspectj.tool.log.Log * *(..))")
    public void annotationPointCut() {}

    // 【关键】可变切点：由子类实现，支持任意包路径定制
    @Pointcut("")
    public abstract void packagePointCut();

    // 统一增强逻辑，复用两个切点
    @Around("annotationPointCut() || packagePointCut()")
    public Object logAround(ProceedingJoinPoint pjp) throws Throwable {
        long start = System.currentTimeMillis();
        Object result = null;
        boolean success = true;

        try {
            result = pjp.proceed();
        } catch (Throwable t) {
            success = false;
            throw t;
        } finally {
            long cost = System.currentTimeMillis() - start;
            String signature = pjp.getSignature().toShortString();
            log.info(String.format(
                "[success:%s] [cost:%dms] [result:%s]\n" +
                "====args: %s",
                success, cost, Objects.toString(result),
                Arrays.stream(pjp.getArgs())
                      .map(Objects::toString)
                      .limit(6)
                      .collect(Collectors.joining("] [", "[", "]))
            ));
        }
        return result;
    }
}

⚠️ 注意：@Pointcut("") 是合法的占位写法，仅用于声明抽象方法签名，实际织入时由子类提供有效表达式。

✅ 步骤二：下游项目继承并实现具体切点

业务项目引入 aspectj-tool 依赖后，只需编写一个轻量级子类：

package com.example.myapp.aspect;

import com.stellariver.milky.aspectj.tool.log.AutoLogAspect;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Pointcut;

@Aspect
public class MyAppLogAspect extends AutoLogAspect {

    // ✅ 灵活定制：此处可自由填写任意包路径，支持通配、组合等完整 AspectJ 语法
    @Pointcut("within(com.example.myapp.service..*) && execution(* *(..))")
    @Override
    public void packagePointCut() {}
}

Maven 编译时（配合 aspectj-maven-plugin），插件会自动识别该子类对抽象切点的实现，并完成织入 —— 所有 com.example.myapp.service 下的方法调用将被自动记录日志，无需额外添加 @Log 注解。

✅ 补充：运行时织入（LTW）方案（可选）

若项目采用加载时织入（Load-Time Weaving），则无需编写 Java 子类，仅需在 src/main/resources/META-INF/aop.xml 中声明：

<aspectj><aspects><aspect name="com.stellariver.milky.aspectj.tool.log.AutoLogAspect"></aspect><!-- 直接覆盖抽象切点 --><pointcut name="packagePointCut" expression="within(com.example.myapp.controller..*) && execution(* *(..))"></pointcut></aspects></aspectj>

此时甚至不依赖 aspectj-maven-plugin，仅需 JVM 启动参数 -javaagent:aspectjweaver.jar 即可生效。