java.beans.beancontext
インタフェース BeanContextChild

既知のサブインタフェースの一覧:

BeanContext, BeanContextServices

既知の実装クラスの一覧:

BeanContextChildSupport, BeanContextServicesSupport, BeanContextSupport

public interface BeanContextChild

BeanContext サブインタフェースに定義されているように、入れ子になって実行環境 (コンテキスト) の参照を取得することが必要な JavaBeans には、このインタフェースを実装する必要があります。

仕様に準拠して実装された BeanContext は、BeanContextChild オブジェクト追加の副作用として、このインタフェースの setBeanContext() メソッドを使って自身への参照を渡します。

BeanContextChild は、応答として PropertyVetoedException をスローすることによって、状態の変更を拒否することもあります。

持続性機構が多種多様な状況にわたって BeanContextChild のインスタンスで正しく機能するために、このインタフェースを実装するクラスは、入れ子になっている BeanContext インスタンスへの参照、または指定されていない任意の機構を介して BeanContext から取得されたほかのリソースを格納または表現する一部またはすべてのフィールドやインスタンス変数を、一時的なものとして定義する必要があります。

導入されたバージョン:

1.2

メソッドの概要

void	addPropertyChangeListener(String name, PropertyChangeListener pcl) 指定されたプロパティが変更になるたびに PropertyChangeEvent を受信するために、この BeanContextChild に PropertyChangeListener を追加します。
void	addVetoableChangeListener(String name, VetoableChangeListener vcl) 指定されたプロパティが変更になるたびにイベントを受信するために、この BeanContextChild に VetoableChangeListener を追加します。
BeanContext	getBeanContext() この BeanContextChild に関連した BeanContext を取得します。
void	removePropertyChangeListener(String name, PropertyChangeListener pcl) この BeanContextChild から PropertyChangeListener を削除して、指定されたプロパティが変更になったときに PropertyChangeEvents を受け取らないようにします。
void	removeVetoableChangeListener(String name, VetoableChangeListener vcl) この BeanContextChild から VetoableChangeListener を削除して、指定されたプロパティが変更になったときにイベントを受け取らないようにします。
void	setBeanContext(BeanContext bc) このインタフェースを実装するオブジェクトは、propertyName "beanContext"、oldValue (以前に入れ子になった BeanContext のインスタンスまたは null)、newValue (現在入れ子になっている BeanContext のインスタンスまたは null) により、java.beans.PropertyChangeEvent をトリガすることになっています。

メソッドの詳細

setBeanContext

public void setBeanContext(BeanContext bc)
                    throws PropertyVetoException

このインタフェースを実装するオブジェクトは、propertyName "beanContext"、oldValue (以前に入れ子になった BeanContext のインスタンスまたは null)、newValue (現在入れ子になっている BeanContext のインスタンスまたは null) により、java.beans.PropertyChangeEvent をトリガすることになっています。

この BeanContextChild は、対応する例外をスローすることにより、入れ子になっている BeanContext プロパティの値の変更を拒否することがあります。

パラメータ:

bc - この BeanContextChild に関連した BeanContext

例外:

PropertyVetoException - 指定された BeanContext の追加を拒否された場合

PropertyVetoException

getBeanContext

public BeanContext getBeanContext()

この BeanContextChild に関連した BeanContext を取得します。

戻り値:

この BeanContextChild に関連した BeanContext

addPropertyChangeListener

public void addPropertyChangeListener(String name,
                                      PropertyChangeListener pcl)

指定されたプロパティが変更になるたびに PropertyChangeEvent を受信するために、この BeanContextChild に PropertyChangeListener を追加します。

パラメータ:

name - 待機しているプロパティの名前

pcl - 追加する PropertyChangeListener

removePropertyChangeListener

public void removePropertyChangeListener(String name,
                                         PropertyChangeListener pcl)

この BeanContextChild から PropertyChangeListener を削除して、指定されたプロパティが変更になったときに PropertyChangeEvents を受け取らないようにします。

パラメータ:

name - 待機していたプロパティの名前

pcl - 削除する PropertyChangeListener

addVetoableChangeListener

public void addVetoableChangeListener(String name,
                                      VetoableChangeListener vcl)

指定されたプロパティが変更になるたびにイベントを受信するために、この BeanContextChild に VetoableChangeListener を追加します。

パラメータ:

name - 待機しているプロパティの名前

vcl - 追加する VetoableChangeListener

removeVetoableChangeListener

public void removeVetoableChangeListener(String name,
                                         VetoableChangeListener vcl)

この BeanContextChild から VetoableChangeListener を削除して、指定されたプロパティが変更になったときにイベントを受け取らないようにします。

パラメータ:

name - 待機していたプロパティの名前

vcl - 削除する VetoableChangeListener