使用 AspectJ 構建切面庫——抽象切面與註解兩種實現模式

切面庫將橫切關注點（日誌、效能監控、事務等）封裝為可復用組件，使用者僅需實例化切入點即可接入業務邏輯。AspectJ 作為 Java 語言擴展，提供抽象切面與註解驅動兩種構建切面庫的原生機制。本文詳解兩種模式的構建、打包與應用流程。

切面庫核心概念

• 切入點：定義業務邏輯與切面交織的連接點（如方法呼叫、欄位存取）。
• 通知：在切入點執行的動作（before/after/around）。
• 切面庫：包含通知實作與抽象切入點的獨立模組，使用者繼承/標註即可複用。

AspectJ 5+ 引入註解支援，AJDT (AspectJ Development Tools) 逐步完善切面庫開發體驗。

模式一：抽象切面繼承體系

構建庫專案

1. Eclipse + AJDT 新建 AspectJ Project sample.aspects.library。
2. 建立抽象切面 AbstractTrace：

package sample.aspects.library;
public abstract aspect AbstractTrace {
    public abstract pointcut TraceScope(); // 抽象切入點，由子類實現
    Object around(): TraceScope() {
        Object sig = thisJoinPoint.getSignature();
        System.out.println("Enter " + sig);
        Object res = proceed();
        System.out.println("Exit " + sig);
        return res;
    }
}

3. Export → JAR file (tracelib.jar)，包含 .class 與 .aj 編譯產物。

應用庫專案

1. 新 AspectJ Project，Build Path → Libraries → Add External JARs → 選 tracelib.jar。
2. AJDT 向導建立新切面，指定繼承 AbstractTrace，自動生成實現抽象切入點的存根：

package aspects;
import sample.aspects.library.AbstractTrace;
public aspect Trace extends AbstractTrace {
    public pointcut TraceScope(): execution(* *(..)); // 攔截所有方法執行
}

3. 運行含此切面的應用，所有方法進出自動列印簽名。

優點：類型安全、IDE 智能提示、切入點表達式複用性強。缺點：需 AspectJ 編譯器 (ajc)，使用者須理解繼承體系。

模式二：註解驅動切面庫

構建庫專案

1. 新 AspectJ Project sample.annotation.library，JDK Compliance 設 5.0+。
2. 建立標準 Java 註解 @trace：

package sample.annotation.library;
import java.lang.annotation.*;
@Retention(RetentionPolicy.RUNTIME) @Target(ElementType.METHOD)
public @interface trace {}

3. 建立切面 AnnotationTrace，切入點匹配帶註解的方法：

package sample.annotation.library;
public aspect AnnotationTrace {
    pointcut traceScope(): execution(@trace * *(..)); // 匹配帶 @trace 的方法執行
    Object around(): traceScope() {
        Object sig = thisJoinPoint.getSignature();
        System.out.println("Enter " + sig);
        Object res = proceed();
        System.out.println("Exit " + sig);
        return res;
    }
}

4. 打包 tracelib.jar（含註解類與切面類）。

應用庫專案

1. 新 AspectJ Project sample.annotation.application，JDK 5.0+。
2. 專案屬性 → AspectJ Aspect Path → Add External JARs → 加入 tracelib.jar（關鍵：Aspect Path 而非 Build Path）。
3. 業務類標註註解：

package business.logic;
import sample.annotation.library.trace;
public class MainLogic {
    @trace
    public static void testTrace() { System.out.println("call testTrace function."); }
    public static void main(String[] args) { testTrace(); }
}

4. Run As → AspectJ/Java Application，輸出：

Enter void business.logic.MainLogic.testTrace()
call testTrace function.
Exit void business.logic.MainLogic.testTrace()

優點：零繼承、業務代碼無 AspectJ 依賴、切入點聲明極簡潔。缺點：需管理 Aspect Path、註解掃描範圍需配置。

兩種模式對比與選型建議

總結

切面庫是 AOP 復用的關鍵載體。AspectJ 提供兩種正交機制：

• 抽象切面：面向框架開發者，構建強類型、高表達力的基礎設施切面。
• 註解驅動：面向應用開發者，以最低認知負擔接入橫切功能。

實踐中常混合使用：核心基礎設施用抽象切面庫，業務層切面用註解庫。AJDT 工具鏈讓切面庫開發、分發、應用全流程工程化，推動 AOP 從「技術實驗」走向「工程標準」。