Класс Observable

Этот класс представляет наблюдаемый объект или «данные» в парадигме модель-представление. Он может быть подклассом для представления объекта, за которым приложение хочет наблюдать.

Наблюдаемый объект может иметь одного или нескольких наблюдателей. Наблюдатель может быть любым объектом, который реализует интерфейс Observer. После изменения экземпляра наблюдаемого объекта вызов метода Observable's notifyObservers вызывает уведомление всех его наблюдателей об изменении путем вызова их метода update.

Порядок доставки уведомлений не определен. Реализация по умолчанию в классе Observable будет уведомлять наблюдателей в порядке их регистрации, но подклассы могут изменить этот порядок, не использовать гарантированный порядок, доставлять уведомления в отдельных потоках или гарантировать, что их подкласс следует этому порядку, по своему усмотрению.

Обратите внимание, что этот механизм уведомления не связан с потоками и полностью отделен от механизма wait и notify класса Object.

При создании нового наблюдаемого объекта его набор наблюдателей пуст. Два наблюдателя считаются одинаковыми, если и только если для них метод equals возвращает true.

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

Observable

public Observable()

Создает наблюдаемый объект без наблюдателей.

Методы

addObserver

public void addObserver(Observer o)

Добавляет наблюдателя в набор наблюдателей для этого объекта, при условии, что он не совпадает с наблюдателем, уже входящим в набор. Порядок, в котором будут доставлены уведомления нескольким наблюдателям, не определен. См. комментарий к классу.

Параметры:

o - наблюдатель для добавления.

Исключения:

NullPointerException - если параметр o равен null.

deleteObserver

public void deleteObserver(Observer o)

Удаляет наблюдателя из набора наблюдателей этого объекта. Передача null в этот метод не окажет никакого влияния.

Параметры:

o - наблюдатель для удаления.

notifyObservers

public void notifyObservers()

notifyObservers(null)

См. также:

clearChanged(), hasChanged(), Observer.update(java.util.Observable, java.lang.Object)

notifyObservers

public void notifyObservers(Object arg)

Параметры:

arg - любой объект.

См. также:

clearChanged(), hasChanged(), Observer.update(java.util.Observable, java.lang.Object)

deleteObservers

public void deleteObservers()

Очищает список наблюдателей, так что этот объект больше не имеет наблюдателей.

setChanged

protected void setChanged()

Помечает этот объект Observable как измененный; метод hasChanged теперь вернет true.

clearChanged

protected void clearChanged()

Указывает, что этот объект больше не изменился или что он уже уведомил всех своих наблюдателей о последнем изменении, так что метод hasChanged теперь вернет false. Этот метод вызывается автоматически методами notifyObservers.

См. также:

notifyObservers(), notifyObservers(java.lang.Object)

hasChanged

public boolean hasChanged()

Проверяет, изменился ли этот объект.

Возвращает:

true если и только если метод setChanged был вызван позже, чем метод clearChanged в этом объекте; false в противном случае.

См. также:

clearChanged(), setChanged()

countObservers

public int countObservers()

Возвращает количество наблюдателей этого объекта Observable.

Возвращает:

количество наблюдателей этого объекта.