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, java.beans.PropertyVetoEvent, java.beans.PropertyVetoListener, PropertyVetoException

メソッドの概要

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) このインタフェースを実装するオブジェクトです。

メソッドの詳細

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 の追加を拒否された場合

PropertyVetoException

getBeanContext

BeanContext getBeanContext()

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

戻り値:

この BeanContextChild に関連した BeanContext

addPropertyChangeListener

void addPropertyChangeListener(String name,
                               PropertyChangeListener pcl)

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

パラメータ:

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

pcl - 追加する PropertyChangeListener

removePropertyChangeListener

void removePropertyChangeListener(String name,
                                  PropertyChangeListener pcl)

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

パラメータ:

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

pcl - 削除する PropertyChangeListener

addVetoableChangeListener

void addVetoableChangeListener(String name,
                               VetoableChangeListener vcl)

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

パラメータ:

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

vcl - 追加する VetoableChangeListener

removeVetoableChangeListener

void removeVetoableChangeListener(String name,
                                  VetoableChangeListener vcl)

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

パラメータ:

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

vcl - 削除する VetoableChangeListener