java.beans

Class VetoableChangeSupport

java.lang.Object

java.beans.VetoableChangeSupport

All Implemented Interfaces:

Serializable

public class VetoableChangeSupport
extends Object
implements Serializable

这是一个可用于支持约束属性的豆的实用程序类。它管理的列表 PropertyChangeEvents听众和派遣他们。您可以使用这个类的一个实例作为您的豆的成员字段，并将这些类型的工作委托给它。的 VetoableChangeListener可以注册为所有属性或属性指定的名字。

这里是VetoableChangeSupport用法的一个例子，遵循的规则和建议放在™JavaBeans规范：

 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

构造方法摘要

构造方法

Constructor and Description
VetoableChangeSupport(Object sourceBean) 构建了一个 VetoableChangeSupport对象。

方法摘要

Modifier and Type	Method and Description
void	addVetoableChangeListener(String propertyName, VetoableChangeListener listener) 添加一个特定的属性vetoablechangelistener。
void	addVetoableChangeListener(VetoableChangeListener listener) 添加一个vetoablechangelistener的监听器列表。
void	fireVetoableChange(PropertyChangeEvent event) 向已注册的侦听器发射属性更改事件，以跟踪所有属性或具有指定名称的属性的更新。
void	fireVetoableChange(String propertyName, boolean oldValue, boolean newValue) 向已注册的侦听器报告一个布尔受限属性更新，以跟踪所有属性或具有指定名称的属性的更新。
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听众。

Methods inherited from class java.lang.Object

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

Constructor Detail

VetoableChangeSupport

public VetoableChangeSupport(Object sourceBean)

构建了一个 VetoableChangeSupport对象。

参数

sourceBean -豆给任何事件源。

方法详细信息

addVetoableChangeListener

public void addVetoableChangeListener(VetoableChangeListener listener)

添加一个vetoablechangelistener的监听器列表。侦听器是为所有属性注册的。同一个侦听器对象可以添加一次以上，并将被调用多次，因为它添加了。如果 listener是空的，没有异常被抛出，不采取行动。

参数

listener - vetoablechangelistener加以补充

removeVetoableChangeListener

public void removeVetoableChangeListener(VetoableChangeListener listener)

从列表中删除一个vetoablechangelistener听众。这消除了vetoablechangelistener被注册为所有属性。如果 listener曾不止一次地对同一事件的消息人士补充说，这将是一个较少的时间通知后。如果 listener是空的，或是不加，不引发异常而不采取行动。

参数

listener - vetoablechangelistener被删除

getVetoableChangeListeners

public VetoableChangeListener[] getVetoableChangeListeners()

返回所有的听众都加入到addvetoablechangelistener()的vetoablechangesupport对象数组。

如果一些听众已添加的命名属性，然后返回的数组将是一个vetoablechangelisteners和VetoableChangeListenerProxys混合物。如果调用方法是区分听众就必须测试每一个元素是否是一个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说如果没有听众已添加一个空数组

从以下版本开始：

一点四

另请参见：

VetoableChangeListenerProxy

addVetoableChangeListener

public void addVetoableChangeListener(String propertyName,
                                      VetoableChangeListener listener)

添加一个特定的属性vetoablechangelistener。听者会被调用时，只对特定财产firevetoablechange姓名电话。相同的侦听器对象可以添加一次以上。对于每个属性，侦听器将调用它被添加的属性的次数。如果 propertyName或 listener是空的，没有异常被抛出，不采取行动。

参数

propertyName -属性的名字听上。

listener - vetoablechangelistener加以补充

removeVetoableChangeListener

public void removeVetoableChangeListener(String propertyName,
                                         VetoableChangeListener listener)

消除对特定财产vetoablechangelistener。如果 listener曾不止一次地对指定的属性相同的事件源补充说，这将是一个较少的时间通知后。如果 propertyName是空的，没有异常被抛出，不采取行动。如果 listener是无效的，或者是不添加指定的属性，不引发异常而不采取行动。

参数

propertyName -房地产，听名字。

listener - vetoablechangelistener被删除

getVetoableChangeListeners

public VetoableChangeListener[] getVetoableChangeListeners(String propertyName)

返回已与已命名的属性关联的所有侦听器的数组。

参数

propertyName -物业的听的名字

结果

所有的 VetoableChangeListeners与命名属性关联。如果没有这样的听众已被添加，或者如果 propertyName为空，则返回一个空数组。

从以下版本开始：

一点四

fireVetoableChange

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

向已注册的已注册的侦听器更新已注册的约束属性更新，以跟踪指定名称的所有属性或属性的更新。

任何听众可以抛出一个PropertyVetoException否决更新。如果一个监听器否决的更新，该方法传递一个新的“撤消”PropertyChangeEvent，归还给所有的听众，已经证实了这一更新，把PropertyVetoException又旧的价值。

如果旧值和新值都是相等的和非空值，则不会发射任何事件。

这仅仅是在更一般的fireVetoableChange(PropertyChangeEvent)方法方便的包装。

参数

propertyName -这是关于改变物业专业名称

oldValue -属性的旧值

newValue -新的属性值

异常

PropertyVetoException -如果一个听众否决属性更新

fireVetoableChange

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

向已注册的侦听器报告一个整数约束的属性更新，以跟踪所有属性或具有指定名称的属性的更新。

任何听众可以抛出一个PropertyVetoException否决更新。如果一个监听器否决的更新，该方法传递一个新的“撤消”PropertyChangeEvent，归还给所有的听众，已经证实了这一更新，把PropertyVetoException又旧的价值。

如果旧值和新值是相等的，则不会发射任何事件。

这仅仅是在更一般的fireVetoableChange(String, Object, Object)方法方便的包装。

参数

propertyName -这是关于改变物业专业名称

oldValue -属性的旧值

newValue -新的属性值

异常

PropertyVetoException -如果一个听众否决属性更新

fireVetoableChange

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

向已注册的侦听器报告一个布尔受限属性更新，以跟踪所有属性或具有指定名称的属性的更新。

任何听众可以抛出一个PropertyVetoException否决更新。如果一个监听器否决的更新，该方法传递一个新的“撤消”PropertyChangeEvent，归还给所有的听众，已经证实了这一更新，把PropertyVetoException又旧的价值。

如果旧值和新值是相等的，则不会发射任何事件。

这仅仅是在更一般的fireVetoableChange(String, Object, Object)方法方便的包装。

参数

propertyName -这是关于改变物业专业名称

oldValue -属性的旧值

newValue -新的属性值

异常

PropertyVetoException -如果一个听众否决属性更新

fireVetoableChange

public void fireVetoableChange(PropertyChangeEvent event)
                        throws PropertyVetoException

向已注册的侦听器发射属性更改事件，以跟踪所有属性或具有指定名称的属性的更新。

任何听众可以抛出一个PropertyVetoException否决更新。如果一个监听器否决的更新，该方法传递一个新的“撤消”PropertyChangeEvent，归还给所有的听众，已经证实了这一更新，把PropertyVetoException又旧的价值。

如果给定的事件的旧值和新值是相等的和非空值，则不发射任何事件。

参数

event - PropertyChangeEvent被解雇

异常

PropertyVetoException -如果一个听众否决属性更新

hasListeners

public boolean hasListeners(String propertyName)

检查是否有特定属性的侦听器，包括所有已注册的属性的侦听器。如果 propertyName是空的，只有检查所有性质注册的监听器。

参数

propertyName -属性名称。

结果

如果给定的属性有一个或多个侦听器，则为