JobChainingJobListener Class

Quartz.NET 3.0 API Documentation
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".
Inheritance Hierarchy

SystemObject
  Quartz.ListenerJobListenerSupport
    Quartz.ListenerJobChainingJobListener

Namespace:  Quartz.Listener
Assembly:  Quartz (in Quartz.dll) Version: 3.0.0
Syntax

C#
public class JobChainingJobListener : JobListenerSupport

The JobChainingJobListener type exposes the following members.

Constructors

  NameDescription
Public methodJobChainingJobListener
Construct an instance with the given name.
Top
Properties

  NameDescription
Public propertyName (Overrides JobListenerSupportName.)
Top
Methods

  NameDescription
Public methodAddJobChainLink
Add a chain mapping - when the Job identified by the first key completes the job identified by the second key will be triggered.
Public methodEquals
Determines whether the specified object is equal to the current object.
(Inherited from Object.)
Protected methodFinalize
Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(Inherited from Object.)
Public methodGetHashCode
Serves as the default hash function.
(Inherited from Object.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Public methodJobExecutionVetoed
Called by the IScheduler when a IJobDetail was about to be executed (an associated ITrigger has occurred), but a ITriggerListener vetoed it's execution.
(Inherited from JobListenerSupport.)
Public methodJobToBeExecuted
Called by the IScheduler when a IJobDetail is about to be executed (an associated ITrigger has occurred).

This method will not be invoked if the execution of the Job was vetoed by a ITriggerListener.

(Inherited from JobListenerSupport.)
Public methodJobWasExecuted (Overrides JobListenerSupportJobWasExecuted(IJobExecutionContext, JobExecutionException, CancellationToken).)
Protected methodMemberwiseClone
Creates a shallow copy of the current Object.
(Inherited from Object.)
Public methodToString
Returns a string that represents the current object.
(Inherited from Object.)
Top
Remarks

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 message 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.

See Also

Reference