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 が null の場合は、例外はスローされず、何も処理は行われません。

パラメータ:

listener - 追加される VetoableChangeListener

removeVetoableChangeListener

public void removeVetoableChangeListener(VetoableChangeListener listener)

リスナーリストから VetoableChangeListener を削除します。すべてのプロパティーに登録された VetoableChangeListener を削除します。同じイベントソースに listener が 2 回以上追加された場合は、削除されたあとに、追加された回数よりも 1 回少ない通知が行われます。listener が null の場合、または追加されなかった場合は、例外はスローされず、何も処理は行われません。

パラメータ:

listener - 削除される VetoableChangeListener

getVetoableChangeListeners

public VetoableChangeListener[] getVetoableChangeListeners()

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

戻り値:

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

導入されたバージョン:

1.4

addVetoableChangeListener

public void addVetoableChangeListener(String propertyName,
                                      VetoableChangeListener listener)

特定のプロパティーの VetoableChangeListener を追加します。リスナーが呼び出されるのは、fireVetoableChange の呼び出しにより、その特定のプロパティーが指定されたときだけです。同じリスナーオブジェクトを複数回追加できます。各プロパティーでは、リスナーがそのプロパティーに追加された回数だけリスナーが呼び出されます。propertyName または listener が null の場合は、例外はスローされず、何も処理は行われません。

パラメータ:

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

listener - 追加される VetoableChangeListener

removeVetoableChangeListener

public void removeVetoableChangeListener(String propertyName,
                                         VetoableChangeListener listener)

特定のプロパティーの VetoableChangeListener を削除します。指定したプロパティーの同じイベントソースに listener が 2 回以上追加された場合は、削除されたあとに、追加された回数よりも 1 回少ない通知が行われます。propertyName が null の場合は、例外はスローされず、何も処理は行われません。listener が null の場合、または指定されたプロパティーに追加されなかった場合は、例外はスローされず、何も処理は行われません。

パラメータ:

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

listener - 削除される VetoableChangeListener

getVetoableChangeListeners

public VetoableChangeListener[] getVetoableChangeListeners(String propertyName)

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

パラメータ:

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

戻り値:

名前付きプロパティーに関連付けられたすべての VetoableChangeListeners。このようなリスナーが追加されていない場合、または propertyName が null の場合は空の配列が返される

導入されたバージョン:

1.4

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 拒否可能プロパティーの更新を通知します。古い値と新しい値が等しい場合、イベントはトリガーされません。

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

パラメータ:

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

oldValue - プロパティーの古い値

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

例外:

PropertyVetoException

fireVetoableChange

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

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

このメソッドは、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 が null の場合は、すべてのプロパティーで登録されたリスナーのチェックだけが行われます。

パラメータ:

propertyName - プロパティー名

戻り値:

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