java.beans.beancontext
クラス BeanContextChildSupport

java.lang.Object
  |
  +--java.beans.beancontext.BeanContextChildSupport

すべての実装インタフェース:

BeanContextChild, BeanContextServiceRevokedListener, BeanContextServicesListener, EventListener, Serializable

直系の既知のサブクラス:

BeanContextSupport

public class BeanContextChildSupport

extends Object

implements BeanContextChild, BeanContextServicesListener, Serializable

BeanContextChild プロトコルの実装をサポートするための一般的なサポートクラスです。 このクラスは、直接サブクラス化されるか、あるいはカプセル化されて委譲されることにより、指定されたコンポーネントに対してこのインタフェースを実装します。

導入されたバージョン:

1.2

関連項目:

直列化された形式

フィールドの概要

protected BeanContext	beanContext
BeanContextChild	beanContextChildPeer この BeanContextChild が入れ子になる BeanContext です。
protected PropertyChangeSupport	pcSupport この BeanContextChildSupport に関連した PropertyChangeSupport です。
protected boolean	rejectedSetBCOnce setBeanContext 操作に対してスローされた PropertyChangeVetoException が少なくとも 1 つあることを示すフラグです。
protected VetoableChangeSupport	vcSupport この BeanContextChildSupport に関連した VetoableChangeSupport です。

コンストラクタの概要

BeanContextChildSupport()
JavaBean コンポーネント自身を実装するためにこのクラスがサブクラス化された、BeanContextChildSupport を構築します。

BeanContextChildSupport(BeanContextChild bcc)
JavaBean コンポーネント自身が BeanContextChild を実装し、これをカプセル化している BeanContextChildSupport を構築します。

メソッドの概要

void	addPropertyChangeListener(String name, PropertyChangeListener pcl) プロパティ変更リスナーを追加します。
void	addVetoableChangeListener(String name, VetoableChangeListener vcl) VetoableChangeListener を追加します。
void	firePropertyChange(String name, Object oldValue, Object newValue) 登録されているリスナーに、バウンドプロパティの更新を通知します。
void	fireVetoableChange(String name, Object oldValue, Object newValue) 拒否できるプロパティの更新について、登録されているリスナーに通知します。
BeanContext	getBeanContext() この BeanContextChildSupport の入れ子の BeanContext を取得します。
BeanContextChild	getBeanContextChildPeer() この BeanContextChildSupport に関連した BeanContextChild を取得します。
protected void	initializeBeanContextResources() このメソッドは、独自の初期化動作を提供するためにサブクラスによってオーバーライドされることがあります。
boolean	isDelegated() このクラスが他のクラスの委譲であるかどうかを報告します。
protected void	releaseBeanContextResources() このメソッドは、独自の解放動作を提供するためにサブクラスによってオーバーライドされることがあります。
void	removePropertyChangeListener(String name, PropertyChangeListener pcl) プロパティ変更リスナーを削除します。
void	removeVetoableChangeListener(String name, VetoableChangeListener vcl) VetoableChangeListener を削除します。
void	serviceAvailable(BeanContextServiceAvailableEvent bcsae) 入れ子になっている BeanContext から新しいサービスを使用できます。
void	serviceRevoked(BeanContextServiceRevokedEvent bcsre) 入れ子になっている BeanContext によって提供されるサービスが無効になっています。
void	setBeanContext(BeanContext bc) この BeanContextChildSupport の BeanContext を設定します。
boolean	validatePendingSetBeanContext(BeanContext newValue) 入れ子になっている BeanContext プロパティ値の保留中の変更を検証したりするために setBeanContext から呼び出されます。

クラス java.lang.Object から継承したメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

beanContextChildPeer

public BeanContextChild beanContextChildPeer

この BeanContextChild が入れ子になる BeanContext です。

pcSupport

protected PropertyChangeSupport pcSupport

この BeanContextChildSupport に関連した PropertyChangeSupport です。

vcSupport

protected VetoableChangeSupport vcSupport

この BeanContextChildSupport に関連した VetoableChangeSupport です。

beanContext

protected transient BeanContext beanContext

rejectedSetBCOnce

protected transient boolean rejectedSetBCOnce

setBeanContext 操作に対してスローされた PropertyChangeVetoException が少なくとも 1 つあることを示すフラグです。

コンストラクタの詳細

BeanContextChildSupport

public BeanContextChildSupport()

JavaBean コンポーネント自身を実装するためにこのクラスがサブクラス化された、BeanContextChildSupport を構築します。

BeanContextChildSupport

public BeanContextChildSupport(BeanContextChild bcc)

JavaBean コンポーネント自身が BeanContextChild を実装し、これをカプセル化している BeanContextChildSupport を構築します。BeanContextChild インタフェースはこの実装に委譲されます。

メソッドの詳細

setBeanContext

public void setBeanContext(BeanContext bc)
                    throws PropertyVetoException

この BeanContextChildSupport の BeanContext を設定します。

定義:

インタフェース BeanContextChild 内の setBeanContext

パラメータ:

bc - BeanContext プロパティに割り当てる新しい値

例外:

PropertyVetoException - 変更が拒否された場合

getBeanContext

public BeanContext getBeanContext()

この BeanContextChildSupport の入れ子の BeanContext を取得します。

定義:

インタフェース BeanContextChild 内の getBeanContext

戻り値:

この BeanContextChildSupport の入れ子の BeanContext

addPropertyChangeListener

public void addPropertyChangeListener(String name,
                                      PropertyChangeListener pcl)

プロパティ変更リスナーを追加します。

定義:

インタフェース BeanContextChild 内の addPropertyChangeListener

パラメータ:

name - 待機するプロパティの名前

pcl - 追加する PropertyChangeListener

removePropertyChangeListener

public void removePropertyChangeListener(String name,
                                         PropertyChangeListener pcl)

プロパティ変更リスナーを削除します。

定義:

インタフェース BeanContextChild 内の removePropertyChangeListener

パラメータ:

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

pcl - 削除する PropertyChangeListener

addVetoableChangeListener

public void addVetoableChangeListener(String name,
                                      VetoableChangeListener vcl)

VetoableChangeListener を追加します。

定義:

インタフェース BeanContextChild 内の addVetoableChangeListener

パラメータ:

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

vcl - 追加される VetoableChangeListener

removeVetoableChangeListener

public void removeVetoableChangeListener(String name,
                                         VetoableChangeListener vcl)

VetoableChangeListener を削除します。

定義:

インタフェース BeanContextChild 内の removeVetoableChangeListener

パラメータ:

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

vcl - 削除される VetoableChangeListener

serviceRevoked

public void serviceRevoked(BeanContextServiceRevokedEvent bcsre)

入れ子になっている BeanContext によって提供されるサービスが無効になっています。 サブクラスは、独自の動作を実装するためにこのメソッドをオーバーライドできます。

定義:

インタフェース BeanContextServiceRevokedListener 内の serviceRevoked

パラメータ:

bcsre - サービスの取り消しによってトリガーされた BeanContextServiceRevokedEvent

serviceAvailable

public void serviceAvailable(BeanContextServiceAvailableEvent bcsae)

入れ子になっている BeanContext から新しいサービスを使用できます。 サブクラスは、独自の動作を実装するためにこのメソッドをオーバーライドできます。

定義:

インタフェース BeanContextServicesListener 内の serviceAvailable

パラメータ:

bcsae - サービスが使用可能になったためにトリガーされた BeanContextServiceAvailableEvent

getBeanContextChildPeer

public BeanContextChild getBeanContextChildPeer()

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

戻り値:

このクラスの BeanContextChild のピア

isDelegated

public boolean isDelegated()

このクラスが他のクラスの委譲であるかどうかを報告します。

戻り値:

このクラスが他のクラスの委譲である場合は true

firePropertyChange

public void firePropertyChange(String name,
                               Object oldValue,
                               Object newValue)

登録されているリスナーに、バウンドプロパティの更新を通知します。以前の値と新しい値が等しくて null でない場合、イベントはトリガーされません。

パラメータ:

name - 変更されたプロパティのプログラム名

oldValue - プロパティの古い値

newValue - プロパティの新しい値

fireVetoableChange

public void fireVetoableChange(String name,
                               Object oldValue,
                               Object newValue)
                        throws PropertyVetoException

拒否できるプロパティの更新について、登録されているリスナーに通知します。変更が拒否された場合は、すべてを古い値へ戻す新しいイベントをトリガーしてから、もう一度 PropertyVetoException をスローします。

古い値と新しい値が等しくて null でない場合、イベントはトリガーされません。

パラメータ:

name - 変更されるプロパティのプログラム名

oldValue - プロパティの古い値

newValue - プロパティの新しい値

例外:

PropertyVetoException - 受け取り側でプロパティ変更のロールバックを指定している場合

validatePendingSetBeanContext

public boolean validatePendingSetBeanContext(BeanContext newValue)

入れ子になっている BeanContext プロパティ値の保留中の変更を検証したりするために setBeanContext から呼び出されます。false が返されると、setBeanContext は PropertyVetoException をスローします。

パラメータ:

newValue - BeanContext プロパティに要求されている新しい値

戻り値:

変更操作が拒否される場合は true

releaseBeanContextResources

protected void releaseBeanContextResources()

このメソッドは、独自の解放動作を提供するためにサブクラスによってオーバーライドされることがあります。このメソッドを呼び出すと、オブジェクトはその BeanContext 内で入れ子ではなくなっているため、現在の BeanContext プロパティから取得され、このインスタンスによって保持されているすべてのリソースが解放されます。

initializeBeanContextResources

protected void initializeBeanContextResources()

このメソッドは、独自の初期化動作を提供するためにサブクラスによってオーバーライドされることがあります。このメソッドを呼び出すと、BeanContextChild によって要求されるすべてのリソースが現在の BeanContext プロパティから取得されます。