csbase.logic

Class MonitoredServer

java.lang.Object

csbase.logic.MonitoredServer

All Implemented Interfaces:

ServerMonitorListener

public abstract class MonitoredServer
extends Object
implements ServerMonitorListener

Guarda os dados referentes a monitoração de um servidor remoto. Mantém a sessão, os ouvintes, observadores e a referência para o serviços exportados. O servidor é considerado vivo se está alcançável e o login foi realizado com sucesso.

Author:

Tecgraf/PUC-Rio

Field Summary

Fields

Modifier and Type	Field and Description
protected AtomicBoolean	alive Estado do servidor.
protected AtomicBoolean	defaultServer Indica se esse servidor monitorado é o default
protected String	delegatedLogin Usuário a ser delegado no login
protected boolean	ignoreVersion Indica se a verificação de versão entre cliente e servidor será ignorada
protected List<MonitoredServerListener>	listeners Lista dos ouvintes
protected Class<?>	locator Classe ou interface que mantém as referências para os objetos remotos.
protected ServerMonitor	monitor O monitor do servidor
protected Map<String,List<ObserverData>>	observers Mapa dos observadores cadastrados
static int	RELOAD_TIME Valor default para o tamanho máximo da janela, caso nenhum valor esteja configurado no Client.properties
protected Set<String>	serviceNames Conjunto com os nomes dos serviços a serem recuperados do servidor.
protected Map<String,ServiceInterface>	services Mapa dos serviços exportados
protected Session	session A sessão do usuário logado
protected String	systemName Nome do sistema a ser definido no servidor
protected TimeZone	timeZone TimeZone para usa no login

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	MonitoredServer(ServerURI serverURI, Class<?> locator, boolean ignoreVersion, boolean verbose, int windowSize) Constrói uma monitoração.
protected	MonitoredServer(ServerURI serverURI, Class<?> locator, boolean ignoreVersion, int windowSize) Constrói uma monitoração.
protected	MonitoredServer(ServerURI serverURI, Class<?> locator, int windowSize) Constrói uma monitoração.
protected	MonitoredServer(ServerURI serverURI, Set<String> serviceNames, boolean ignoreVersion, int windowSize) Constrói uma monitoração.
protected	MonitoredServer(ServerURI serverURI, Set<String> serviceNames, int windowSize) Constrói uma monitoração.

Method Summary

Modifier and Type	Method and Description
protected void	addListener(MonitoredServerListener listener) Adiciona um ouvinte.
boolean	addObserver(String serviceName, RemoteObserver observer, Object arg) Adiciona o observador ao serviço observado.Caso não haja comunicação estabelecida com o servidor, o observador é guardado para envio posterior.
boolean	canReach(ServerURI uri, int port) Verifica se um determinado servidor consegue acessar o host a partir do qual este método foi chamado, em uma determinada porta.
protected void	deleteListener(MonitoredServerListener listener) Remove um ouvinte
void	deleteObserver(String serviceName, RemoteObserver observer, Object arg) Remove o par (observador, arg) do serviço dado.
protected boolean	fetchServices() Recupera as referências para os serviços exportados pelo servidor
protected void	fillLocatorFields() Preenche os campos do locator com as referências para os serviços.
protected void	flush() Executa procedimentos de finalização.
protected ServerMonitor	getMonitor()
protected Set<String>	getServicesNames()
protected Session	getSession()
protected ServerURI	getURI()
void	invalidate() Força revalidar a conexão com o servidor e a sessão. Se o servidor estiver fora, tenta reconectar.
protected boolean	isAlive() Consulta o estado do servidor.
protected boolean	isDefault()
protected abstract String	lng(String key) Método usado para tradução de termos internacionalizados.
protected boolean	login() Executa o login no servidor.
protected void	logout() Pára a monitoração, remove observadores e executa o logout no servidor.
void	notifyServerReachable(ServerURI serverURI) Chamado quando o ServerMonitor reestabelece a conexão com o servidor
void	notifyServerUnreachable(ServerURI serverURI) Chamado quando ServerMonitor detecta que o servidor não está alcançável
protected abstract Session	performLogin() Faz o login com o servidor.
protected abstract void	postLogin() Executado após login com sucesso.
protected void	removeObservers() Remove todos os observadores que este cliente cadastrou.
protected void	sendObservers() Envia os observadores nos serviços correspondentes.
protected void	setAsDefaultServer(boolean isDefaultServer) Marca esta monitoração como sendo a do servidor default
void	setDelegatedLogin(String delegatedLogin) Define o usuário a ser delegado no login
protected void	setSystemName(String systemName) Define o nome do sistema a ser usado
void	setTimeZone(TimeZone timeZone) Define o time zone usado no login do cliente
protected boolean	validate() Valida o servidor.

Methods inherited from class java.lang.Object

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

Field Detail

listeners

protected List<MonitoredServerListener> listeners

Lista dos ouvintes

observers

protected Map<String,List<ObserverData>> observers

Mapa dos observadores cadastrados

services

protected Map<String,ServiceInterface> services

Mapa dos serviços exportados

monitor

protected ServerMonitor monitor

O monitor do servidor

session

protected Session session

A sessão do usuário logado

alive

protected AtomicBoolean alive

Estado do servidor. Considerado vivo (true) se está alcançável e o usuário logado, false caso contrário.

locator

protected Class<?> locator

Classe ou interface que mantém as referências para os objetos remotos.

defaultServer

protected AtomicBoolean defaultServer

Indica se esse servidor monitorado é o default

systemName

protected String systemName

Nome do sistema a ser definido no servidor

delegatedLogin

protected String delegatedLogin

Usuário a ser delegado no login

timeZone

protected TimeZone timeZone

TimeZone para usa no login

serviceNames

protected Set<String> serviceNames

Conjunto com os nomes dos serviços a serem recuperados do servidor. Usado no caso onde o locator não é necessário e funcionaria apenas como repositório para descoberta dos serviços disponíveis

ignoreVersion

protected boolean ignoreVersion

Indica se a verificação de versão entre cliente e servidor será ignorada

RELOAD_TIME

public static final int RELOAD_TIME

Valor default para o tamanho máximo da janela, caso nenhum valor esteja configurado no Client.properties

See Also:

Constant Field Values

Constructor Detail

MonitoredServer

protected MonitoredServer(ServerURI serverURI,
                          Class<?> locator,
                          boolean ignoreVersion,
                          int windowSize)

Constrói uma monitoração.

Parameters:

serverURI - A URI do servidor a ser monitorado

locator - A classe do locator

ignoreVersion - true indica que a verificação de versão entre cliente e servidor será ignorada

windowSize - Valor máximo da janela de backoff.

MonitoredServer

protected MonitoredServer(ServerURI serverURI,
                          Class<?> locator,
                          boolean ignoreVersion,
                          boolean verbose,
                          int windowSize)

Constrói uma monitoração.

Parameters:

serverURI - A URI do servidor a ser monitorado

locator - A classe do locator

ignoreVersion - true indica que a verificação de versão entre cliente e servidor será ignorada

verbose - true se informações devem ser exibidas, false se apenas erros e alertas devem ser exibidos

windowSize - Valor máximo da janela de backoff.

MonitoredServer

protected MonitoredServer(ServerURI serverURI,
                          Class<?> locator,
                          int windowSize)

Constrói uma monitoração.

Parameters:

serverURI - A URI do servidor a ser monitorado

locator - A classe do locator

windowSize - Valor máximo da janela de backoff.

MonitoredServer

protected MonitoredServer(ServerURI serverURI,
                          Set<String> serviceNames,
                          boolean ignoreVersion,
                          int windowSize)

Constrói uma monitoração.

Parameters:

serverURI - A URI do servidor a ser monitorado

serviceNames - Conjunto com os nomes dos serviços a serem disponibilizados

ignoreVersion - true indica que a verificação de versão entre cliente e servidor será ignorada

windowSize - Valor máximo da janela de backoff.

MonitoredServer

protected MonitoredServer(ServerURI serverURI,
                          Set<String> serviceNames,
                          int windowSize)

Constrói uma monitoração.

Parameters:

serverURI - A URI do servidor a ser monitorado

serviceNames - Conjunto com os nomes dos serviços a serem disponibilizados

windowSize - Valor máximo da janela de backoff.

Method Detail

setAsDefaultServer

protected final void setAsDefaultServer(boolean isDefaultServer)

Marca esta monitoração como sendo a do servidor default

Parameters:

isDefaultServer - verdadeiro se a monitoração é a do servidor default ou falso, caso contrário.

canReach

public boolean canReach(ServerURI uri,
                        int port)
                 throws RemoteException

Verifica se um determinado servidor consegue acessar o host a partir do qual este método foi chamado, em uma determinada porta.

Parameters:

uri - A URI que india o servidor.

port - Porta a ser testada.

Returns:

True se o servidor consegue acessar o host a partir do qual este método foi chamado, em uma dada porta.

Throws:

RemoteException - Em caso de falha na comunicação com o servidor.

notifyServerReachable

public final void notifyServerReachable(ServerURI serverURI)

Chamado quando o ServerMonitor reestabelece a conexão com o servidor

Specified by:

notifyServerReachable in interface ServerMonitorListener

Parameters:

serverURI - A URI do servidor reestabelecido

notifyServerUnreachable

public final void notifyServerUnreachable(ServerURI serverURI)

Chamado quando ServerMonitor detecta que o servidor não está alcançável

Specified by:

notifyServerUnreachable in interface ServerMonitorListener

Parameters:

serverURI - A URI do servidor que caiu

addListener

protected final void addListener(MonitoredServerListener listener)

Adiciona um ouvinte.

Parameters:

listener - A instância de um ouvinte

deleteListener

protected final void deleteListener(MonitoredServerListener listener)

Remove um ouvinte

Parameters:

listener - A Instância de um ouvinte

addObserver

public final boolean addObserver(String serviceName,
                                 RemoteObserver observer,
                                 Object arg)

Adiciona o observador ao serviço observado.Caso não haja comunicação estabelecida com o servidor, o observador é guardado para envio posterior.

Parameters:

serviceName - Nome do serviço em que o observador é adicionado.

observer - Observador remoto.

arg - Argumento associado ao observador.

Returns:

true, caso tenha conseguido adicionar o observador, ou false, caso contrário.

deleteObserver

public final void deleteObserver(String serviceName,
                                 RemoteObserver observer,
                                 Object arg)

Remove o par (observador, arg) do serviço dado.

Parameters:

serviceName - Nome do serviço do qual o observador será retirado.

observer - Observador remoto.

arg - Argumento associado ao observador.

sendObservers

protected final void sendObservers()

Envia os observadores nos serviços correspondentes.

invalidate

public void invalidate()

Força revalidar a conexão com o servidor e a sessão.
Se o servidor estiver fora, tenta reconectar.
Se tiver acesso ao servidor mas a sessão caiu, desloga e loga novamente.

validate

protected boolean validate()
                    throws CSBaseException,
                           RemoteException

Valida o servidor. Faz o login com o servidor, recupera os serviços exportados, envia os observadores, atribui o nome do sistema e em caso de sucesso muda o estado do servidor para vivo.

Returns:

true se validado com sucesso, false caso contrário

Throws:

CSBaseException - Em caso de erro durante a validação

RemoteException - Em caso de falha na comunicação com o servidor

setSystemName

protected void setSystemName(String systemName)

Define o nome do sistema a ser usado

Parameters:

systemName - nome do sistema.

performLogin

protected abstract Session performLogin()
                                 throws CSBaseException,
                                        RemoteException

Faz o login com o servidor.

Returns:

A sessão do usuário logado ou null em caso de login/senha inválido.

Throws:

CSBaseException - Em caso de erro durante o login

RemoteException - Em caso de erro na comunicação com o servidor

postLogin

protected abstract void postLogin()
                           throws CSBaseException

Executado após login com sucesso.

Throws:

CSBaseException - em caso de erro durante o login.

lng

protected abstract String lng(String key)

Método usado para tradução de termos internacionalizados.

Parameters:

key - A chave do do termo

Returns:

O valor traduzido

flush

protected final void flush()

Executa procedimentos de finalização. Pára o monitor, remove os observadores, executa o logout e remove os ponteiros para os listeners e serviços.

logout

protected final void logout()

Pára a monitoração, remove observadores e executa o logout no servidor.

login

protected final boolean login()
                       throws CSBaseException,
                              RemoteException

Executa o login no servidor. Se a monitoração não estiver sendo executa será iniciada. Lança IncompatibleVersionException caso o servidor não seja compatível com o cliente.

Returns:

true se login bem sucedido, false caso contrário

Throws:

CSBaseException - Em caso de falha durante o processo de login

RemoteException - Em caso de falha na comunicação com o servidor

fetchServices

protected boolean fetchServices()
                         throws CSBaseException,
                                RemoteException

Recupera as referências para os serviços exportados pelo servidor

Returns:

true em caso de sucesso na recuperação dos serviços exportados, false caso contrário.

Throws:

CSBaseException - Em caso de falha na recuperação do serviços exportados

RemoteException - Em caso de falha na comunicação com o servidor

removeObservers

protected final void removeObservers()

Remove todos os observadores que este cliente cadastrou.

isAlive

protected final boolean isAlive()

Consulta o estado do servidor. O servidor é considerado vivo se está alcançável e o login foi bem sucedido.

Returns:

true para servidor vivo, false caso contrário.

isDefault

protected final boolean isDefault()

Returns:

true se este servidor monitorado é o default, false caso contrário

getMonitor

protected final ServerMonitor getMonitor()

Returns:

Retorna a instância do monitor (ServerMonitor).

getSession

protected final Session getSession()

Returns:

A instância da sessão

getURI

protected final ServerURI getURI()

Returns:

Retorna a URI do servidor.

fillLocatorFields

protected final void fillLocatorFields()

Preenche os campos do locator com as referências para os serviços.

getServicesNames

protected Set<String> getServicesNames()

Returns:

O conjunto de strings com os nomes dos serviços a serem recuperados do servidor. Usa o {#link ClientRemoteLocator} para descoberta dos serviços ou através do atributo serviceNames

setDelegatedLogin

public void setDelegatedLogin(String delegatedLogin)

Define o usuário a ser delegado no login

Parameters:

delegatedLogin - login do usuário a ser delegado

setTimeZone

public void setTimeZone(TimeZone timeZone)

Define o time zone usado no login do cliente

Parameters:

timeZone - A instância de TimeZone a ser usado, null usa TimeZone default