csbase.server

Class ServiceManager

java.lang.Object

csbase.server.ServiceManager

public class ServiceManager
extends Object

Classe que implementa o gerente de serviços do SSI, que será representado por um singleton.

Author:

Tecgraf/PUC-Rio

See Also:

Service

Method Summary

Modifier and Type	Method and Description
void	addService(Service service) Método para adicionar (cadastrar) um novo serviço ao SSI.
static ServiceManager	getInstance() Método que retorna a instância do gerente de serviços (singleton).
csbase.remote.ServiceInterface	getRemoteService(Object sessionKey, String serviceName) Cria o proxy de um determinado serviço para uma sessão de um usuário logado.
Map<String,csbase.remote.ServiceInterface>	getRemoteServices(Object sessionKey, Set<String> servicesNames) Cria os proxies de todos os serviços disponíveis para uma sessão de um usuário logado.
Service	getService(String serviceName) Obtém a instância do serviço.
Map<String,Service>	getServices() Método para obtenção de todos os serviços.
protected static void	init() Método para carregar o gerente de serviços; deve ser o primeiro método a ser chamado pois cria o único objeto da classe.
protected void	initAllServices() Método para inicializar os serviços cadastrados no gerente de serviços.
void	install() Passa a observar eventos de LoginService.
void	shutdownAllServices() Método para terminar todos os serviços cadastrados no gerente de serviços.
void	uninstall() Deixa de observar eventos de LoginService.

Methods inherited from class java.lang.Object

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

Method Detail

init

protected static void init()

Método para carregar o gerente de serviços; deve ser o primeiro método a ser chamado pois cria o único objeto da classe.

initAllServices

protected void initAllServices()
                        throws ServerException

Método para inicializar os serviços cadastrados no gerente de serviços.

Throws:

ServerException - caso ocorra falha na inicialização do serviço

shutdownAllServices

public void shutdownAllServices()
                         throws ServerException

Método para terminar todos os serviços cadastrados no gerente de serviços.

Throws:

ServerException - caso ocorra alguma falha no término de serviços

getInstance

public static ServiceManager getInstance()

Método que retorna a instância do gerente de serviços (singleton).

Returns:

a instância de ServiceManager.

install

public void install()
             throws RemoteException

Passa a observar eventos de LoginService.

Throws:

RemoteException - caso ocorra algum erro de rmi no cadastro do observador

uninstall

public void uninstall()
               throws RemoteException

Deixa de observar eventos de LoginService.

Throws:

RemoteException - casos ocorra alguma falha de rmi na remoção do observador

addService

public void addService(Service service)

Método para adicionar (cadastrar) um novo serviço ao SSI.

Parameters:

service - novo serviço para o cadatro.

Throws:

IllegalArgumentException - caso o service seja null

getRemoteServices

public Map<String,csbase.remote.ServiceInterface> getRemoteServices(Object sessionKey,
                                                                    Set<String> servicesNames)

Cria os proxies de todos os serviços disponíveis para uma sessão de um usuário logado. O mapa de proxies tem como chave os nomes dos serviços conforme as constantes XxxxServiceInterface.SERVICE_NAME.

Parameters:

sessionKey - Chave da sessão de um usuário.

servicesNames - Nomes dos serviços que serão recuperados.

Returns:

Mapa com os proxies dos serviços disponíveis. Se nenhum serviço estiver disponível é retornado um mapa com tamanho 0. Se a sessão for inválida é retornado null.

Throws:

IllegalArgumentException - caso o sessionKey ou o servicesNames seja null

getRemoteService

public csbase.remote.ServiceInterface getRemoteService(Object sessionKey,
                                                       String serviceName)

Cria o proxy de um determinado serviço para uma sessão de um usuário logado. Se já existe um proxy do serviço especificado para essa chave, então essa referência é retornada.

Parameters:

sessionKey - Chave da sessão de um usuário.

serviceName - Nome do Serviço. Conforme constante XxxxServiceInterface.SERVICE_NAME.

Returns:

Proxy para o serviço especificado. null caso o serviço solicitado não esteja disponível.

Throws:

IllegalArgumentException - caso o sessionKey ou o serviceName seja null

getService

public Service getService(String serviceName)

Obtém a instância do serviço.

Parameters:

serviceName - o nome do serviço desejado.

Returns:

a instância.

getServices

public Map<String,Service> getServices()

Método para obtenção de todos os serviços.

Returns:

Hashtable com as referências para todos os serviços.