Класс 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().

Если некоторые слушатели были добавлены со свойством с именем, возвращаемый массив будет смесью PropertyChangeListeners и 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, проверяются только слушатели, зарегистрированные для всех свойств.