На прошлом занятии мы начали разбирать вопрос создания и использования связанного свойства. Мы определили инструкцию или краткий перечень действий для создания связанного свойства.

Но некоторые пункты инструкции требуют более подробного рассмотрения.

Приведем еще раз эту инструкцию.

• 1. Для регистрации/дерегистрации слушателя необходимо в бине реализовать два метода:

         public void addPropertyChangeListener(PropertyChangeListener pcl)
            
  

  и

         public void removePropertyChangeListener(PropertyChangeListener pcl)
            
  

• 2. Чтобы не реализовывать их вручную лучше воспользоваться существующим классом java.beans.PropertyChangeSupport (см. документацию).
• 3. В set-методе связанного свойства необходимо добавить вызов метода класса java.beans.PropertyChangeSupport — firePropertyChange .
• 4. В классе-слушателе необходимо реализовать интерфейс PropertyChangeListener , т.е. в заголовке класса записать " implements PropertyChangeListener ", а в теле класса реализовать метод

             public void propertyChange(PropertyChangeEvent evt)
            
  

• 5. Создать объект-слушатель и зарегистрировать его как слушателя нашего бина при помощи метода addPropertyChangeListener , который был нами реализован в п.1. Лучше всего это сделать сразу после порождения объекта-слушателя, например,

             MyLitener obj = new MyListener();
             myBean.addPropertyChangeListener(obj);
            
  

  где myBean — наш бин (имеется в виду объект, а не класс).

Пункт 4-й должен быть реализован для каждого класса-слушателя, а п.5 — для каждого порожденного объекта-слушателя.

Разберемся подробнее с пунктами 2 и 3.

С событиями мы знакомились в рамках 20-го занятия. Но там мы рассматривали подключение слушателей к объектам источникам событий. Сейчас же нам нужно реализовать генерацию событий. Наш бин должен генерировать событие PropertyChangeEvent при изменении связанного свойства (п.3). Кроме того, согласно правилам событийной модели Java он должен обеспечивать регистрацию/дерегистрацию слушателей при помощи соответствующих методов add...Listener / remove...Listener (п.2).

Т.е. нам нужно обеспечить наличие в бине некоторого списка слушателей, а также методы addPropertyChangeListener и removePropertyChangeListener .

К счастью, нам не требуется программировать все это. Соответствующий инструментарий уже подготовлен в пакете java.beans — это класс java.beans.PropertyChangeSupport . Он обеспечивает регистрацию слушателей и методы firePropertyChange , которые можно использовать в тех местах, где требуется сгенерировать событие, т.е. в set-методах, которые изменяют значение связанных атрибутов.

Разберем это на примере.

Пусть мы имеем некоторый бин SomeBean с одним свойством someProperty :

public class SomeBean {

    private String someProperty = null;

    public SomeBean() {
    }

    public String getSomeProperty() {
        return someProperty;
    }

    public void setSomeProperty(String value) {
        someProperty = value;
    }

}

Переделаем его так, чтобы сойство someProperty стало связанным:

import java.beans.*;

public class SomeBean {

    private String someProperty = null;

    private PropertyChangeSupport pcs;

    public SomeBean() {
        pcs = new PropertyChangeSupport(this);
    }

    public void addPropertyChangeListener(PropertyChangeListener pcl) {
        pcs.addPropertyChangeListener(pcl);
    }
    
    
    public void removePropertyChangeListener(PropertyChangeListener pcl) {
        pcs.removePropertyChangeListener(pcl);
    }

    public String getSomeProperty() {
        return someProperty;
    }

    public void setSomeProperty(String value) {
        pcs.firePropertyChange("someProperty", someProperty, value);
        someProperty = value;
    }

}

Здесь мы реализовали пункты 1, 2 и 3 приведенной инструкции. Остальные пункты относятся к использованию связанного свойства и для их демонстрации потребуется более реальный пример.

Для обеспечения механизма генерации событий в классе SomeBean создан объект класса PropertyChangeSupport (поле pcs ). И все действия по регистрации/дерегистрции слушателей, по собственно генерации событий "переадресуются" этому объекту, который за нас выполняет всю эту рутинную работу.

Так, например, метод

public void addPropertyChangeListener(PropertyChangeListener pcl)

нашего класса просто обращается к одноименному методу класса PropertyChangeSupport .

В методе setSomeProperty перед собственно изменением значения свойства someProperty генерируется событие PropertyChangeEvent . Для этого вызывается метод firePropertyChange , который обеспечивает все необходимые для такой генерации действия.

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

Добавим в наш пример редактирования файла (Dlg5.java) метку в нижнюю область экрана. Будем выводить в нее информацию: имя файла и количество строк файла. Для этого реализуем наш основной класс как бин со связанным свойством currentFile . А для метки построим класс-слушатель на основе JLabel , создадим объект этого класса, добавим его на экран и зарегистрируем как слушателя основного класса.

Проделайте это сами. Если не получится, решение можно загрузить отсюда: Dlg5.java .