Java AWT 事件處理機制詳解：按鈕點擊事件監聽器模式完整實戰

Java AWT/Swing 采用事件委派模型處理用戶交互。本文以按鈕點擊為例，深度講解事件源、事件對象、監聽器接口、註冊機制、內部類實現與多監聽器管理，附帶完整可運行代碼範例。

核心概念

• 事件源：產生事件的組件（如 JButton、JFrame）。
• 事件對象：封裝事件信息（如 ActionEvent 包含動作命令、修飾鍵等）。
• 監聽器：實現特定接口（如 ActionListener）的對象，處理事件邏輯。
• 註冊：事件源調用 addXxxListener() 將監聽器加入列表。
• 分發：事件發生時，事件源遍歷列表調用監聽器對應方法。

按鈕點擊事件完整流程

1. 創建按鈕

JButton yellowBtn = new JButton("Yellow");
JButton blueBtn = new JButton("Blue");
JButton redBtn = new JButton("Red");

2. 實現 ActionListener 接口

class ColorAction implements ActionListener {
    private Color bgColor;
    public ColorAction(Color c) { this.bgColor = c; }
    @Override
    public void actionPerformed(ActionEvent e) {
        // 此處需訪問面板對象修改背景色
    }
}

3. 註冊監聽器

yellowBtn.addActionListener(new ColorAction(Color.YELLOW));
blueBtn.addActionListener(new ColorAction(Color.BLUE));
redBtn.addActionListener(new ColorAction(Color.RED));

關鍵問題：監聽器如何訪問面板？

監聽器類若為外部類，無法直接訪問面板實例。兩種解決方案：

方案一：構造器傳遞面板引用

class ColorAction implements ActionListener {
    private JPanel panel;
    private Color color;
    public ColorAction(JPanel p, Color c) { this.panel = p; this.color = c; }
    @Override public void actionPerformed(ActionEvent e) {
        panel.setBackground(color);
    }
}
// 使用
yellowBtn.addActionListener(new ColorAction(buttonPanel, Color.YELLOW));

方案二：內部類（推薦，自動捕獲外部引用）

public class ButtonFrame extends JFrame {
    private JPanel buttonPanel;
    // ...
    private class ColorAction implements ActionListener {
        private Color bgColor;
        public ColorAction(Color c) { bgColor = c; }
        @Override public void actionPerformed(ActionEvent e) {
            buttonPanel.setBackground(bgColor); // 直接訪問外部類字段
        }
    }
    // 註冊
    buttonPanel.add(new JButton("Yellow")).addActionListener(new ColorAction(Color.YELLOW));
}

完整可運行範例

import javax.swing.*;
import java.awt.*;
import java.awt.event.*;

public class ButtonEventDemo {
    public static void main(String[] args) {
        SwingUtilities.invokeLater(() -> {
            JFrame frame = new JFrame("按鈕事件演示");
            frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
            JPanel panel = new JPanel();
            panel.setPreferredSize(new Dimension(300, 200));

            // 內部類監聽器
            class ColorAction implements ActionListener {
                private Color color;
                ColorAction(Color c) { color = c; }
                @Override public void actionPerformed(ActionEvent e) {
                    panel.setBackground(color);
                }
            }

            panel.add(new JButton("Yellow")).addActionListener(new ColorAction(Color.YELLOW));
            panel.add(new JButton("Blue")).addActionListener(new ColorAction(Color.BLUE));
            panel.add(new JButton("Red")).addActionListener(new ColorAction(Color.RED));

            frame.add(panel);
            frame.pack();
            frame.setLocationRelativeTo(null);
            frame.setVisible(true);
        });
    }
}

進階：多監聽器與事件對象信息

• 一個按鈕可註冊多個 ActionListener，點擊時按註冊順序依次調用。
• ActionEvent 提供有用方法：
  • getActionCommand()：返回按鈕文本（或 setActionCommand 設置）。
  • getModifiers()：檢查 Ctrl/Shift/Alt 是否按下。
  • getSource()：返回事件源組件引用。

btn.addActionListener(e -> {
    System.out.println("命令：" + e.getActionCommand());
    System.out.println("來源：" + e.getSource());
});

總結

1. 事件源 + 監聽器接口 + 註冊 = 事件處理核心三要素。
2. 內部類優雅解決監聽器訪問外部組件問題。
3. Lambda 表達式 (Java 8+) 可簡化單方法接口實現：btn.addActionListener(e -> doSomething())。
4. 理解委派模型，有助於掌握 Spring 事件、Netty 管道等進階框架設計。