VetoableChangeSupport (Java Platform SE 7)

java.lang.Object
- java.beans.VetoableChangeSupport

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

Serializable
```
public class VetoableChangeSupport
extends Object
implements Serializable
```
制約プロパティーをサポートする Bean で使用できるユーティリティークラスです。リスナーのリストを管理し、PropertyChangeEvent をそれらにディスパッチします。このクラスのインスタンスを Bean のメンバーフィールドとして使用し、こうした種類の処理をそれに委譲できます。VetoableChangeListener は、すべてのプロパティーまたは名前で指定されたプロパティーに対して登録できます。
次は、JavaBeans™ 仕様に記載されている規則と推奨事項に従った VetoableChangeSupport の使用例です。
```
 public class MyBean {
     private final VetoableChangeSupport vcs = new VetoableChangeSupport(this);

     public void addVetoableChangeListener(VetoableChangeListener listener) {
         this.vcs.addVetoableChangeListener(listener);
     }

     public void removeVetoableChangeListener(VetoableChangeListener listener) {
         this.vcs.removeVetoableChangeListener(listener);
     }

     private String value;

     public String getValue() {
         return this.value;
     }

     public void setValue(String newValue) throws PropertyVetoException {
         String oldValue = this.value;
         this.vcs.fireVetoableChange("value", oldValue, newValue);
         this.value = newValue;
     }

     [...]
 }
 
```
VetoableChangeSupport インスタンスはスレッドセーフです。
このクラスは直列化可能です。直列化した場合、直列化可能なリスナーが保存および復元されます。直列化の際、直列化可能でないリスナーはスキップされます。
関連項目:
PropertyChangeSupport, Serialized Form

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明

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

コンストラクタ
コンストラクタと説明
`VetoableChangeSupport(Object sourceBean)` `VetoableChangeSupport` オブジェクトを構築します。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`void`	`addVetoableChangeListener(String propertyName, VetoableChangeListener listener)` 特定のプロパティーの VetoableChangeListener を追加します。
`void`	`addVetoableChangeListener(VetoableChangeListener listener)` VetoableChangeListener をリスナーリストに追加します。
`void`	`fireVetoableChange(PropertyChangeEvent event)` 登録されているリスナーにプロパティー変更イベントをトリガーして、すべてのプロパティーまたは指定された名前を持つプロパティーの更新を追跡します。
`void`	`fireVetoableChange(String propertyName, boolean oldValue, boolean newValue)` 登録されているリスナーに boolean 型の制約プロパティーの更新を報告して、すべてのプロパティーまたは指定された名前を持つプロパティーの更新を追跡します。
`void`	`fireVetoableChange(String propertyName, int oldValue, int newValue)` 登録されているリスナーに整数型の制約プロパティーの更新を報告して、すべてのプロパティーまたは指定された名前を持つプロパティーの更新を追跡します。
`void`	`fireVetoableChange(String propertyName, Object oldValue, Object newValue)` 登録されているリスナーに制約プロパティーの更新を報告して、すべてのプロパティーまたは指定された名前を持つプロパティーの更新を追跡します。
`VetoableChangeListener[]`	`getVetoableChangeListeners()` addVetoableChangeListener() によって VetoableChangeSupport オブジェクトに追加されたすべてのリスナーの配列を返します。
`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)
```
    VetoableChangeListener をリスナーリストに追加します。リスナーは、すべてのプロパティーに対して登録されます。同じリスナーオブジェクトを複数回追加でき、追加した回数だけリスナーオブジェクトが呼び出されます。listener が null の場合、例外はスローされず、何も処理は行われません。
    
    パラメータ:
    listener - 追加される VetoableChangeListener
  - removeVetoableChangeListener
```
public void removeVetoableChangeListener(VetoableChangeListener listener)
```
    リスナーリストから VetoableChangeListener を削除します。すべてのプロパティーに登録された VetoableChangeListener を削除します。同じイベントソースに listener が 2 回以上追加された場合は、削除されたあとに 1 回少ない通知が行われます。listener が null の場合、または追加されなかった場合、例外はスローされず、何も処理は行われません。
    
    パラメータ:
    listener - 削除される VetoableChangeListener
  - getVetoableChangeListeners
```
public VetoableChangeListener[] getVetoableChangeListeners()
```
    addVetoableChangeListener() によって VetoableChangeSupport オブジェクトに追加されたすべてのリスナーの配列を返します。
    指定されたプロパティーによって追加されたリスナーがある場合、VetoableChangeListener と VetoableChangeListenerProxy からなる配列が返されます。リスナーの識別に関係している呼び出し元メソッドは、個々の要素をテストして VetoableChangeListenerProxy であるかどうかの確認、キャスト、パラメータの確認を行う必要があります。
```
 VetoableChangeListener[] listeners = bean.getVetoableChangeListeners();
 for (int i = 0; i < listeners.length; i++) {
        if (listeners[i] instanceof VetoableChangeListenerProxy) {
     VetoableChangeListenerProxy proxy =
                    (VetoableChangeListenerProxy)listeners[i];
     if (proxy.getPropertyName().equals("foo")) {
       // proxy is a VetoableChangeListener which was associated
       // with the property named "foo"
     }
   }
 }
```
    戻り値:
    追加されたすべての VetoableChangeListeners、リスナーが追加されていない場合は空の配列
    導入されたバージョン:
    
    1.4
    
    関連項目:
    VetoableChangeListenerProxy
  - 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 をスローして更新を拒否できます。いずれかのリスナーが更新を拒否した場合、このメソッドは、この更新をすでに確定しているすべてのリスナーに、古い値に戻る「undo」PropertyChangeEvent を新たに渡し、再度 PropertyVetoException をスローします。
    古い値と新しい値が等しく、null でない場合、イベントはトリガーされません。
    これは、より一般的な fireVetoableChange(PropertyChangeEvent) メソッドの簡易ラッパーにすぎません。
    
    パラメータ:
    propertyName - 変更されるプロパティーのプログラム名
    oldValue - プロパティーの古い値
    newValue - プロパティーの新しい値
    
    例外:
    
    PropertyVetoException - いずれかのリスナーがプロパティーの更新を拒否した場合
  - fireVetoableChange
```
public void fireVetoableChange(String propertyName,
                      int oldValue,
                      int newValue)
                        throws PropertyVetoException
```
    登録されているリスナーに整数型の制約プロパティーの更新を報告して、すべてのプロパティーまたは指定された名前を持つプロパティーの更新を追跡します。
    どのリスナーも PropertyVetoException をスローして更新を拒否できます。いずれかのリスナーが更新を拒否した場合、このメソッドは、この更新をすでに確定しているすべてのリスナーに、古い値に戻る「undo」PropertyChangeEvent を新たに渡し、再度 PropertyVetoException をスローします。
    古い値と新しい値が等しい場合、イベントはトリガーされません。
    これは、より一般的な fireVetoableChange(String, Object, Object) メソッドの簡易ラッパーにすぎません。
    
    パラメータ:
    propertyName - 変更されるプロパティーのプログラム名
    oldValue - プロパティーの古い値
    newValue - プロパティーの新しい値
    
    例外:
    
    PropertyVetoException - いずれかのリスナーがプロパティーの更新を拒否した場合
  - fireVetoableChange
```
public void fireVetoableChange(String propertyName,
                      boolean oldValue,
                      boolean newValue)
                        throws PropertyVetoException
```
    登録されているリスナーに boolean 型の制約プロパティーの更新を報告して、すべてのプロパティーまたは指定された名前を持つプロパティーの更新を追跡します。
    どのリスナーも PropertyVetoException をスローして更新を拒否できます。いずれかのリスナーが更新を拒否した場合、このメソッドは、この更新をすでに確定しているすべてのリスナーに、古い値に戻る「undo」PropertyChangeEvent を新たに渡し、再度 PropertyVetoException をスローします。
    古い値と新しい値が等しい場合、イベントはトリガーされません。
    これは、より一般的な fireVetoableChange(String, Object, Object) メソッドの簡易ラッパーにすぎません。
    
    パラメータ:
    propertyName - 変更されるプロパティーのプログラム名
    oldValue - プロパティーの古い値
    newValue - プロパティーの新しい値
    
    例外:
    
    PropertyVetoException - いずれかのリスナーがプロパティーの更新を拒否した場合
  - fireVetoableChange
```
public void fireVetoableChange(PropertyChangeEvent event)
                        throws PropertyVetoException
```
    登録されているリスナーにプロパティー変更イベントをトリガーして、すべてのプロパティーまたは指定された名前を持つプロパティーの更新を追跡します。
    どのリスナーも PropertyVetoException をスローして更新を拒否できます。いずれかのリスナーが更新を拒否した場合、このメソッドは、この更新をすでに確定しているすべてのリスナーに、古い値に戻る「undo」PropertyChangeEvent を新たに渡し、再度 PropertyVetoException をスローします。
    指定されたイベントの以前の値と新しい値が等しくて null でない場合、イベントはトリガーされません。
    
    パラメータ:
    event - トリガーされる PropertyChangeEvent
    
    例外:
    
    PropertyVetoException - いずれかのリスナーがプロパティーの更新を拒否した場合
  - hasListeners
```
public boolean hasListeners(String propertyName)
```
    特定のプロパティーにリスナーがあるかどうかを判定します。あらゆるプロパティーに登録されたリスナーが含まれます。propertyName が null の場合は、すべてのプロパティーに登録されているリスナーのみがチェックされます。
    
    パラメータ:
    propertyName - プロパティー名。
    
    戻り値:
    指定したプロパティーに 1 つ以上のリスナーがある場合は true

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス VetoableChangeSupport

コンストラクタのサマリー

メソッドのサマリー

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

コンストラクタの詳細

VetoableChangeSupport

メソッドの詳細

addVetoableChangeListener

removeVetoableChangeListener

getVetoableChangeListeners

addVetoableChangeListener

removeVetoableChangeListener

getVetoableChangeListeners

fireVetoableChange

fireVetoableChange

fireVetoableChange

fireVetoableChange

hasListeners