java.beans
クラス VetoableChangeSupport

java.lang.Object
  |
  +--java.beans.VetoableChangeSupport

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

Serializable

public class VetoableChangeSupport

extends Object

implements Serializable

制約プロパティをサポートする bean によって使用されるユーティリティクラスです。このクラスのインスタンスを bean のメンバーフィールドとして使用し、さまざまな処理を委譲することができます。このクラスは直列化可能です。直列化した場合、直列化可能なリスナーが保存および復元されます。直列化の際、非直列化可能なリスナーはスキップされます。

関連項目:

直列化された形式

コンストラクタの概要

VetoableChangeSupport(Object sourceBean)
VetoableChangeSupport オブジェクトを構築します。

メソッドの概要

void	addVetoableChangeListener(String propertyName, VetoableChangeListener listener) 特定のプロパティの VetoableChangeListener を追加します。
void	addVetoableChangeListener(VetoableChangeListener listener) VetoableListener をリスナーリストに追加します。
void	fireVetoableChange(PropertyChangeEvent evt) 登録されているすべてのリスナーに対して、拒否可能プロパティの更新をトリガします。
void	fireVetoableChange(String propertyName, boolean oldValue, boolean newValue) 登録されているすべてのリスナーに boolean 拒否可能プロパティの更新を通知します。
void	fireVetoableChange(String propertyName, int oldValue, int newValue) 登録されているすべてのリスナーに int 拒否可能プロパティの更新を通知します。
void	fireVetoableChange(String propertyName, Object oldValue, Object newValue) 拒否可能なプロパティの更新について、登録されているリスナーに通知します。
VetoableChangeListener[]	getVetoableChangeListeners() VetoableChangeListener のリストを返します。
VetoableChangeListener[]	getVetoableChangeListeners(String propertyName) 指定されたプロパティに関連付けられているすべてのリスナーの配列を返します。
boolean	hasListeners(String propertyName) 特定のプロパティのリスナーがあるかどうかを判定します。
void	removeVetoableChangeListener(String propertyName, VetoableChangeListener listener) 特定のプロパティの VetoableChangeListener を削除します。
void	removeVetoableChangeListener(VetoableChangeListener listener) リスナーリストから VetoableChangeListener を削除します。

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

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

コンストラクタの詳細

VetoableChangeSupport

public VetoableChangeSupport(Object sourceBean)

VetoableChangeSupport オブジェクトを構築します。

パラメータ:

sourceBean - すべてのイベントの発生元として指定される bean

メソッドの詳細

addVetoableChangeListener

public void addVetoableChangeListener(VetoableChangeListener listener)

VetoableListener をリスナーリストに追加します。リスナーは、すべてのプロパティに対して登録されます。

パラメータ:

listener - 追加される VetoableChangeListener

removeVetoableChangeListener

public void removeVetoableChangeListener(VetoableChangeListener listener)

リスナーリストから VetoableChangeListener を削除します。こうすることにより、すべてのプロパティに対して登録された VetoableChangeListener が削除されます。

パラメータ:

listener - 削除される VetoableChangeListener

getVetoableChangeListeners

public VetoableChangeListener[] getVetoableChangeListeners()

VetoableChangeListener のリストを返します。指定された拒否可能な変更リスナーが追加された場合、VetoableChangeListenerProxy ラッパーが返されます。

戻り値:

指定されたプロパティ変更リスナーが追加された場合、VetoableChangeListener および VetoableChangeListenerProxy のリスト

導入されたバージョン:

1.4

addVetoableChangeListener

public void addVetoableChangeListener(String propertyName,
                                      VetoableChangeListener listener)

特定のプロパティの VetoableChangeListener を追加します。リスナーは、fireVetoableChange の呼び出しで特定のプロパティが指定されるときにだけ呼び出されます。

パラメータ:

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

listener - 追加される VetoableChangeListener

removeVetoableChangeListener

public void removeVetoableChangeListener(String propertyName,
                                         VetoableChangeListener listener)

特定のプロパティの VetoableChangeListener を削除します。

パラメータ:

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

listener - 削除される VetoableChangeListener

getVetoableChangeListeners

public VetoableChangeListener[] getVetoableChangeListeners(String propertyName)

指定されたプロパティに関連付けられているすべてのリスナーの配列を返します。

戻り値:

指定されたプロパティに関連付けられているすべての VetoableChangeListeners。リスナーが追加されていない場合は空の配列

fireVetoableChange

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

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

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

パラメータ:

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

oldValue - 古いプロパティ値

newValue - 新しいプロパティ値

例外:

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

fireVetoableChange

public void fireVetoableChange(String propertyName,
                               int oldValue,
                               int newValue)
                        throws PropertyVetoException

登録されているすべてのリスナーに int 拒否可能プロパティの更新を通知します。古い値と新しい値が等しく、null でない場合、イベントはトリガされません。

このメソッドは、Object 値をとる、より一般的な fireVetoableChange メソッドの簡易ラッパーです。

パラメータ:

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

oldValue - 古いプロパティ値

newValue - 新しいプロパティ値

PropertyVetoException

fireVetoableChange

public void fireVetoableChange(String propertyName,
                               boolean oldValue,
                               boolean newValue)
                        throws PropertyVetoException

登録されているすべてのリスナーに boolean 拒否可能プロパティの更新を通知します。古い値と新しい値が等しく、null でない場合、イベントはトリガされません。

このメソッドは、Object 値をとる、より一般的な fireVetoableChange メソッドの簡易ラッパーです。

パラメータ:

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

oldValue - 古いプロパティ値

newValue - 新しいプロパティ値

PropertyVetoException

fireVetoableChange

public void fireVetoableChange(PropertyChangeEvent evt)
                        throws PropertyVetoException

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

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

パラメータ:

evt - トリガされる PropertyChangeEvent

例外:

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

hasListeners

public boolean hasListeners(String propertyName)

特定のプロパティのリスナーがあるかどうかを判定します。

パラメータ:

propertyName - プロパティ名

戻り値:

指定したプロパティに 1 つ以上のリスナーがある場合は true