Класс PropertyChangeSupport

public PropertyChangeSupport(Object sourceBean)

Создаёт объект PropertyChangeSupport.

public void addPropertyChangeListener(PropertyChangeListener listener)

Добавляет обработчик PropertyChangeListener в список слушателей. Слушатель регистрируется для всех свойств. Один и тот же объект слушателя можно добавлять несколько раз, и он будет вызываться столько раз, сколько раз он был добавлен. Если listener равен null, исключение не выбрасывается, и никаких действий не выполняется.

public void removePropertyChangeListener(PropertyChangeListener listener)

Удаляет обработчик PropertyChangeListener из списка слушателей. Это удаляет обработчик PropertyChangeListener, который был зарегистрирован для всех свойств. Если listener был добавлен более одного раза к одному и тому же источнику событий, он будет оповещён на одну операцию вызова меньше после удаления. Если listener равен null или никогда не добавлялся, исключение не выбрасывается, и никаких действий не выполняется.

public PropertyChangeListener[] getPropertyChangeListeners()

Возвращает массив всех слушателей, которые были добавлены к объекту PropertyChangeSupport с помощью addPropertyChangeListener().

Если некоторые слушатели были добавлены с указанным именем свойства, то возвращаемый массив будет содержать смесь обработчиков PropertyChangeListener и 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"
     }
   }
 }
 

public void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)

Добавляет обработчик PropertyChangeListener для определённого свойства. Слушатель будет вызываться только тогда, когда вызов firePropertyChange называет это конкретное свойство. Один и тот же объект слушателя может быть добавлен более одного раза. Для каждого свойства слушатель будет вызываться количество раз, равное количеству добавлений для этого свойства. Если propertyName или listener равны null, исключение не выбрасывается, и никаких действий не выполняется.

public void removePropertyChangeListener(String propertyName, PropertyChangeListener listener)

Удаляет обработчик PropertyChangeListener для определённого свойства. Если listener был добавлен более одного раза к одному и тому же источнику событий для указанного свойства, он будет оповещён на одну операцию вызова меньше после удаления. Если propertyName равен null, исключение не выбрасывается, и никаких действий не выполняется. Если listener равен null или никогда не добавлялся для указанного свойства, исключение не выбрасывается, и никаких действий не выполняется.

public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)

Возвращает массив всех слушателей, которые были связаны с указанным свойством.

public void firePropertyChange(String propertyName, Object oldValue, Object newValue)

Сообщает слушателям об обновлении связанного свойства, которые зарегистрированы для отслеживания обновлений всех свойств или свойства с указанным именем.

Событие не генерируется, если старое и новое значения равны и не равны null.

Это просто удобная обертка над более общей firePropertyChange(PropertyChangeEvent) методом.

public void firePropertyChange(String propertyName, int oldValue, int newValue)

Сообщает слушателям об обновлении целого связанного свойства, которые зарегистрированы для отслеживания обновлений всех свойств или свойства с указанным именем.

Событие не генерируется, если старое и новое значения равны.

Это просто удобная обертка над более общей firePropertyChange(String, Object, Object) методом.

public void firePropertyChange(String propertyName, boolean oldValue, boolean newValue)

Сообщает слушателям об обновлении булевого связанного свойства, которые зарегистрированы для отслеживания обновлений всех свойств или свойства с указанным именем.

Событие не генерируется, если старое и новое значения равны.

Это просто удобная обертка над более общей firePropertyChange(String, Object, Object) методом.

public void firePropertyChange(PropertyChangeEvent event)

Отправляет событие изменения свойства слушателям, которые зарегистрированы для отслеживания обновлений всех свойств или свойства с указанным именем.

Событие не отправляется, если старое и новое значения данного события равны и не равны null.

public void fireIndexedPropertyChange(String propertyName, int index, Object oldValue, Object newValue)

Сообщает слушателям об обновлении индексированного связанного свойства, которые зарегистрированы для отслеживания обновлений всех свойств или свойства с указанным именем.

Событие не генерируется, если старое и новое значения равны и не равны null.

Это просто удобная обертка над более общей firePropertyChange(PropertyChangeEvent) методом.

public void fireIndexedPropertyChange(String propertyName, int index, int oldValue, int newValue)

Сообщает слушателям об обновлении целого индексированного связанного свойства, которые зарегистрированы для отслеживания обновлений всех свойств или свойства с указанным именем.

Событие не генерируется, если старое и новое значения равны.

Это просто удобная обертка над более общей fireIndexedPropertyChange(String, int, Object, Object) методом.

public void fireIndexedPropertyChange(String propertyName, int index, boolean oldValue, boolean newValue)

Сообщает слушателям об обновлении булевого индексированного связанного свойства, которые зарегистрированы для отслеживания обновлений всех свойств или свойства с указанным именем.

Событие не генерируется, если старое и новое значения равны.

Это просто удобная обертка над более общей fireIndexedPropertyChange(String, int, Object, Object) методом.

public boolean hasListeners(String propertyName)

Проверяет наличие слушателей для определённого свойства, включая тех, которые зарегистрированы для всех свойств. Если propertyName равно null, проверяются только слушатели, зарегистрированные для всех свойств.