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 JobObserver.onJobCompleted(JobInfo) término} e a JobObserver.onJobLost() perda} do job.

Author:

Tecgraf/PUC-Rio

Method Summary

Modifier and Type	Method and Description
Map<String,String>	collectExecutionData(String execPath, String cmdId, String sandboxPath, String outputPath) Executes the script to collect command' execution data.
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	recoverJob(JobData data, JobObserver observer) Recupera um job no ambiente de execução.
void	searchAndNotifyFinishedJobs() Busca e notifica jobs finalizados.

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

recoverJob

void recoverJob(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

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

searchAndNotifyFinishedJobs

void searchAndNotifyFinishedJobs()

Busca e notifica jobs finalizados. A notificação deve ser feita pelo JobObserver do job. Jobs finalizados são aqueles que tem o estado ProcessState.FINISHED.

collectExecutionData

Map<String,String> collectExecutionData(String execPath,
                                        String cmdId,
                                        String sandboxPath,
                                        String outputPath)

Executes the script to collect command' execution data.

Parameters:

execPath - command exec path

cmdId - command id

sandboxPath - sandbox path

outputPath - output path (log, warning, exit_code)

Returns:

the execution data