Java 匿名內部類完全指南：語法本質、適用場景、Lambda 替代與常見陷阱

語法本質

new SuperTypeOrInterface() {
    // 類體：欄位、方法、初始化塊
    // 隱含構造器：調用父類無參構造器 (或介面無構造器)
};

• 無名稱：編譯器生成 OuterClass$1.class, OuterClass$2.class...。
• 隱含 final：匿名類隱含 final，不可被繼承。
• 隱含繼承/實現：extends SuperClass 或 implements Interface。
• 可存取外部 final/效能最終變量：Java 8+ 允許「效能最終」 (未重新賦值) 的局部變量、參數。

三大核心適用場景 (Lambda 無法完全替代)

1. 實現多方法介面 / 抽象類

Lambda 只能實現函數式介面 (單一抽象方法)。多方法介面必須用匿名類：

// Swing 事件監聽器 (多方法)
component.addMouseListener(new MouseAdapter() {
    @Override public void mouseClicked(MouseEvent e) { handleClick(e); }
    @Override public void mouseEntered(MouseEvent e) { showTooltip(e); }
    @Override public void mouseExited(MouseEvent e) { hideTooltip(); }
});

// 自定義多方法回調
interface DataLoaderCallback {
    void onStart();
    void onProgress(int percent);
    void onSuccess(Data data);
    void onError(Throwable t);
}

loader.loadData(new DataLoaderCallback() {
    @Override public void onStart() { showProgress(); }
    @Override public void onProgress(int p) { updateProgress(p); }
    @Override public void onSuccess(Data d) { render(d); hideProgress(); }
    @Override public void onError(Throwable t) { showError(t); hideProgress(); }
});

2. 構建複雜對象圖 (Builder/配置模式)

// OkHttpClient 建構器鏈中注入自定義 Dispatcher
OkHttpClient client = new OkHttpClient.Builder()
    .dispatcher(new Dispatcher() {
        @Override public void enqueue(AsyncCall call) {
            // 自定義佇列邏輯：優先級、去重、限流
            customQueue.offer(call);
        }
        @Override public void finished(AsyncCall call) {
            super.finished(call);
            customQueue.poll();
        }
    })
    .build();

3. 需要存取/修改外部上下文狀態

// 遞歸遍歷樹，收集結果到外部列表
List result = new ArrayList<>();
tree.traverse(new TreeVisitor() {
    @Override public void visit(Node node) {
        if (node.matches(criteria)) result.add(node); // 修改外部 final 列表
    }
});

編譯器生成代碼還原 (反編譯視角)

// 源碼
Runnable r = new Runnable() {
    int counter = 0;
    @Override public void run() { System.out.println(counter++); }
};

// 編譯器生成 (簡化)
final class OuterClass$1 implements Runnable {
    private int counter = 0;
    private final OuterClass this$0; // 持有外部類引用 (非 static 內部類)

    OuterClass$1(OuterClass outer) {
        this.this$0 = outer;
    }
    @Override public void run() {
        System.out.println(this.counter++);
    }
}

// 實例化
Runnable r = new OuterClass$1(this);

關鍵點：非 static 匿名類**隱含持有外部類引用** (this$0)，可能導致外部類無法 GC (記憶體洩漏)。

常見陷阱與避坑指南

Lambda 替代規則 (Java 8+)

// ✅ 適用：函數式介面 (單一方法)
Runnable r = () -> System.out.println("Hello");
Comparator cmp = (a, b) -> a.length() - b.length();
list.forEach(System.out::println); // 方法引用

// ❌ 不適用：多方法介面、需存取 this、需構造器參數、需序列化
// → 必須用匿名類或具名類

最佳實踐清單

1. 優先 Lambda/方法引用：函數式介面場景，代碼更簡潔、無外部引用風險。
2. 多方法介面/抽象類 → 匿名類：但控制在 20 行以內，超過提取為具名類。
3. 長生命週期回調 (Handler, Thread, Listener)：必須用 static 內部類 + WeakReference 或架構組件 (ViewModel/Lifecycle)。
4. 需要序列化：禁用匿名類**，改用具名 static 類實現 Serializable。
5. 訪問外部 this：用 OuterClass.this 明確限定，避免陰影變量混淆。
6. 鑽石操作符：new ArrayList<>() { ... } (Java 7+) 推斷泛型，無需重複聲明。