JavaBeans 組件開發完整規範：屬性、事件、持久化與 BeanInfo 詳解

JavaBeans 是可視化構建工具可操作的可重用軟體組件。其核心規範涵蓋四類屬性、事件模型、持久化機制與設計時資訊（BeanInfo），支援拖拉式應用開發。

四類屬性分類

屬性實現範例

Simple 屬性

public class SimpleBean {
    private String text = "Hello";
    public String getText() { return text; }
    public void setText(String text) { this.text = text; }
}

Indexed 屬性

public class IndexedBean {
    private int[] data = {1,2,3,4,5};
    public int[] getData() { return data; }
    public void setData(int[] data) { this.data = data; }
    public int getData(int i) { return data[i]; }
    public void setData(int i, int val) { data[i] = val; }
}

Bound 屬性（含 PropertyChangeSupport）

public class BoundBean {
    private String value;
    private PropertyChangeSupport pcs = new PropertyChangeSupport(this);

    public String getValue() { return value; }
    public void setValue(String newValue) {
        String old = this.value;
        this.value = newValue;
        pcs.firePropertyChange("value", old, newValue);
    }
    public void addPropertyChangeListener(PropertyChangeListener l) { pcs.addPropertyChangeListener(l); }
    public void removePropertyChangeListener(PropertyChangeListener l) { pcs.removePropertyChangeListener(l); }
}

Constrained 屬性（含 VetoableChangeSupport）

public class ConstrainedBean {
    private int price;
    private PropertyChangeSupport pcs = new PropertyChangeSupport(this);
    private VetoableChangeSupport vcs = new VetoableChangeSupport(this);

    public void setPrice(int newPrice) throws PropertyVetoException {
        int old = this.price;
        vcs.fireVetoableChange("price", old, newPrice); // 可能拋出 PropertyVetoException
        this.price = newPrice;
        pcs.firePropertyChange("price", old, newPrice);
    }
    // ... listener 註冊/移除方法
}

事件模型

三要素

1. 事件狀態物件：繼承 java.util.EventObject，類名以 Event 結尾
2. 事件監聽者介面：繼承 java.util.EventListener，類名以 Listener 結尾，定義處理方法
3. 事件源：提供 add<Listener>Listener/remove<Listener>Listener 註冊方法

事件範例

// 事件物件
public class TemperatureEvent extends EventObject {
    private double celsius;
    public TemperatureEvent(Object source, double celsius) { super(source); this.celsius = celsius; }
    public double getCelsius() { return celsius; }
}

// 監聽者介面
public interface TemperatureListener extends EventListener {
    void temperatureChanged(TemperatureEvent e);
}

// 事件源
public class Thermometer {
    private List listeners = new CopyOnWriteArrayList<>();
    public void addTemperatureListener(TemperatureListener l) { listeners.add(l); }
    public void removeTemperatureListener(TemperatureListener l) { listeners.remove(l); }
    
    private void fireTemperatureChanged(double c) {
        TemperatureEvent e = new TemperatureEvent(this, c);
        for (TemperatureListener l : listeners) l.temperatureChanged(e);
    }
}

適配器模式

當監聽者介面含多方法，或需過濾/轉發事件時，引入適配器類：

public class TemperatureAdapter implements TemperatureListener {
    private TemperatureListener target;
    public TemperatureAdapter(TemperatureListener target) { this.target = target; }
    public void temperatureChanged(TemperatureEvent e) {
        if (e.getCelsius() > 100) target.temperatureChanged(e); // 過濾條件
    }
}

持久化機制

• 實現 java.io.Serializable 介面
• 所有非 transient/static 欄位自動序列化
• 版本演進規則：
  • 可安全：新增欄位、移除引用、修改存取修飾符
  • 不安全：刪除欄位、移動欄位位置、修改 transient/static 屬性
• 儲存格式：JAR 檔 + MANIFEST.MF 標記 JavaBeans 類別

設計時資訊：BeanInfo

public class MyBeanBeanInfo extends SimpleBeanInfo {
    @Override
    public PropertyDescriptor[] getPropertyDescriptors() {
        try {
            PropertyDescriptor pd = new PropertyDescriptor("text", MyBean.class);
            pd.setPropertyEditorClass(TextEditor.class); // 自定義屬性編輯器
            pd.setBound(true); // 標記為 Bound 屬性
            return new PropertyDescriptor[]{pd};
        } catch (IntrospectionException e) { return null; }
    }
    
    @Override
    public EventSetDescriptor[] getEventSetDescriptors() { ... }
    
    @Override
    public MethodDescriptor[] getMethodDescriptors() { ... }
    
    @Override
    public Image getIcon(int iconKind) { ... } // 16x16/32x32 圖示
}

自定義組件

命名慣例總結

• 屬性：getX/setX、isX(boolean)
• 事件：addXListener/removeXListener、fireX
• 事件類：XEvent、監聽者：XListener
• BeanInfo：XBeanInfo、Customizer：XCustomizer、Editor：XEditor