csbase.server.services.sgaservice

Class Command

java.lang.Object

csbase.server.services.sgaservice.Command

All Implemented Interfaces:

Serializable

public class Command
extends Object
implements Serializable

A classe Command representa um comando que está sendo executado no gerenciador de uma máquina hospedeira (ou servidor SGA).

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
Command(String hostName, csbase.server.services.sgaservice.SGA sga, csbase.logic.CommandInfo cmdInfo, long expirationInfoDelay, boolean asScript, boolean logCommandLineInfo) Constrói a representação de um comando.

Method Summary

Methods

Modifier and Type	Method and Description
csbase.logic.CommandInfo	createCommandInfo() Cria as informações da monitoração do comando.
protected void	executeRemoteCommand() Executa o comando remoto.
boolean	existsProject() Informa se o projeto ainda existe.
void	failed(csbase.logic.FailureFinalizationType cause) Sinaliza uma falha no comando.
boolean	finish(sgaidl.CompletedCommandInfo cmdInfo) Término do comando.
String	getCommand() Obtém a String do comando.
protected csbase.logic.CommandInfo	getCommandInfo() Obtém informações do comando.
String[]	getEmailList() Obtém a lista de endereços que devem receber email de aviso de término de execução do comando, além do próprio dono do projeto.
csbase.logic.CommandFinalizationInfo	getFinalizationInfo() Obtém as informações sobre a finalização do comando.
String	getId() Obtém o identificador do comando.
csbase.logic.SGAInfo	getNode() Obtém o node que irá executar o comando.
long	getNUpdates() Informa quantas vezes o comando foi atualizado Usado para fazer freqüencia de update incremental.
Object	getProjectId() Obtém o identificador do projeto no qual o comando é executado.
String	getProjectName() Obtém o nome do projeto no qual o comando foi executado.
csbase.logic.CommandStatus	getStatus() Obtém o estado de execução do comando.
String	getTip() Obtém a dica para auxiliar a identificação do algoritmo do comando
Object	getUserId() Obtém o usuário que executou o comando.
boolean	kill() Interrompe o comando.
void	lost() comando perdido.
void	setRemoteReference(sgaidl.SGACommand remoteReference) Atualiza a referência remota para o comando no SGA.
void	update() Atualiza o estado corrente do Comando.

Methods inherited from class java.lang.Object

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

Constructor Detail

Command

public Command(String hostName,
       csbase.server.services.sgaservice.SGA sga,
       csbase.logic.CommandInfo cmdInfo,
       long expirationInfoDelay,
       boolean asScript,
       boolean logCommandLineInfo)
        throws ProjectNotFoundException

Constrói a representação de um comando.

Parameters:

hostName - Nome do nó do SGA que deve executar o comando

sga - representação local do SGA da máquina hospedeira

cmdInfo - informações sobre o comando a ser executado.

expirationInfoDelay - prazo de validade das informações do comando.

asScript - Indica se o comando deve ser executado como um script.

logCommandLineInfo - Indica se informações da linha de comando devem ser logadas.

Throws:

ProjectNotFoundException - Em caso de falha na criação do comando.

Method Detail

getProjectId

public Object getProjectId()

Obtém o identificador do projeto no qual o comando é executado.

Returns:

O identificador do projeto.

update

public void update()
            throws ServerException

Atualiza o estado corrente do Comando.

Throws:

ServerException - se houver alguma exceção for detectada!

getNUpdates

public long getNUpdates()

Informa quantas vezes o comando foi atualizado Usado para fazer freqüencia de update incremental.

Returns:

o número de vezes que o comando foi atualizado.

finish

public boolean finish(sgaidl.CompletedCommandInfo cmdInfo)

Término do comando.

Parameters:

cmdInfo - dados sobre o comando completado.

Returns:

true se a finalização for bem sucedida.

existsProject

public boolean existsProject()

Informa se o projeto ainda existe.

Returns:

Verdadeiro se o projeto ainda existe, falso caso contrário.

kill

public boolean kill()

Interrompe o comando. Se houver alguma falha de comunicação, deixa o objeto inalterado.

Returns:

true se o comando foi cancelado ou false caso ocorra alguma falha ao enviar o sinal de interrupção para a referência remota do comando no SGA.

failed

public void failed(csbase.logic.FailureFinalizationType cause)

Sinaliza uma falha no comando.

Parameters:

cause - a causa da falha

lost

public void lost()

comando perdido.

getEmailList

public String[] getEmailList()

Obtém a lista de endereços que devem receber email de aviso de término de execução do comando, além do próprio dono do projeto.

Returns:

o array com endereços de email

getTip

public String getTip()

Obtém a dica para auxiliar a identificação do algoritmo do comando

Returns:

.

getUserId

public Object getUserId()

Obtém o usuário que executou o comando.

Returns:

este identificador

getId

public String getId()

Obtém o identificador do comando.

Returns:

este identificador

getCommandInfo

protected csbase.logic.CommandInfo getCommandInfo()

Obtém informações do comando.

Returns:

as informações do comando

getCommand

public String getCommand()

Obtém a String do comando.

Returns:

o comando

getStatus

public csbase.logic.CommandStatus getStatus()

Obtém o estado de execução do comando.

Returns:

.

getFinalizationInfo

public csbase.logic.CommandFinalizationInfo getFinalizationInfo()

Obtém as informações sobre a finalização do comando.

Returns:

as informações sobre a finalização do comando.

setRemoteReference

public void setRemoteReference(sgaidl.SGACommand remoteReference)

Atualiza a referência remota para o comando no SGA. Necessário quando o SGA saiu do ar e está voltando.

Parameters:

remoteReference - a referência remota

executeRemoteCommand

protected void executeRemoteCommand()

Executa o comando remoto. Esse metodo deve ser chamado apos a copia dos binarios e dos dados para a maquina de execucao. Ou no caso onde esses arquivos estao acessiveis via NFS.

getNode

public csbase.logic.SGAInfo getNode()

Obtém o node que irá executar o comando.

Returns:

.

getProjectName

public String getProjectName()

Obtém o nome do projeto no qual o comando foi executado.

Returns:

o nome do projeto no qual o comando foi executado.

createCommandInfo

public csbase.logic.CommandInfo createCommandInfo()

Cria as informações da monitoração do comando.

ATENÇÃO: A sincronização deste método garante que as informações são da mesma instância de RunningCommandInfo.

Returns:

comando com as últimas informações obtidas