Swing 多執行緒程式設計指南：單一執行緒規則與事件分發機制

核心設計哲學

Swing API 設計目標：強大、靈活、易用。為簡化元件開發，不要求元件支援多執行緒存取，而是將所有請求集中在單一事件分發執行緒（EDT）中執行。

單一執行緒規則

鐵律： 一旦 Swing 元件被「具現化」，所有可能影響或依賴元件狀態的程式碼，必須在 EDT 中執行。

關鍵術語定義

• 具現化： 元件 paint() 方法已被或可能被呼叫。頂層視窗調用 setVisible(true)、show()、pack() 時具現化；加入已具現化容器也會觸發
• 事件分發執行緒 (EDT)： 執行繪圖與事件處理的執行緒。paint()、actionPerformed() 自動在 EDT 執行；SwingUtilities.invokeLater() 也可將程式碼排入 EDT

規則例外：安全情境

1. 標記為執行緒安全的方法： API 文件標註 This method is thread safe...
2. 主執行緒建構 GUI（未具現化前）：

   public static void main(String[] args) {
       JFrame f = new JFrame("Labels");
       // 加入元件...
       f.pack();  // 此處具現化
       f.show();  // 技術上不安全，但實際無paint回調發生
       // 之後無GUI代碼，安全轉移至EDT
   }

3. Applet init() 中建構 GUI： 瀏覽器不會在 init()/start() 前繪製，故安全。但不得在其中調用 show()/setVisible(true)；耗時操作應啟動獨立執行緒

跨執行緒存取 UI 的正確方式

若需在事件處理/繪圖代碼外部存取 UI，必須使用：

• SwingUtilities.invokeLater(Runnable)：非同步排入 EDT，立即返回
• SwingUtilities.invokeAndWait(Runnable)：同步等待 EDT 執行完成

長時間任務的處理：SwingWorker

耗費大量計算或受 I/O 限制的工作，絕不可在 EDT 執行（會凍結 UI）。應使用：

• SwingWorker：專為背景任務設計，支援進度回報、完成回調、中途取消
• Timer：週期性或延遲執行的輕量任務

為何選擇單一執行緒模型？

• 多執行緒 UI 框架極難正確實作（死鎖、競態、記憶體可見性）
• 單一執行緒消除絕大多數同步複雜度
• 事件循環模型符合 UI 固有序列化本質（使用者動作本質循序）
• 效能損失可接受：現代 CPU 單核效能足夠處理事件分發

常見錯誤與最佳實踐