java.util

Заметный класс

java.lang. Объект

java.util. Заметный

public class Observable
extends Object

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

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

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

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

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

С тех пор:

JDK1.0

См. Также:

notifyObservers(), notifyObservers(java.lang.Object), Observer, Observer.update(java.util.Observable, java.lang.Object)

Сводка конструктора

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

Конструктор и Описание
Observable() Создайте Заметное с нулевыми Наблюдателями.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	addObserver(Observer o) Добавляет наблюдатель к группе наблюдателей для этого объекта, при условии, что это не то же самое как некоторый наблюдатель уже в наборе.
protected void	clearChanged() Указывает, что этот объект больше не изменился, или что он уже уведомил всех своих наблюдателей его нового изменения, так, чтобы метод hasChanged теперь возвратил false.
int	countObservers() Возвращает число наблюдателей этого объекта Observable.
void	deleteObserver(Observer o) Удаляет наблюдателя из группы наблюдателей этого объекта.
void	deleteObservers() Очищает список наблюдателя так, чтобы у этого объекта больше не было наблюдателей.
boolean	hasChanged() Тесты, если этот объект изменился.
void	notifyObservers() Если этот объект изменился, как обозначено hasChanged метод, затем уведомьте всех его наблюдателей и затем вызовите clearChanged метод, чтобы указать, что этот объект больше не изменился.
void	notifyObservers(Object arg) Если этот объект изменился, как обозначено hasChanged метод, затем уведомьте всех его наблюдателей и затем вызовите clearChanged метод, чтобы указать, что этот объект больше не изменился.
protected void	setChanged() Марки этот Observable возражают как измененный; метод hasChanged теперь возвратит true.

Методы java.lang унаследованный от класса. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

Заметный

public Observable()

Создайте Заметное с нулевыми Наблюдателями.

Деталь метода

addObserver

public void addObserver(Observer o)

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

Параметры:

o - наблюдатель, который будет добавлен.

Броски:

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

deleteObserver

public void deleteObserver(Observer o)

Удаляет наблюдателя из группы наблюдателей этого объекта. Передача null к этому методу не будет иметь никакого эффекта.

Параметры:

o - наблюдатель, который будет удален.

notifyObservers

public void notifyObservers()

Если этот объект изменился, как обозначено hasChanged метод, затем уведомьте всех его наблюдателей и затем вызовите clearChanged метод, чтобы указать, что этот объект больше не изменился.

У каждого наблюдателя есть update метод вызывал с двумя параметрами: этот заметный объект и null. Другими словами этот метод эквивалентен:

notifyObservers(null)

См. Также:

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

notifyObservers

public void notifyObservers(Object arg)

Если этот объект изменился, как обозначено hasChanged метод, затем уведомьте всех его наблюдателей и затем вызовите clearChanged метод, чтобы указать, что этот объект больше не изменился.

У каждого наблюдателя есть update метод вызывал с двумя параметрами: этот заметный объект и 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.

Возвраты:

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