JavaBeans 進階特性深度解析：Constrained 屬性與事件模型

JavaBeans 核心進階機制：受限屬性與事件驅動架構

JavaBeans 規範定義了元件化開發的標準契約，其中 Constrained Properties（受限屬性） 與 Event Model（事件模型） 是實現元件間鬆耦合通訊、支援視覺化建構工具的關鍵機制。本文深入解析這兩大核心特性的設計原理、實作模式與最佳實務。

一、Constrained Properties（受限屬性）

受限屬性允許其他物件（Vetoable Change Listeners）在屬性值變更前進行攔截與否決。若任一監聽器拋出 PropertyVetoException，屬性變更將被取消，原值保持不變。

核心類別與介面

• java.beans.VetoableChangeSupport：管理否決監聽器清單、觸發否決事件
• java.beans.VetoableChangeListener：監聽器介面，單一方法 vetoableChange(PropertyChangeEvent evt)
• java.beans.PropertyVetoException：否決時拋出的受檢例外

標準實作模式

public class JellyBeans extends Canvas {
    private VetoableChangeSupport vetos = new VetoableChangeSupport(this);
    private PropertyChangeSupport changes = new PropertyChangeSupport(this);
    private int priceInCents;

    public void setPriceInCents(int newPrice) throws PropertyVetoException {
        int oldPrice = this.priceInCents;
        // 1. 觸發否決事件，監聽器可拋出 PropertyVetoException
        vetos.fireVetoableChange("priceInCents", oldPrice, newPrice);
        // 2. 無否決則更新值
        this.priceInCents = newPrice;
        // 3. 觸發一般屬性變更事件
        changes.firePropertyChange("priceInCents", oldPrice, newPrice);
    }

    // 註冊/移除否決監聽器
    public void addVetoableChangeListener(VetoableChangeListener l) {
        vetos.addVetoableChangeListener(l);
    }
    public void removeVetoableChangeListener(VetoableChangeListener l) {
        vetos.removeVetoableChangeListener(l);
    }
    // 同理需提供 PropertyChangeListener 註冊方法...
}

關鍵點總結

1. 順序固定：先 fireVetoableChange，再更新值，最後 firePropertyChange
2. 例外傳播：Setter 必須宣告 throws PropertyVetoException
3. 雙重監聽：受限屬性同時支援 VetoableChangeListener（否決）與 PropertyChangeListener（通知）
4. 狀態一致性：若否決發生，屬性值不變，PropertyChangeEvent 不觸發

二、JavaBeans 事件模型

事件模型是 JavaBeans 元件互動的基石，定義了「事件源」→「事件物件」→「事件監聽器」的標準協作流程。

核心三要素

事件流程

1. 事件源狀態改變
2. 建立事件物件（繼承 EventObject）
3. 遍歷已註冊監聽器，呼叫對應處理方法，傳入事件物件

標準註冊模式

public class EventSource {
    private final List<MyListener> listeners = new ArrayList<>();

    public synchronized void addMyListener(MyListener l) {
        listeners.add(l);
    }
    public synchronized void removeMyListener(MyListener l) {
        listeners.remove(l);
    }

    protected void fireMyEvent(MyEvent event) {
        // 複製清單避免並發修改
        List<MyListener> snapshot;
        synchronized (this) { snapshot = new ArrayList<>(listeners); }
        for (MyListener l : snapshot) {
            l.myEventOccurred(event);
        }
    }
}

事件適配器

當監聽器介面包含多個方法，但開發者僅關心其中幾個時，可使用適配器類別（Adapter）提供空實作，減少樣板碼。現代 IDE 多自動產生匿名內部類或 Lambda 表達式，適配器類較少手寫。

三、最佳實務與現代演進

• 慎用受限屬性：否決機制增加複雜度，僅在真正需要「事務性」屬性變更（如價格上限、庫存檢查）時使用
• 偏好不可變物件：現代設計傾向使用不可變資料傳輸物件（DTO/Record），減少屬性變更事件需求
• 事件總線替代：大型系統常採用 Guava EventBus、Spring ApplicationEvent 或 RxJava 等事件總線，解耦事件源與監聽器
• 執行緒安全：註冊/移除方法需同步；事件觸發時對監聽器清單快照迭代
• 記憶體洩漏防範：長生命週期事件源持有短生命週期監聽器參考會阻礙 GC，需提供明確移除機制或使用弱參考

小結

Constrained Properties 與 Event Model 構成了 JavaBeans 互動與整合的骨幹。雖然現代框架（Spring、JavaFX、Android）已將這些概念內建或重新設計，但理解其底層契約對於除錯、遷移舊系統、設計自訂元件框架仍具核心價值。