csbase.remote

Class RemoteObjectObservable

java.lang.Object

csbase.remote.RemoteObjectObservable

All Implemented Interfaces:

RemoteObservable, RemoteObserverNotifierInterface, Remote

public abstract class RemoteObjectObservable
extends Object
implements RemoteObservable, RemoteObserverNotifierInterface

A classe RemoteObjectObservable representa um objeto que pode ser observado remotamente. Essa classe pode ser estendida para representar um objeto remoto que a aplicação precisa observar.

Um objeto pode ser observado por diversos observadores remotos. Um observador remoto deve implementar a interface RemoteObserver. Quando um objeto observado sofre alguma mudança, informada pelo método setChanged, todos os observadores são notificados através do seu método update.

Author:

Tecgraf/PUC-Rio

Field Summary

Fields

Modifier and Type	Field and Description
protected RemoteObserversNotificationManager	observerManager Observadores remotos.

Constructor Summary

Constructors

Constructor and Description
RemoteObjectObservable(Locale locale) Constrói um objeto observável

Method Summary

Modifier and Type	Method and Description
void	addObserver(RemoteObserver o, Object arg) Inclui um observador remoto no conjunto de observadores.
int	countObservers() Retorna o número de observadores registrados nesse objeto.
boolean	deleteObserver(ObserverData od) Remove um observador remoto do conjunto de observadores desse objeto.
boolean	deleteObserver(RemoteObserver o, Object arg) Remove um observador remoto do conjunto de observadores desse objeto.
void	deleteObservers() Remove todos os observadores registrados nesse objeto.
protected abstract boolean	has2Update(Object arg, Object event) Método para indicar se o observador deve ser notificado.
boolean	has2update(ObserverData observerData, Object event) Verifica se um evento deve ser enviado para um observador.
void	notifyObservers(RemoteEvent event) Envia uma notificação para todos os observadores registrados quando o objeto tiver alguma mudança indicada pelo método hasChanged.

Methods inherited from class java.lang.Object

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

Methods inherited from interface csbase.remote.RemoteObserverNotifierInterface

handleException, handleFatalError, isLoggingNotifications, logNotification

Field Detail

observerManager

protected RemoteObserversNotificationManager observerManager

Observadores remotos. Usamos um conjunto pois a ordem não é relevante.

Constructor Detail

RemoteObjectObservable

public RemoteObjectObservable(Locale locale)

Constrói um objeto observável

Parameters:

locale - Locale.

Method Detail

addObserver

public void addObserver(RemoteObserver o,
                        Object arg)

Inclui um observador remoto no conjunto de observadores. Um observador remoto deve implementar a interface RemoteObserver. Se esse observador já pertencer ao conjunto, a nova referência substitui a anterior.

Specified by:

addObserver in interface RemoteObservable

Parameters:

o - um observador remoto que vai ser incluído

arg - argumento do observador

deleteObserver

public boolean deleteObserver(RemoteObserver o,
                              Object arg)

Remove um observador remoto do conjunto de observadores desse objeto.

Specified by:

deleteObserver in interface RemoteObservable

Parameters:

o - o obsevador remoto a ser removido

arg - o argumento do observador

Returns:

true se o observador foi removido

deleteObserver

public boolean deleteObserver(ObserverData od)

Remove um observador remoto do conjunto de observadores desse objeto.

Parameters:

od - dados do observador remoto (observador + argumento)

Returns:

true se o observador foi removido

notifyObservers

public void notifyObservers(RemoteEvent event)

Envia uma notificação para todos os observadores registrados quando o objeto tiver alguma mudança indicada pelo método hasChanged. Após a notificação ser enviada, invoca o método clearChanged para indicar que a mudança já foi notificada.

Cada observador é notificado através da chamada ao método update que recebe como parâmetro um argumento para indicar qual a mudança ocorrida.

Specified by:

notifyObservers in interface RemoteObservable

Parameters:

event - um argumento qualquer para a notificação de mudança

See Also:

RemoteObserver.update(RemoteEvent)

has2Update

protected abstract boolean has2Update(Object arg,
                                      Object event)

Método para indicar se o observador deve ser notificado.

Parameters:

arg - Argumento do Observador

event - Evento gerado para notificar o observador

Returns:

True quando o observador deve ser notificado. False caso contrário

deleteObservers

public void deleteObservers()

Remove todos os observadores registrados nesse objeto.

Specified by:

deleteObservers in interface RemoteObservable

countObservers

public int countObservers()

Retorna o número de observadores registrados nesse objeto.

Specified by:

countObservers in interface RemoteObservable

Returns:

o número de observadores

has2update

public boolean has2update(ObserverData observerData,
                          Object event)

Verifica se um evento deve ser enviado para um observador.

Specified by:

has2update in interface RemoteObserverNotifierInterface

Parameters:

observerData - observador

event - evento

Returns:

true se o evento deve ser enviado para o observador