csbase.server.plugin.service.sgaservice

Interface ISGAService

public interface ISGAService

Interface pública do serviço de gerências dos SGAs.

Author:

Tecgraf/PUC-Rio

Method Summary

Methods

Modifier and Type	Method and Description
boolean	commandCompleted(java.lang.String sgaName, sgaidl.SGACommandOperations command, java.lang.String commandId, sgaidl.CompletedCommandInfo info) Notificação de término de um comando.
boolean	commandLost(java.lang.String sgaName, java.lang.String commandId) Notificação de comando não recuperado.
boolean	commandRetrieved(java.lang.String sgaName, sgaidl.RetrievedInfo[] infos) Registra comandos recuperados em um SGA.
boolean	isRegistered(sgaidl.SGADaemonOperations sgaReference, java.lang.String sgaName) SGA verifica se o SSI está acessível e se seu registro está válido.
java.lang.String[]	mandatorySGANodeProperties() Lista de propriedades obrigatórias dos nós do SGA.
java.lang.String[]	mandatorySGAProperties() Lista de propriedades obrigatórias do SGA.
boolean	registerSGA(sgaidl.SGADaemonOperations sgaReference, java.lang.String sgaName, sgaidl.SGAProperties sgaProperties, org.omg.CORBA.IntHolder updateInterval) Registro de um SGA.
void	unregisterSGA(sgaidl.SGADaemonOperations sgaReference, java.lang.String sgaName) Solicitação de de-registro de um SGA.
boolean	updateSGAInfo(sgaidl.SGADaemonOperations sgaReference, java.lang.String sgaName, sgaidl.SGAProperties sgaProperties) SGA atualiza seus dados dinâmicos.

Method Detail

registerSGA

boolean registerSGA(sgaidl.SGADaemonOperations sgaReference,
                  java.lang.String sgaName,
                  sgaidl.SGAProperties sgaProperties,
                  org.omg.CORBA.IntHolder updateInterval)
                    throws sgaidl.InvalidParameterException,
                           sgaidl.NoPermissionException,
                           sgaidl.SGAAlreadyRegisteredException

Registro de um SGA.

Parameters:

sgaReference - referência para o sga

sgaName - nome do SGA

sgaProperties - propriedades do SGA

updateInterval - informa de quanto em quanto tempo o SGA deve dizer que está vivo.

Returns:

true se o o registro do SGA for aceito, false caso o registro não possa ser aceito

Throws:

sgaidl.InvalidParameterException

sgaidl.NoPermissionException

sgaidl.SGAAlreadyRegisteredException

unregisterSGA

void unregisterSGA(sgaidl.SGADaemonOperations sgaReference,
                 java.lang.String sgaName)
                   throws sgaidl.NoPermissionException,
                          sgaidl.SGANotRegisteredException

Solicitação de de-registro de um SGA.

Parameters:

sgaReference - referência para o sga

sgaName - nome do SGA

Throws:

sgaidl.NoPermissionException

sgaidl.SGANotRegisteredException

isRegistered

boolean isRegistered(sgaidl.SGADaemonOperations sgaReference,
                   java.lang.String sgaName)
                     throws sgaidl.InvalidSGAException,
                            sgaidl.NoPermissionException

SGA verifica se o SSI está acessível e se seu registro está válido.

Parameters:

sgaReference - referência para o SGA

sgaName - nome da máquina hospedeira do SGA

Returns:

true se o o registro do SGA estiver válido, false caso contrário. Um retorno "false" é uma indicação de que o SSI esteve fora do ar, o que exige um novo registro do SGA junto ao mesmo.

Throws:

sgaidl.InvalidSGAException

sgaidl.NoPermissionException

updateSGAInfo

boolean updateSGAInfo(sgaidl.SGADaemonOperations sgaReference,
                    java.lang.String sgaName,
                    sgaidl.SGAProperties sgaProperties)
                      throws sgaidl.InvalidParameterException,
                             sgaidl.NoPermissionException,
                             sgaidl.SGANotRegisteredException

SGA atualiza seus dados dinâmicos.

Parameters:

sgaReference - referência para o SGA

sgaName - nome da máquina hospedeira do SGA

sgaProperties - informações dinâmicas do SGA

Returns:

true se conseguiu atualizar seus dados ou false caso contrário.

Throws:

sgaidl.InvalidParameterException

sgaidl.NoPermissionException

sgaidl.SGANotRegisteredException

mandatorySGAProperties

java.lang.String[] mandatorySGAProperties()

Lista de propriedades obrigatórias do SGA.

Returns:

o array com o nome das propriedades obrigatórias de qualquer SGA.

mandatorySGANodeProperties

java.lang.String[] mandatorySGANodeProperties()

Lista de propriedades obrigatórias dos nós do SGA.

Returns:

o array com o nome das propriedades obrigatórias de qualquer nós de SGA.

commandCompleted

boolean commandCompleted(java.lang.String sgaName,
                       sgaidl.SGACommandOperations command,
                       java.lang.String commandId,
                       sgaidl.CompletedCommandInfo info)
                         throws sgaidl.InvalidSGAException,
                                sgaidl.NoPermissionException,
                                sgaidl.InvalidCommandException

Notificação de término de um comando.

Parameters:

sgaName - nome do SGA.

command - referência para o comando concluído.

commandId - identificador do comando no SGA.

info - informações sobre o comando.

Returns:

true se notificação aceita, false se o SSI desconhece o SGA

Throws:

sgaidl.InvalidSGAException

sgaidl.NoPermissionException

sgaidl.InvalidCommandException

commandLost

boolean commandLost(java.lang.String sgaName,
                  java.lang.String commandId)
                    throws sgaidl.InvalidSGAException,
                           sgaidl.NoPermissionException,
                           sgaidl.InvalidCommandException

Notificação de comando não recuperado.

Parameters:

sgaName - nome do SGA.

commandId - identificador do comando no SGA.

Returns:

true se notificação aceita, false se o SSI desconhece o SGA

Throws:

sgaidl.InvalidSGAException

sgaidl.NoPermissionException

sgaidl.InvalidCommandException

commandRetrieved

boolean commandRetrieved(java.lang.String sgaName,
                       sgaidl.RetrievedInfo[] infos)
                         throws sgaidl.InvalidSGAException,
                                sgaidl.NoPermissionException,
                                sgaidl.InvalidCommandException

Registra comandos recuperados em um SGA. Os demais comandos em execução no SGA (não-recuperados) são marcados como perdidos.

Parameters:

sgaName - nome que identifica o sga.

infos - informações sobre os comandos recuperados

Returns:

true se existe um SGA com o nome especificado, false caso contrário

Throws:

sgaidl.InvalidSGAException

sgaidl.NoPermissionException

sgaidl.InvalidCommandException