Java AWT 事件與監聽器完整對照表：元件支援事件、監聽器介面與適配器模式全解析

前言

Java 1.1 委派事件模型中，每個元件透過 addXXXListener()/removeXXXListener() 註冊特定事件監聽器。本文提供三張核心對照表：事件→監聽器→支援元件、元件→支援事件、監聽器介面→必須實作方法，並深入解析適配器模式簡化多方法介面實作。

表一：事件、監聽器介面與支援元件

註：MouseEvent 同時用於點擊與移動，無獨立 MouseMotionEvent。

表二：元件類型與支援事件

表三：監聽器介面與必須實作方法

三步驟快速掌握事件處理

1. 找介面：事件類名去掉 "Event" + "Listener" (如 MouseEvent → MouseListener)
2. 寫方法：實作介面中關注的方法 (如 mouseMoved())
3. 註冊：元件呼叫 add + 介面名 (如 addMouseMotionListener())

適配器模式：簡化多方法介面實作

單方法介面 (ActionListener, ItemListener, TextListener, AdjustmentListener) 直接實作即可。多方法介面若逐一實作空方法極繁瑣，Java 提供 適配器類別 (Adapter) 供繼承覆寫：

// 典型視窗關閉處理
class MyWindowListener extends WindowAdapter {
    public void windowClosing(WindowEvent e) { System.exit(0); }
}

WindowAdapter 已提供所有方法的空實作，僅覆寫關心的 windowClosing() 即可。

適配器陷阱：大小寫拼錯 = 新方法而非覆寫

// 錯誤：WindowClosing (大寫 W) → 新方法，非覆寫
class MyWindowListener extends WindowAdapter {
    public void WindowClosing(WindowEvent e) { System.exit(0); } // 無效！
}

編譯通過、執行無誤，但關閉視窗不退出程式。@Override 註解 (Java 5+) 可編譯期攔截此類錯誤，強烈建議永遠加上。

現代化延伸

• Swing 繼承相同模型，新增 EventListenerList 高效管理監聽器。
• JavaFX 採用 EventHandler<T> 函數式介面 + Lambda，更簡潔。
• Spring 事件機制 (ApplicationEventPublisher) 實現業務層解耦事件驅動。

熟記此對照表，除錯「為什麼我的監聽器不觸發」將從猜謎變成查表驗證。