模块  java.desktop
软件包  java.beans

Class PropertyChangeSupport

  • 实现的所有接口
    Serializable
    已知直接子类:
    SwingPropertyChangeSupport

    public class PropertyChangeSupport
    extends Object
    implements Serializable
    这是一个可以由支持绑定属性的bean使用的实用程序类。 它管理一个监听器列表并向他们发送PropertyChangeEvent 您可以将此类的实例用作bean的成员字段,并将这些类型的工作委托给它。 可以为所有属性或名称指定的属性注册PropertyChangeListener

    以下是PropertyChangeSupport用法的示例,它遵循JavaBeans规范中规定的规则和建议:

      public class MyBean {
         private final PropertyChangeSupport pcs = new PropertyChangeSupport(this);
    
         public void addPropertyChangeListener(PropertyChangeListener listener) {
             this.pcs.addPropertyChangeListener(listener);
         }
    
         public void removePropertyChangeListener(PropertyChangeListener listener) {
             this.pcs.removePropertyChangeListener(listener);
         }
    
         private String value;
    
         public String getValue() {
             return this.value;
         }
    
         public void setValue(String newValue) {
             String oldValue = this.value;
             this.value = newValue;
             this.pcs.firePropertyChange("value", oldValue, newValue);
         }
    
         [...]
     } 

    PropertyChangeSupport实例是线程安全的。

    这个类是可序列化的。 当它被序列化时,它将保存(和恢复)任何本身可序列化的侦听器。 序列化期间将跳过任何不可序列化的侦听器。

    从以下版本开始:
    1.1
    另请参见:
    VetoableChangeSupportSerialized Form
    • 构造方法详细信息

      • PropertyChangeSupport

        public PropertyChangeSupport​(Object sourceBean)
        构造一个 PropertyChangeSupport对象。
        参数
        sourceBean - 将作为任何事件的源提供的bean。
    • 方法详细信息

      • addPropertyChangeListener

        public void addPropertyChangeListener​(PropertyChangeListener listener)
        将PropertyChangeListener添加到侦听器列表。 监听器已注册所有属性。 可以多次添加相同的侦听器对象,并且在添加时将多次调用它。 如果listener为null,则不会引发任何异常并且不执行任何操作。
        参数
        listener - 要添加的PropertyChangeListener
      • removePropertyChangeListener

        public void removePropertyChangeListener​(PropertyChangeListener listener)
        从侦听器列表中删除PropertyChangeListener。 这将删除为所有属性注册的PropertyChangeListener。 如果listenerlistener添加到同一事件源,则会在删除后将其通知一次。 如果listener为null,或者从未添加过,则不会引发任何异常并且不执行任何操作。
        参数
        listener - 要删除的PropertyChangeListener
      • getPropertyChangeListeners

        public PropertyChangeListener[] getPropertyChangeListeners()
        返回使用addPropertyChangeListener()添加到PropertyChangeSupport对象的所有侦听器的数组。

        如果某些侦听器添加了命名属性,则返回的数组将是PropertyChangeListeners和PropertyChangeListenerProxy的混合。 如果调用方法有兴趣区分侦听器,那么它必须测试每个元素以查看它是否为PropertyChangeListenerProxy ,执行PropertyChangeListenerProxy并检查参数。

           PropertyChangeListener[] listeners = bean.getPropertyChangeListeners(); for (int i = 0; i < listeners.length; i++) { if (listeners[i] instanceof PropertyChangeListenerProxy) { PropertyChangeListenerProxy proxy = (PropertyChangeListenerProxy)listeners[i]; if (proxy.getPropertyName().equals("foo")) { // proxy is a PropertyChangeListener which was associated // with the property named "foo" } } }  
        结果
        如果没有添加侦听器,则添加所有 PropertyChangeListeners或空数组
        从以下版本开始:
        1.4
        另请参见:
        PropertyChangeListenerProxy
      • addPropertyChangeListener

        public void addPropertyChangeListener​(String propertyName,
                                              PropertyChangeListener listener)
        为特定属性添加PropertyChangeListener。 仅当对firePropertyChange的调用命名该特定属性时,才会调用侦听器。 可以多次添加相同的侦听器对象。 对于每个属性,将调用侦听器为该属性添加的次数。 如果propertyNamelistener为null,则不会引发任何异常并且不执行任何操作。
        参数
        propertyName - 要侦听的属性的名称。
        listener - 要添加的PropertyChangeListener
        从以下版本开始:
        1.2
      • removePropertyChangeListener

        public void removePropertyChangeListener​(String propertyName,
                                                 PropertyChangeListener listener)
        删除特定属性的PropertyChangeListener。 如果listenerlistener添加到指定属性的同一事件源,则会在删除后将其通知一次。 如果propertyName为null,则不会引发任何异常并且不执行任何操作。 如果listener为null,或者从未为指定的属性添加,则不会引发任何异常并且不执行任何操作。
        参数
        propertyName - 已侦听的属性的名称。
        listener - 要删除的PropertyChangeListener
        从以下版本开始:
        1.2
      • getPropertyChangeListeners

        public PropertyChangeListener[] getPropertyChangeListeners​(String propertyName)
        返回已与命名属性关联的所有侦听器的数组。
        参数
        propertyName - 要侦听的属性的名称
        结果
        所有PropertyChangeListeners与命名属性相关联。 如果未添加此类侦听器,或者如果propertyName为null,则返回空数组。
        从以下版本开始:
        1.4
      • firePropertyChange

        public void firePropertyChange​(String propertyName,
                                       Object oldValue,
                                       Object newValue)
        向已注册的侦听器报告绑定属性更新,以跟踪所有属性或具有指定名称的属性的更新。

        如果旧值和新值相等且非null,则不会触发任何事件。

        这仅仅是围绕更一般的firePropertyChange(PropertyChangeEvent)方法的便利包装器。

        参数
        propertyName - 已更改的属性的编程名称
        oldValue - 属性的旧值
        newValue - 该属性的新值
      • firePropertyChange

        public void firePropertyChange​(String propertyName,
                                       int oldValue,
                                       int newValue)
        向已注册以跟踪所有属性或具有指定名称的属性的更新的侦听器报告整数绑定属性更新。

        如果旧值和新值相等,则不会触发任何事件。

        这仅仅是更通用的firePropertyChange(String, Object, Object)方法的便利包装器。

        参数
        propertyName - 已更改的属性的编程名称
        oldValue - 该属性的旧值
        newValue - 该物业的新值
        从以下版本开始:
        1.2
      • firePropertyChange

        public void firePropertyChange​(String propertyName,
                                       boolean oldValue,
                                       boolean newValue)
        向已注册的侦听器报告布尔绑定属性更新,以跟踪所有属性或具有指定名称的属性的更新。

        如果旧值和新值相等,则不会触发任何事件。

        这仅仅是围绕更一般的firePropertyChange(String, Object, Object)方法的便利包装器。

        参数
        propertyName - 已更改的属性的编程名称
        oldValue - 该物业的旧价值
        newValue - 该物业的新值
        从以下版本开始:
        1.2
      • firePropertyChange

        public void firePropertyChange​(PropertyChangeEvent event)
        将属性更改事件触发到已注册以跟踪所有属性或具有指定名称的属性的更新的侦听器。

        如果给定事件的旧值和新值相等且非null,则不会触发任何事件。

        参数
        event - 被解雇的 PropertyChangeEvent
        从以下版本开始:
        1.2
      • fireIndexedPropertyChange

        public void fireIndexedPropertyChange​(String propertyName,
                                              int index,
                                              Object oldValue,
                                              Object newValue)
        向已注册以跟踪所有属性或具有指定名称的属性的更新的侦听器报告绑定的索引属性更新。

        如果旧值和新值相等且非null,则不会触发任何事件。

        这仅仅是围绕更一般的firePropertyChange(PropertyChangeEvent)方法的便利包装器。

        参数
        propertyName - 已更改的属性的编程名称
        index - 已更改的属性元素的索引
        oldValue - 属性的旧值
        newValue - 该物业的新值
        从以下版本开始:
        1.5
      • fireIndexedPropertyChange

        public void fireIndexedPropertyChange​(String propertyName,
                                              int index,
                                              int oldValue,
                                              int newValue)
        向已注册以跟踪所有属性或具有指定名称的属性的更新的侦听器报告整数绑定索引属性更新。

        如果旧值和新值相等,则不会触发任何事件。

        这仅仅是围绕更一般的fireIndexedPropertyChange(String, int, Object, Object)方法的便利包装器。

        参数
        propertyName - 已更改的属性的编程名称
        index - 已更改的属性元素的索引
        oldValue - 该物业的旧价值
        newValue - 该属性的新值
        从以下版本开始:
        1.5
      • fireIndexedPropertyChange

        public void fireIndexedPropertyChange​(String propertyName,
                                              int index,
                                              boolean oldValue,
                                              boolean newValue)
        向已注册以跟踪所有属性或具有指定名称的属性的更新的侦听器报告布尔绑定索引属性更新。

        如果旧值和新值相等,则不会触发任何事件。

        这只是一个更方便的fireIndexedPropertyChange(String, int, Object, Object)方法的便利包装器。

        参数
        propertyName - 已更改的属性的编程名称
        index - 已更改的属性元素的索引
        oldValue - 该物业的旧价值
        newValue - 该物业的新价值
        从以下版本开始:
        1.5
      • hasListeners

        public boolean hasListeners​(String propertyName)
        检查是否有特定属性的侦听器,包括在所有属性上注册的属性。 如果propertyName为null,则仅检查在所有属性上注册的侦听器。
        参数
        propertyName - 房产名称。
        结果
        如果给定属性有一个或多个侦听器,则为true
        从以下版本开始:
        1.2