csbase.remote

Interface ServerServiceInterface

All Superinterfaces:

Remote, RemoteObservable, ServiceInterface

public interface ServerServiceInterface
extends ServiceInterface, RemoteObservable

Interface que define o comportamento do serviço de servidores.

Author:

Tecgraf/PUC-Rio

Field Summary

Fields

Modifier and Type	Field and Description
static String	SERVICE_NAME Nome do serviço

Method Summary

Modifier and Type	Method and Description
boolean	addCert(String serverName, Certificate c) Adiciona um certificado ao servidor
boolean	addServerInfo(ServerInfoData serverInfoData) Adiciona informações de um servidor ao repositório.
DeploymentInfo	getDeploymentInfo() Obtém informações a respeito do ambiente de instalação do servidor.
Map<String,Integer>	getLoginStats(boolean succeeded) Obtém estatísticas de logins.
int	getNumRegisteredUsers() Exibe o número de usuários cadastrados no sistema (inclui o admin).
Map<String,String>	getRuntimeProperties() Obtém as propriedades runtime do servidor sob a forma de um mapa <chave,valor>.
SortedSet<ServerInfo>	getServersInfos() Obtém um conjunto ordenado (por nome) com as informações de todos os servidores pertencentes ao repositório.
long	getStartupTime() Obtém o timestamp (em ms) referente à hora de inicialização do servidor.
String	listRuntimeProperties() Obtém todas as propriedades runtime do servidor na forma de uma string.
boolean	modifyServerInfo(ServerInfo serverInfo, ServerInfoData serverInfoData) Modifica as informações de um servidor no repositório.
void	removeCert(String serverName) Remove o certificado do servidor
void	removeServerInfo(ServerInfo serverInfo) Remove as informaçÕes de um servidor do repositório.

Methods inherited from interface csbase.remote.ServiceInterface

getName, isActive

Methods inherited from interface csbase.remote.RemoteObservable

addObserver, countObservers, deleteObserver, deleteObservers, notifyObservers

Field Detail

SERVICE_NAME

static final String SERVICE_NAME

Nome do serviço

See Also:

Constant Field Values

Method Detail

getServersInfos

SortedSet<ServerInfo> getServersInfos()
                               throws RemoteException

Obtém um conjunto ordenado (por nome) com as informações de todos os servidores pertencentes ao repositório.

Returns:

As informações dos servidores.

Throws:

RemoteException - Caso ocorra algum erro na comunicação com o serviço.

addServerInfo

boolean addServerInfo(ServerInfoData serverInfoData)
               throws RemoteException

Adiciona informações de um servidor ao repositório.

Parameters:

serverInfoData - Os dados mínimo necessários para adicionar ao repositório.

Returns:

true, caso o servidor tenha sido adicionado, ou false, caso já exista um outro servidor com o mesmo nome.

Throws:

RemoteException - Caso ocorra algum erro na comunicação com o serviço.

removeServerInfo

void removeServerInfo(ServerInfo serverInfo)
               throws RemoteException

Remove as informaçÕes de um servidor do repositório.

Parameters:

serverInfo - Informações do servidor a ser removido.

Throws:

RemoteException - Caso ocorra algum erro na comunicação com o serviço.

modifyServerInfo

boolean modifyServerInfo(ServerInfo serverInfo,
                         ServerInfoData serverInfoData)
                  throws RemoteException

Modifica as informações de um servidor no repositório.

Parameters:

serverInfo - Informações do servidor no seu estado antigo.

serverInfoData - Os dados a serem alterados.

Returns:

true, caso as informações do servidor tenham sido modificadas, ou false, caso já exista um outro servidor com o mesmo nome.

Throws:

RemoteException - Caso ocorra algum erro na comunicação com o serviço..

addCert

boolean addCert(String serverName,
                Certificate c)
         throws RemoteException

Adiciona um certificado ao servidor

Parameters:

serverName - O nome do servidor

c - A instância do certificado

Returns:

true se o certificado foi adicionado com sucesso, false caso contrário

Throws:

RemoteException - Caso ocorra algum erro na comunicação com o serviço.

removeCert

void removeCert(String serverName)
         throws RemoteException

Remove o certificado do servidor

Parameters:

serverName - O nome do servidor

Throws:

RemoteException - Caso ocorra algum erro na comunicação com o serviço.

listRuntimeProperties

String listRuntimeProperties()
                      throws RemoteException

Obtém todas as propriedades runtime do servidor na forma de uma string.

Returns:

propriedades runtime do servidor, na forma de uma string

Throws:

RemoteException - Caso ocorra algum erro na comunicação com o serviço.

See Also:

getRuntimeProperties()

getRuntimeProperties

Map<String,String> getRuntimeProperties()
                                 throws RemoteException

Obtém as propriedades runtime do servidor sob a forma de um mapa <chave,valor>.

Returns:

propriedades runtime do servidor, sob a forma de um mapa

Throws:

RemoteException - Caso ocorra algum erro na comunicação com o serviço.

See Also:

listRuntimeProperties()

getDeploymentInfo

DeploymentInfo getDeploymentInfo()
                          throws RemoteException

Obtém informações a respeito do ambiente de instalação do servidor.

Returns:

informações a respeito do ambiente de instalação do servidor

Throws:

RemoteException - Caso ocorra algum erro na comunicação com o serviço.

getNumRegisteredUsers

int getNumRegisteredUsers()
                   throws RemoteException

Exibe o número de usuários cadastrados no sistema (inclui o admin).

Returns:

número de usuários cadastrados no sistema

Throws:

RemoteException - Caso ocorra algum erro na comunicação com o serviço.

getStartupTime

long getStartupTime()
             throws RemoteException

Obtém o timestamp (em ms) referente à hora de inicialização do servidor.

Returns:

timestamp (em ms) referente à hora de inicialização do servidor

Throws:

RemoteException - Caso ocorra algum erro na comunicação com o serviço.

getLoginStats

Map<String,Integer> getLoginStats(boolean succeeded)
                           throws RemoteException

Obtém estatísticas de logins.

Parameters:

succeeded - true para receber as estatísticas de logins bem-sucedidos, false para receber as estatísticas de falhas de autenticação

Returns:

estatísticas de logins bem-sucedidos ou de falhas de autenticação

Throws:

RemoteException - Caso ocorra algum erro na comunicação com o serviço.