csbase.sga.executor

Interface JobExecutor

All Known Implementing Classes:

DefaultJobExecutor

public interface JobExecutor

O Executor é o responsável por iniciar a execução de jobs em um ambiente específico e por monitorar o estado do job. Através de um observer o executor notifica o término e a perda do comando.

Author:

Tecgraf/PUC-Rio

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.
boolean	recoveryJob(JobData data, JobObserver observer) Recupera um job no ambiente de execução.

Method Detail

executeJob

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.

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

recoveryJob

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.

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

controlJob

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

Exerce uma ação sobre um job ou sobre um processo filho do job.

Parameters:

data - os dados do job

child - o processo filho do job

action - a ação a ser exercida

Throws:

sgaidl.InvalidActionException - se a ação é inválida

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

getJobInfo

JobInfo getJobInfo(JobData data)

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

Parameters:

data - os dados do job

Returns:

as informações sobre o job