Java java.beans 类 VetoableChangeSupport（JDK5）

所有类

java.beans
类 VetoableChangeSupport

java.lang.Object
  java.beans.VetoableChangeSupport

所有已实现的接口：

Serializable

public class VetoableChangeSupport
   
   
   
   
   
extends Object
   
   
   
   
   
   
   
   
   
   
implements Serializable
   
   
   
   
   

这是一个实用工具类，支持 constrained 属性的 bean 可以使用此类。可以使用此类的实例作为 bean 的成员字段，并将各种工作委托给它。 此类是可序列化的。在对它进行序列化时，它将保存（并恢复）本身可序列化的所有侦听器。在序列化期间，将跳过所有不可序列化的侦听器。

另请参见：

序列化表格

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 多次添加到同一事件源，则在被移除之后，它获得的通知将减少一次。如果 listener 为 null，或者从未被添加，则不会抛出任何异常并且不执行任何操作。

参数：

listener - 要移除的 VetoableChangeListener

getVetoableChangeListeners

public VetoableChangeListener[] getVetoableChangeListeners()

返回 VetoableChangeListener 的列表。如果已添加指定 vetoable 更改侦听器，则将返回 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 多次添加到指定属性的同一事件源，则在被移除之后，它获得的通知将减少一次。如果 propertyName 为 null，则不会抛出任何异常并且不执行任何操作。如果 listener 为 null，或者从不为指定属性添加了侦听器，则不抛出任何异常并且不执行任何操作。

参数：

propertyName - 已被侦听的属性的名称。

listener - 要移除的 VetoableChangeListener

getVetoableChangeListeners

public VetoableChangeListener[] getVetoableChangeListeners(String propertyName)

返回与指定属性相关联的所有侦听器组成的数组。

参数：

propertyName - 将被侦听的属性的名称

返回：

与指定属性相关联的所有 VetoableChangeListener。如果没有添加此类侦听器，或者 propertyName 为 null，则返回一个空数组。

fireVetoableChange

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

向所有已注册的侦听器报告 vetoable 属性更新。如果任何人禁止更改，则触发一个新的事件，该事件将每个人的属性还原为旧值，然后再次抛出 PropertyVetoException。

如果新属性和旧属性相等并且是非 null 的，则不会触发事件。

参数：

propertyName - 将更改属性的编程名称。

oldValue - 属性的旧值。

newValue - 属性的新值。

抛出：

PropertyVetoException - 如果接收方希望回滚属性更改。