Класс VetoableChangeSupport

public VetoableChangeSupport(Object sourceBean)

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

public void addVetoableChangeListener(VetoableChangeListener listener)

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

public void removeVetoableChangeListener(VetoableChangeListener listener)

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

public VetoableChangeListener[] getVetoableChangeListeners()

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

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

public void addVetoableChangeListener(String propertyName, VetoableChangeListener listener)

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

public void removeVetoableChangeListener(String propertyName, VetoableChangeListener listener)

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

public VetoableChangeListener[] getVetoableChangeListeners(String propertyName)

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

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

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

Любой слушатель может бросить PropertyVetoException , чтобы запретить обновление. Если один из слушателей запрещает обновление, этот метод передаёт новое «отмена» PropertyChangeEvent , которое возвращает к старому значению, всем слушателям, которые уже подтвердили это обновление и снова бросает PropertyVetoException.

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

Это просто удобная оболочка вокруг более общего метода fireVetoableChange(PropertyChangeEvent).

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

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

Любой слушатель может бросить PropertyVetoException , чтобы запретить обновление. Если один из слушателей запрещает обновление, этот метод передаёт новое «отмена» PropertyChangeEvent , которое возвращает к старому значению, всем слушателям, которые уже подтвердили это обновление и снова бросает PropertyVetoException .

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

Это просто удобная оболочка вокруг более общего метода fireVetoableChange(String, Object, Object).

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

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

Любой слушатель может бросить PropertyVetoException , чтобы запретить обновление. Если один из слушателей запрещает обновление, этот метод передаёт новое «отмена» PropertyChangeEvent , которое возвращает к старому значению, всем слушателям, которые уже подтвердили это обновление и снова бросает PropertyVetoException .

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

Это просто удобная оболочка вокруг более общего метода fireVetoableChange(String, Object, Object).

public void fireVetoableChange(PropertyChangeEvent event) throws PropertyVetoException

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

Любой слушатель может бросить PropertyVetoException , чтобы запретить обновление. Если один из слушателей запрещает обновление, этот метод передаёт новое «отмена» PropertyChangeEvent , которое возвращает к старому значению, всем слушателям, которые уже подтвердили это обновление и снова бросает PropertyVetoException .

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

public boolean hasListeners(String propertyName)

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