csbase.logic

Class ServerManager

java.lang.Object

csbase.logic.ServerManager

Direct Known Subclasses:

SingleServerManager

public class ServerManager
extends Object

O ServerManager é responsável por manter, adicionar e remover um servidor CSBase da monitoração. Ao menos um servidor estará sendo monitorado já que o cliente está conectado no servidor inicial (default).

Author:

Tecgraf

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ServerManager() Constrói o gerente de servidores compartilhandos os dados dos servidores gerenciados entre todas as instâncias desta classe
protected	ServerManager(boolean sharedServerData) Constrói o gerente de servidores
protected	ServerManager(boolean sharedServerData, boolean verbose) Constrói o gerente de servidores

Method Summary

Methods

Modifier and Type	Method and Description
void	addCommonListener(MonitoredServerListener l) Adiciona ouvintes a todos os servidores gerenciados.
void	addListener(MonitoredServerListener l) Adiciona um ouvinte do tipo MonitoredServerListener ao servidor default
void	addListener(ServerURI serverURI, MonitoredServerListener l) Adiciona um ouvinte do tipo MonitoredServerListener para um servidor
boolean	addObserver(ServerURI serverURI, String serviceName, RemoteObserver observer, Object arg) Adiciona um observador.
boolean	addObserver(String serviceName, RemoteObserver observer, Object arg) Adiciona um observador ao servidor padrão.
void	addServer(MonitoredServer monitoredServer) Adiciona um novo servidor para ser gerenciado.
void	deleteCommonListener(MonitoredServerListener l) Remove o ouvinte de todos o servidores gerenciados.
void	deleteListener(MonitoredServerListener l) Remove um ouvinte do tipo MonitoredServerListener do servidor default
void	deleteListener(ServerURI serverURI, MonitoredServerListener l) Remove o ouvinte do tipo MonitoredServerListener de um servidor
void	deleteObserver(ServerURI serverURI, String serviceName, RemoteObserver observer, Object arg) Remove um observador.
void	deleteObserver(String serviceName, RemoteObserver observer, Object arg) Remove um observador do servidor padrão.
protected boolean	doLogin(ServerURI serverURI) Executa o login de um servidor monitorado pelo gerente.
ServerURI	getDefaultURI()
Set<ServerURI>	getManagedServers() Obtém o conjunto de URI's que identifica os servidores sendo gerenciados
ServerMonitor	getMonitor() Recupera o monitor do servidor default
ServerMonitor	getMonitor(ServerURI uri) Recupera o monitor de um servidor
ServerEntryPoint	getServer() Retorna a referência para o ponto de entrada do servidor default
ServerEntryPoint	getServer(ServerURI uri) Retorna a referência para o ponto de entrada de um servidor
Thread	getServerLookupThread()
Thread	getServerLookupThread(ServerURI serverURI) Retorna a thread de lookup do monitor de um servidor
String	getServerPath() Obtém o endereço para conexão com o servidor na forma host:port
<T> T	getService(Class<T> serviceClass) Retorna a referência para um serviço do servidor default.
<T> T	getService(Class<T> serviceClass, ServerURI serverURI) Retorna a referência para um serviço de um servidor.
Session	getSession() Recupera a sessão do usuário no servidor default
Session	getSession(ServerURI uri) Recupera a sessão do usuário em um servidor
void	invalidate() Força a verificação de estado do monitor do servidor default
void	invalidate(ServerURI serverURI) Força a verificação de estado do monitor de um servidor
boolean	isAlive() Consulta o estado do servidor.
boolean	isAlive(ServerURI serverURI) Indica se o servidor está vivo.
boolean	isDefault(ServerURI sURI) Testa se um determinado servidor é o default
boolean	isMonitored(ServerURI serverURI)
boolean	login(ServerURI serverURI) Executa o login no servidor.
void	logout(boolean flush) Executa logout do servidor default, pára a monitoração, remove observadores e ouvintes e por fim remove o servidor do gerenciamento e notifica os ouvintes do gerente do logout bem sucedido.
void	logout(ServerURI serverURI, boolean flush) Executa logout em um servidor, pára a monitoração, remove observadores e ouvintes e por fim notifica os ouvintes do gerente do logout bem sucedido.
boolean	performLookup() Executa o lookup do servidor default
boolean	performLookup(ServerURI uri) Executa o lookup de um servidor
protected void	removeObservers() Remove todos os observadores do servidor padrão
protected void	removeObservers(ServerURI serverURI) Remove todos os observadores cadastrados
void	setDefaultServer(ServerURI serverURI) Define o servidor default
protected void	setSystemName(ServerURI sURI, String systemName) Define o nome do sistema a ser usado no servidor
void	setVerbose(boolean verbose) Define se mensagens informativas devem ser exibidas.
void	shutdown() Finaliza a monitoração dos servidores.
protected boolean	validate() Executa o login e recupera a referência para os serviços do servidor default
protected boolean	validate(ServerURI uri) Executa o login e recupera a referência para os serviços de um servidor

Methods inherited from class java.lang.Object

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

Constructor Detail

ServerManager

protected ServerManager(boolean sharedServerData)

Constrói o gerente de servidores

Parameters:

sharedServerData - Se true os dados gerenciados são compartilhados entre as instâncias desta classe, false os dados são independentes

ServerManager

protected ServerManager(boolean sharedServerData,
             boolean verbose)

Constrói o gerente de servidores

Parameters:

sharedServerData - Se true os dados gerenciados são compartilhados entre as instâncias desta classe, false os dados são independentes

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

ServerManager

protected ServerManager()

Constrói o gerente de servidores compartilhandos os dados dos servidores gerenciados entre todas as instâncias desta classe

Method Detail

setVerbose

public void setVerbose(boolean verbose)

Define se mensagens informativas devem ser exibidas.

Parameters:

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

isAlive

public final boolean isAlive(ServerURI serverURI)

Indica se o servidor está vivo.

Parameters:

serverURI - A URI do servidor

Returns:

true se o servidor estiver vivo, false caso contrário

isAlive

public 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.

addCommonListener

public final void addCommonListener(MonitoredServerListener l)

Adiciona ouvintes a todos os servidores gerenciados.

Parameters:

l - A instância do ouvinte.

deleteCommonListener

public final void deleteCommonListener(MonitoredServerListener l)

Remove o ouvinte de todos o servidores gerenciados.

Parameters:

l - A instância do ouvinte

addListener

public final void addListener(ServerURI serverURI,
               MonitoredServerListener l)

Adiciona um ouvinte do tipo MonitoredServerListener para um servidor

Parameters:

serverURI - A URI que identifica o servidor sendo monitorado

l - A instância do ouvinte a ser adicionada

deleteListener

public final void deleteListener(ServerURI serverURI,
                  MonitoredServerListener l)

Remove o ouvinte do tipo MonitoredServerListener de um servidor

Parameters:

serverURI - A URI que identifica o servidor sendo monitorado

l - A instância do ouvinte a ser removida

addListener

public final void addListener(MonitoredServerListener l)

Adiciona um ouvinte do tipo MonitoredServerListener ao servidor default

Parameters:

l - A instância do ouvinte a ser adicionada

deleteListener

public final void deleteListener(MonitoredServerListener l)

Remove um ouvinte do tipo MonitoredServerListener do servidor default

Parameters:

l - A instância do ouvinte a ser removida

addServer

public void addServer(MonitoredServer monitoredServer)

Adiciona um novo servidor para ser gerenciado. Os ouvintes comuns são adicionados mas a monitoração não é iniciada neste momento. Se já houver uma monitoração a mesma será perdida e não será possível encerrá-la, sendo assim é importante que seja removida através de um logout antes da adição da nova.

Parameters:

monitoredServer - A Instância do MonitoredServer do servidor a ser gerenciado

isMonitored

public final boolean isMonitored(ServerURI serverURI)

Parameters:

serverURI - A URI que identifica o servidor

Returns:

true se o servidor estiver sendo monitorado, false caso contrário

getMonitor

public ServerMonitor getMonitor(ServerURI uri)

Recupera o monitor de um servidor

Parameters:

uri - A URI que identifica o servidor

Returns:

A instância de ServerMonitor

getMonitor

public ServerMonitor getMonitor()

Recupera o monitor do servidor default

Returns:

A instância de ServerMonitor

getServer

public ServerEntryPoint getServer(ServerURI uri)

Retorna a referência para o ponto de entrada de um servidor

Parameters:

uri - A URI que identifica o servidor

Returns:

A referência do servidor

getServer

public ServerEntryPoint getServer()

Retorna a referência para o ponto de entrada do servidor default

Returns:

A referência do servidor

getManagedServers

public Set<ServerURI> getManagedServers()

Obtém o conjunto de URI's que identifica os servidores sendo gerenciados

Returns:

Um conjunto de ServerURI

performLookup

public final boolean performLookup(ServerURI uri)

Executa o lookup de um servidor

Parameters:

uri - A URI que identifica o servidor

Returns:

true se servidor contactado com sucesso, false caso contrário

performLookup

public final boolean performLookup()

Executa o lookup do servidor default

Returns:

true se servidor contactado com sucesso, false caso contrário

validate

protected boolean validate(ServerURI uri)
                    throws CSBaseException,
                           RemoteException

Executa o login e recupera a referência para os serviços de um servidor

Parameters:

uri - A URI que identifica o servidor

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

validate

protected boolean validate()
                    throws CSBaseException,
                           RemoteException

Executa o login e recupera a referência para os serviços do servidor default

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

getSession

public Session getSession(ServerURI uri)

Recupera a sessão do usuário em um servidor

Parameters:

uri - A URI que identifica o servidor

Returns:

A instância da sessão

getSession

public Session getSession()

Recupera a sessão do usuário no servidor default

Returns:

A instância da sessão

invalidate

public void invalidate(ServerURI serverURI)

Força a verificação de estado do monitor de um servidor

Parameters:

serverURI - A URI do servidor

invalidate

public void invalidate()

Força a verificação de estado do monitor do servidor default

setDefaultServer

public final void setDefaultServer(ServerURI serverURI)

Define o servidor default

Parameters:

serverURI - A URI do servidor

getDefaultURI

public final ServerURI getDefaultURI()

Returns:

A URI do servidor default

getServerPath

public final String getServerPath()

Obtém o endereço para conexão com o servidor na forma host:port

Returns:

A string do endereço para conexão com o servidor na forma host:port

setSystemName

protected void setSystemName(ServerURI sURI,
                 String systemName)

Define o nome do sistema a ser usado no servidor

Parameters:

sURI - A URI do servidor

systemName - O nome do sistema

isDefault

public final boolean isDefault(ServerURI sURI)

Testa se um determinado servidor é o default

Parameters:

sURI - A URI do servidor

Returns:

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

getServerLookupThread

public Thread getServerLookupThread(ServerURI serverURI)

Retorna a thread de lookup do monitor de um servidor

Parameters:

serverURI - A URI do servidor

Returns:

A thread de lookup

getServerLookupThread

public Thread getServerLookupThread()

Returns:

A thread de lookup do monitor do servidor default

addObserver

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

Adiciona um observador.

Parameters:

serverURI - A URI do servidor

serviceName - O nome do serviço

observer - O observador

arg - Os argumentos associados ao observador

Returns:

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

addObserver

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

Adiciona um observador ao servidor padrão.

Parameters:

serviceName - O nome do serviço

observer - O observador

arg - Os argumentos associados ao observador

Returns:

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

deleteObserver

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

Remove um observador.

Parameters:

serverURI - A URI do servidor

serviceName - O nome do serviço

observer - O observador

arg - Os argumentos associados ao observador

deleteObserver

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

Remove um observador do servidor padrão.

Parameters:

serviceName - O nome do serviço

observer - O observador

arg - Os argumentos associados ao observador

removeObservers

protected final void removeObservers(ServerURI serverURI)

Remove todos os observadores cadastrados

Parameters:

serverURI - A URI do servidor

removeObservers

protected final void removeObservers()

Remove todos os observadores do servidor padrão

logout

public final void logout(ServerURI serverURI,
          boolean flush)

Executa logout em um servidor, pára a monitoração, remove observadores e ouvintes e por fim notifica os ouvintes do gerente do logout bem sucedido.

Parameters:

serverURI - A URI do servidor

flush - Se true remove o servidor do gerente

logout

public final void logout(boolean flush)

Executa logout do servidor default, pára a monitoração, remove observadores e ouvintes e por fim remove o servidor do gerenciamento e notifica os ouvintes do gerente do logout bem sucedido.

Parameters:

flush - Se true remove o servidor do gerente

shutdown

public void shutdown()

Finaliza a monitoração dos servidores.

login

public final boolean login(ServerURI serverURI)
                    throws CSBaseException,
                           RemoteException

Executa o login no servidor. O servidor precisa estar na monitoração. O tipo de login será executado de acordo com a monitoração para esse servidor.

Parameters:

serverURI - A URI do servidor

Returns:

true se login bem sucedido, false caso contrário

Throws:

CSBaseException - Em caso de erro durante o processo de login

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

doLogin

protected boolean doLogin(ServerURI serverURI)
                   throws CSBaseException,
                          RemoteException

Executa o login de um servidor monitorado pelo gerente.

Parameters:

serverURI - A URI do servidor

Returns:

true se login de sucesso ou false se login/senha inválido

Throws:

CSBaseException - Se houver falha durante o login.

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

getService

public final <T> T getService(Class<T> serviceClass,
               ServerURI serverURI)
                   throws RemoteException

Retorna a referência para um serviço de um servidor. Opcionalmente o servidor pode ser adicionado sob demanda.

Type Parameters:

T - O tipo do serviço a ser retornado

Parameters:

serviceClass - a classe do serviço

serverURI - A URI do servidor.

Returns:

A instância do serviço ou null se não for encontrado a instância do serviço

Throws:

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

getService

public final <T> T getService(Class<T> serviceClass)
                   throws RemoteException

Retorna a referência para um serviço do servidor default.

Type Parameters:

T - O tipo do serviço a ser retornado

Parameters:

serviceClass - A classe do serviço

Returns:

A instância do serviço ou null se não for encontrado a instância do serviço

Throws:

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