Класс VetoableChangeSupport

Это утилитарный класс, который может быть использован компонентами, поддерживающими ограниченные свойства. Он управляет списком слушателей и рассылает события PropertyChangeEvent им. Вы можете использовать экземпляр этого класса в качестве члена вашего компонента и делегировать ему обработку таких событий. VetoableChangeListener могут быть зарегистрированы для всех свойств или для свойства, указанного по имени.

Вот пример VetoableChangeSupport использования, который следует правилам и рекомендациям, изложенным в спецификации JavaBeans™:

public class MyBean {
     private final VetoableChangeSupport vcs = new VetoableChangeSupport(this);

     public void addVetoableChangeListener(VetoableChangeListener listener) {
         this.vcs.addVetoableChangeListener(listener);
     }

     public void removeVetoableChangeListener(VetoableChangeListener listener) {
         this.vcs.removeVetoableChangeListener(listener);
     }

     private String value;

     public String getValue() {
         return this.value;
     }

     public void setValue(String newValue) throws PropertyVetoException {
         String oldValue = this.value;
         this.vcs.fireVetoableChange("value", oldValue, newValue);
         this.value = newValue;
     }

     [...]
 }

Экземпляр VetoableChangeSupport потокобезопасен.

Этот класс сериализуем. При сериализации он сохранит (и восстановит) любых слушателей, которые сами являются сериализуемыми. Любые несериализуемые слушатели будут пропущены во время сериализации.

Конструкторы

VetoableChangeSupport

public VetoableChangeSupport(Object sourceBean)

Конструирует объект VetoableChangeSupport.

Параметры:

sourceBean - Компонент, который будет источником событий.

Методы

addVetoableChangeListener

public void addVetoableChangeListener(VetoableChangeListener listener)

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

Параметры:

listener - Добавляемый обработчик VetoableChangeListener

removeVetoableChangeListener

public void removeVetoableChangeListener(VetoableChangeListener listener)

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

Параметры:

listener - Удаляемый обработчик VetoableChangeListener

getVetoableChangeListeners

public VetoableChangeListener[] getVetoableChangeListeners()

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"
     }
   }
 }

Возвращает:

все добавленные VetoableChangeListeners или пустой массив, если слушатели не были добавлены

С:

1.4

См. также:

VetoableChangeListenerProxy

addVetoableChangeListener

public void addVetoableChangeListener(String propertyName,
                                      VetoableChangeListener listener)

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

Параметры:

propertyName - Имя свойства, за которым нужно следить.

listener - Добавляемый обработчик VetoableChangeListener

removeVetoableChangeListener

public void removeVetoableChangeListener(String propertyName,
                                         VetoableChangeListener listener)

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

Параметры:

propertyName - Имя свойства, за которым следили.

listener - Удаляемый обработчик VetoableChangeListener

getVetoableChangeListeners

public VetoableChangeListener[] getVetoableChangeListeners(String propertyName)

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

Параметры:

propertyName - Имя свойства, за которым наблюдают

Возвращает:

все VetoableChangeListeners , связанные с заданным свойством. Если такие слушатели не были добавлены или если propertyName равно null, возвращается пустой массив.

С:

1.4

fireVetoableChange

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

Параметры:

propertyName - Программное имя свойства, которое собирается измениться

oldValue - Старое значение свойства

newValue - Новое значение свойства

Исключения:

PropertyVetoException - если один из слушателей отклоняет обновление свойства

fireVetoableChange

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

Параметры:

propertyName - Программное имя свойства, которое собирается измениться

oldValue - Старое значение свойства

newValue - Новое значение свойства

Исключения:

PropertyVetoException - если один из слушателей отклоняет обновление свойства

fireVetoableChange

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

Параметры:

propertyName - Программное имя свойства, которое собирается измениться

oldValue - Старое значение свойства

newValue - Новое значение свойства

Исключения:

PropertyVetoException - если один из слушателей отклоняет обновление свойства

fireVetoableChange

public void fireVetoableChange(PropertyChangeEvent event)
                        throws PropertyVetoException

Параметры:

event - Событие PropertyChangeEvent для генерации

Исключения:

PropertyVetoException - если один из слушателей отклоняет обновление свойства

hasListeners

public boolean hasListeners(String propertyName)

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

Параметры:

propertyName - имя свойства.

Возвращает:

true, если есть один или несколько слушателей для данного свойства