csbase.sga.executor

Class DefaultJobExecutor

java.lang.Object

csbase.sga.executor.DefaultJobExecutor

All Implemented Interfaces:

JobExecutor

public class DefaultJobExecutor
extends Object
implements JobExecutor

Executor padrão do SGA. Neste executor os jobs são executados via shell (ksh) na mesma máquina onde está o servidor CSBase.

Author:

Tecgraf/PUC-Rio

Constructor Summary

Constructors

Constructor and Description
DefaultJobExecutor(Properties pluginProperties) Construtor.

Method Summary

Methods

Modifier and Type	Method and Description
void	controlJob(JobData data, String child, sgaidl.JobControlAction action) Exerce uma ação sobre um job ou sobre um processo filho do job.
JobData	executeJob(String jobCommand, Map<String,String> extraParams, JobObserver observer) Executa um job no ambiente de execução.
JobInfo	getJobInfo(JobData data) Obtém as informações sobre a execução do job no ambiente de execução.
void	notifyJobFinished(String jobId) Notifica o término de um job para o observador deste job.
boolean	recoveryJob(JobData data, JobObserver observer) Recupera um job no ambiente de execução.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultJobExecutor

public DefaultJobExecutor(Properties pluginProperties)
                   throws csbase.server.plugin.service.sgaservice.SGADaemonException

Construtor.

Parameters:

pluginProperties -

Throws:

csbase.server.plugin.service.sgaservice.SGADaemonException

Method Detail

executeJob

public JobData executeJob(String jobCommand,
                 Map<String,String> extraParams,
                 JobObserver observer)

Executa um job no ambiente de execução. Um job representa um comando de execução, que é um programa ou script junto com os seus argumento, no ambiente de execução. Assim que o sistema de execução tiver o JobData do job, deve retorná-lo. Este método não deve bloquear até a finalização do job. Para notificar o término e possíveis erros durante a execução, deve ser utilizado o observador.

Specified by:

executeJob in interface JobExecutor

Parameters:

jobCommand - comando do job que deve ser executado.

extraParams - parametros extras usados pelo ambiente de execução para executar o job

observer - observador do job

Returns:

os dados do job

controlJob

public void controlJob(JobData data,
              String child,
              sgaidl.JobControlAction action)
                throws sgaidl.ActionNotSupportedException

Exerce uma ação sobre um job ou sobre um processo filho do job. Apenas a ação TERMINATE é suportada.

Specified by:

controlJob in interface JobExecutor

Parameters:

data - os dados do job

child - o processo filho do job

action - a ação a ser exercida

Throws:

sgaidl.ActionNotSupportedException - se a áção não é suportada pelo ambiente de execução

getJobInfo

public JobInfo getJobInfo(JobData data)

Obtém as informações sobre a execução do job no ambiente de execução.

Specified by:

getJobInfo in interface JobExecutor

Parameters:

data - os dados do job

Returns:

as informações sobre o job

recoveryJob

public boolean recoveryJob(JobData data,
                  JobObserver observer)

Recupera um job no ambiente de execução. Quando o servidor é reiniciado é necessário recuperar os jobs que estavam em execução antes da parada no ambiente de execução para dar continuidade na monitoração. Um JobData deve conter todas as informações necessárias para a recuperação do job correspondente.

Specified by:

recoveryJob in interface JobExecutor

Parameters:

data - dados do job

observer - observador do job

Returns:

true se o job foi recuperado e o observador cadastrado e false se não foi possível recuperar o job no ambiente de execução

notifyJobFinished

public void notifyJobFinished(String jobId)

Notifica o término de um job para o observador deste job.

Parameters:

jobId - o identificador do job