java.beans.beancontext

インタフェースBeanContextChild

既知のすべてのサブインタフェース:

BeanContext, BeanContextServices

既知のすべての実装クラス:

BeanContextChildSupport, BeanContextServicesSupport, BeanContextSupport

public interface BeanContextChild

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

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

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

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

導入されたバージョン:

1.2

関連項目:

BeanContext, PropertyChangeEvent, PropertyChangeListener, PropertyVetoException, VetoableChangeListener

メソッドのサマリー

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

メソッドの詳細

setBeanContext

void setBeanContext(BeanContext bc)
             throws PropertyVetoException

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

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

パラメータ:

bc - このBeanContextChildに関連したBeanContext。

例外:

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

getBeanContext

BeanContext getBeanContext()

このBeanContextChildに関連付けられているBeanContextを取得します。

戻り値:

このBeanContextChildに関連付けられているBeanContext。

addPropertyChangeListener

void addPropertyChangeListener(String name,
                               PropertyChangeListener pcl)

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

パラメータ:

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

pcl - 追加するPropertyChangeListener

removePropertyChangeListener

void removePropertyChangeListener(String name,
                                  PropertyChangeListener pcl)

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

パラメータ:

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

pcl - 削除するPropertyChangeListener

addVetoableChangeListener

void addVetoableChangeListener(String name,
                               VetoableChangeListener vcl)

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

パラメータ:

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

vcl - 追加するVetoableChangeListener

removeVetoableChangeListener

void removeVetoableChangeListener(String name,
                                  VetoableChangeListener vcl)

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

パラメータ:

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

vcl - 削除するVetoableChangeListener。