com.helger.quartz.listeners

Class JobChainingJobListener

java.lang.Object

com.helger.quartz.listeners.JobChainingJobListener

All Implemented Interfaces:

IJobListener

public class JobChainingJobListener
extends Object
implements IJobListener

Keeps a collection of mappings of which Job to trigger after the completion of a given job. If this listener is notified of a job completing that has a mapping, then it will then attempt to trigger the follow-up job. This achieves "job chaining", or a "poor man's workflow".

Generally an instance of this listener would be registered as a global job listener, rather than being registered directly to a given job.

If for some reason there is a failure creating the trigger for the follow-up job (which would generally only be caused by a rare serious failure in the system, or the non-existence of the follow-up job), an error messsage is logged, but no other action is taken. If you need more rigorous handling of the error, consider scheduling the triggering of the flow-up job within your job itself.

Author:

James House (jhouse AT revolition DOT net)

Constructor Summary

Constructors

Constructor and Description
JobChainingJobListener(String name) Construct an instance with the given name.

Method Summary

Modifier and Type	Method and Description
void	addJobChainLink(JobKey firstJob, JobKey secondJob) Add a chain mapping - when the Job identified by the first key completes the job identified by the second key will be triggered.
String	getName() Get the name of the JobListener.
void	jobWasExecuted(IJobExecutionContext context, JobExecutionException jobException) Called by the IScheduler after a IJobDetail has been executed, and be for the associated Trigger's triggered(xx) method has been called.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.helger.quartz.IJobListener

jobExecutionVetoed, jobToBeExecuted

Constructor Detail

JobChainingJobListener

public JobChainingJobListener(@Nonnull
                              String name)

Construct an instance with the given name.

Parameters:

name - the name of this instance

Method Detail

getName

@Nonnull
public String getName()

Description copied from interface: IJobListener

Get the name of the JobListener.

Specified by:

getName in interface IJobListener

addJobChainLink

public void addJobChainLink(JobKey firstJob,
                            JobKey secondJob)

Add a chain mapping - when the Job identified by the first key completes the job identified by the second key will be triggered.

Parameters:

firstJob - a JobKey with the name and group of the first job

secondJob - a JobKey with the name and group of the follow-up job

jobWasExecuted

public void jobWasExecuted(@Nonnull
                           IJobExecutionContext context,
                           JobExecutionException jobException)

Description copied from interface: IJobListener

Called by the IScheduler after a IJobDetail has been executed, and be for the associated Trigger's triggered(xx) method has been called.

Specified by:

jobWasExecuted in interface IJobListener