Quartz.net官方开发指南 第七课 : TriggerListeners和JobListeners

/// <summary>
 /// The interface to be implemented by classes that want to be informed when a
 /// <see cref="Trigger" /> fires. In general, applications that use a
 /// <see cref="IScheduler" /> will not have use for this mechanism.
 /// </summary>
 /// <seealso cref="IScheduler" />
 /// <seealso cref="Trigger" />
 /// <seealso cref="IJobListener" />
 /// <seealso cref="JobExecutionContext" />
 /// <author>James House</author>
 public interface ITriggerListener
 {
 /// <summary>
 /// Get the name of the <see cref="ITriggerListener" />.
 /// </summary>
 string Name { get; }
 /// <summary>
 /// Called by the <see cref="IScheduler" /> when a <see cref="Trigger" />
 /// has fired, and it's associated <see cref="JobDetail" />
 /// is about to be executed.
 /// <p>
 /// It is called before the <see cref="VetoJobExecution" /> method of this
 /// interface.
 /// </p>
 /// </summary>
 /// <param name="trigger">The <see cref="Trigger" /> that has fired.</param>
 /// <param name="context">
 /// The <see cref="JobExecutionContext" /> that will be passed to the <see cref="IJob" />'s<see cref="IJob.Execute" /> method.
 /// </param>
 void TriggerFired(Trigger trigger, JobExecutionContext context);
 /// <summary>
 /// Called by the <see cref="IScheduler" /> when a <see cref="Trigger" />
 /// has fired, and it's associated <see cref="JobDetail" />
 /// is about to be executed.
 /// <p>
 /// It is called after the <see cref="TriggerFired" /> method of this
 /// interface.
 /// </p>
 /// </summary>
 /// <param name="trigger">The <see cref="Trigger" /> that has fired.</param>
 /// <param name="context">
 /// The <see cref="JobExecutionContext" /> that will be passed to
 /// the <see cref="IJob" />'s<see cref="IJob.Execute" /> method.
 /// </param>
 bool VetoJobExecution(Trigger trigger, JobExecutionContext context);
 /// <summary>
 /// Called by the <see cref="IScheduler" /> when a <see cref="Trigger" />
 /// has misfired.
 /// <p>
 /// Consideration should be given to how much time is spent in this method,
 /// as it will affect all triggers that are misfiring. If you have lots
 /// of triggers misfiring at once, it could be an issue it this method
 /// does a lot.
 /// </p>
 /// </summary>
 /// <param name="trigger">The <see cref="Trigger" /> that has misfired.</param>
 void TriggerMisfired(Trigger trigger);
 /// <summary>
 /// Called by the <see cref="IScheduler" /> when a <see cref="Trigger" />
 /// has fired, it's associated <see cref="JobDetail" />
 /// has been executed, and it's <see cref="Trigger.Triggered" /> method has been
 /// called.
 /// </summary>
 /// <param name="trigger">The <see cref="Trigger" /> that was fired.</param>
 /// <param name="context">
 /// The <see cref="JobExecutionContext" /> that was passed to the
 /// <see cref="IJob" />'s<see cref="IJob.Execute" /> method.
 /// </param>
 /// <param name="triggerInstructionCode">
 /// The result of the call on the <see cref="Trigger" />'s<see cref="Trigger.Triggered" /> method.
 /// </param>
 void TriggerComplete(Trigger trigger, JobExecutionContext context, SchedulerInstruction triggerInstructionCode);
}

/// <summary>
 /// The interface to be implemented by classes that want to be informed when a
 /// <see cref="JobDetail" /> executes. In general, applications that use a 
 /// <see cref="IScheduler" /> will not have use for this mechanism.
 /// </summary>
 /// <seealso cref="IScheduler" />
 /// <seealso cref="IJob" />
 /// <seealso cref="JobExecutionContext" />
 /// <seealso cref="JobExecutionException" />
 /// <seealso cref="ITriggerListener" />
 /// <author>James House</author>
 public interface IJobListener
 {
 /// <summary>
 /// Get the name of the <see cref="IJobListener" />.
 /// </summary>
 string Name { get; }
 /// <summary>
 /// Called by the <see cref="IScheduler" /> when a <see cref="JobDetail" />
 /// is about to be executed (an associated <see cref="Trigger" />
 /// has occured).
 /// <p>
 /// This method will not be invoked if the execution of the Job was vetoed
 /// by a <see cref="ITriggerListener" />.
 /// </p>
 /// </summary>
 /// <seealso cref="JobExecutionVetoed(JobExecutionContext)" />
 void JobToBeExecuted(JobExecutionContext context);
 /// <summary>
 /// Called by the <see cref="IScheduler" /> when a <see cref="JobDetail" />
 /// was about to be executed (an associated <see cref="Trigger" />
  /// has occured), but a <see cref="ITriggerListener" /> vetoed it's 
 /// execution.
 /// </summary>
 /// <seealso cref="JobToBeExecuted(JobExecutionContext)" />
 void JobExecutionVetoed(JobExecutionContext context);
 /// <summary>
 /// Called by the <see cref="IScheduler" /> after a <see cref="JobDetail" />
 /// has been executed, and be for the associated <see cref="Trigger" />'s
 /// <see cref="Trigger.Triggered" /> method has been called.
 /// </summary>
 void JobWasExecuted(JobExecutionContext context, JobExecutionException jobException);
 }