设置约束属性
源Bean设置约束属性的步骤如下:
实现一个机制,可以让实现了VetoableChangeListener接口的监听对象在接受属性变化通知时,注册或者注销其兴趣。这些监听对象并不是接受已经发生变化的属性的通知,而是接受拟议中的属性改变通知。
Bean通过对VetoableChangeSupport工具类采用继承或者实例化的方式,来完成上述任务,该类中含有把VetoableChangeListener对象添加到监听列表中,以及从监听列表中移去该对象的方法,还含有一个发送属性改变事件的方法,同时也捕捉和响应有关事件。 fireVetoableChange(<property name>,<old value>, <new value>);
addVetoableChangeListener(listener);
removeVetoableChangeListener(listener);
把拟议中的属性改变事件发送给感兴趣的监听者。因为这些属性改变的建议可能被否决,所以源Bean在属性值变化发生之前,就把该拟议事件发送出去。源Beans通过调用监听者的vetoableChange方法来发送PropertyChangeEvent。
为监听对象提供了一条途径,使得一旦监听者之一否决拟议中的属性变化之后,还可以保持属性原来的值。为了完成这件事,源Bean 调用 vetoableChange之前,要首先把属性的初始值传递给监听者。
剖析一个例子
名为JellyBean的JavaBean实现了一个约束属性,后者调用priceInCents。该 Bean初始化时,对两个新的对象VetoableChangeSupport 对象(用于维护可否决监听者列表),PropertyChangeSupport 对象(用来存放属性改变监听者列表)进行实例化。代码如下:
private VetoableChangeSupport vetos = new VetoableChangeSupport(this);
private PropertyChangeSupport changes = new PropertyChangeSupport(this);
之后,JellyBean实现了VetoableChangeSupport接口方法,用来注册和注销约束属性变化监听者:
public void addVetoableChangeListener(VetoableChangeListener l) {
vetos.addVetoableChangeListener(l);
}
public void removeVetoableChangeListener(VetoableChangeListener l) {
vetos.removeVetoableChangeListener(l);
}
上述的添加和移去监听者的方法适用于Bean中的所有约束属性。指定监听者仅仅同Bean中的特定约束属性相关联也是可能的。如果是这样,上述这两个方法可以包括一个包含属性名的附加String参数。在参数表中首先出现的是参数名,后面跟着的是监听器对象。例如,对于指定的属性添加监听Bean。
public void addVetoableChangeListener(String propertyName, VetoableChangeListener listener);
参照如下例子,通过指定特定的属性名,你可以对每个属性注册和注销可否决变化的监听者:
void add<PropertyName>Listener(VetoableChangeListener p);
void remove<PropertyName>Listener(VetoableChangeListener p);
JellyBean也定义了一个方法,以获得当前的价格,以及定义了另外一个方法来设置新价格,在设置新价格的方法中,JellyBean调用方法fireVetoableChange,来通知注册属性变化监听器。
public void setPriceInCents(int newPriceInCents)
throws PropertyVetoException {
vetos.fireVetoableChange("priceInCents",
new Integer(oldPriceInCents),
new Integer(newPriceInCents));
//if vetoed (PropertyVetoException thrown)
// don't catch
// exception here so routine exits.
//if not vetoed, make the property
// change
ourPriceInCents = newPriceInCents;
changes.firePropertyChange(
"priceInCents",
new Integer(oldPriceInCents),
new Integer(newPriceInCents));
}
一旦该Bean执行了fireVetoableChange方法,它就会通知感兴趣的监听者:priceInCents 即将发生变化,并告知它们当前的价格和新价格。如果该方法成功地执行了,就意味着没有例外发生,就表明没有监听者拒绝这项拟议中的改变。之后,setPriceInCents方法就执行firePropertyChange方法,来发送属性变化事件,以通知监听者属性已经发生变化。
然而,如果fireVetoableChange方法抛出了一个PropertyVetoException例外,就表明监听者已经拒绝了拟议中的改变。拟议中的属性改变将不会生效。SetPriceInCents方法没有捕捉到例外,这样退出该方法之后,就可以使得例外可以在更高一级的水平上得到处理。