NativeJob (Quartz Parent POM 2.0.1 API)

org.quartz.jobs Class NativeJob

java.lang.Object
  org.quartz.jobs.NativeJob

All Implemented Interfaces:

Job

public class NativeJob

extends Object

implements Job

Built in job for executing native executables in a separate process.

             JobDetail job = new JobDetail("dumbJob", null, org.quartz.jobs.NativeJob.class);
             job.getJobDataMap().put(org.quartz.jobs.NativeJob.PROP_COMMAND, "echo \"hi\" >> foobar.txt");
             Trigger trigger = TriggerUtils.makeSecondlyTrigger(5);
             trigger.setName("dumbTrigger");
             sched.scheduleJob(job, trigger);
 

Author:

Matthew Payne, James House, Steinar Overbeck Cook

See Also:

PROP_COMMAND, PROP_PARAMETERS, PROP_WAIT_FOR_PROCESS, PROP_CONSUME_STREAMS

PROP_COMMAND

public static final String PROP_COMMAND

Required parameter that specifies the name of the command (executable) to be ran.

See Also:

Constant Field Values

PROP_PARAMETERS

public static final String PROP_PARAMETERS

Optional parameter that specifies the parameters to be passed to the executed command.

See Also:

Constant Field Values

PROP_WAIT_FOR_PROCESS

public static final String PROP_WAIT_FOR_PROCESS

Optional parameter (value should be 'true' or 'false') that specifies whether the job should wait for the execution of the native process to complete before it completes.

Defaults to true.

See Also:

Constant Field Values

PROP_CONSUME_STREAMS

public static final String PROP_CONSUME_STREAMS

Optional parameter (value should be 'true' or 'false') that specifies whether the spawned process's stdout and stderr streams should be consumed. If the process creates output, it is possible that it might 'hang' if the streams are not consumed.

Defaults to false.

See Also:

Constant Field Values

NativeJob

public NativeJob()

execute

public void execute(JobExecutionContext context)
             throws JobExecutionException

Description copied from interface: Job

Called by the Scheduler when a Trigger fires that is associated with the Job.

The implementation may wish to set a result object on the JobExecutionContext before this method exits. The result itself is meaningless to Quartz, but may be informative to JobListeners or TriggerListeners that are watching the job's execution.

Specified by:

execute in interface Job

Throws:

JobExecutionException - if there is an exception while executing the job.

protected org.slf4j.Logger getLog()