Package org.quartz.triggers

Interface Trigger

All Superinterfaces:

Cloneable, Comparable<Trigger>, Serializable

All Known Subinterfaces:

CronTrigger, MutableTrigger, OperableTrigger, SimpleTrigger

All Known Implementing Classes:

AbstractTrigger, CronTriggerImpl, SimpleTriggerImpl

public interface Trigger
extends Serializable, Cloneable, Comparable<Trigger>

The base interface with properties common to all Triggers - use TriggerBuilder to instantiate an actual Trigger.

Triggerss have a

invalid @link

TriggerKey

associated with them, which should uniquely identify them within a single Scheduler.

Triggers are the 'mechanism' by which Jobs are scheduled. Many Triggers can point to the same Job, but a single Trigger can only point to one Job.

Triggers can 'send' parameters/data to Jobs by placing contents into the JobDataMap on the Trigger.

Author:

James House

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static enum	Trigger.CompletedExecutionInstruction	NOOP Instructs the Scheduler that the Trigger has no further instructions.
static class	Trigger.TriggerTimeComparator	A Comparator that compares trigger's next fire times, or in other words, sorts them according to earliest next fire time.

Field Summary

Fields

Modifier and Type	Field	Description
static final int	DEFAULT_PRIORITY	The default value for priority.
static final int	MISFIRE_INSTRUCTION_IGNORE_MISFIRE_POLICY	Instructs the Scheduler that the Trigger will never be evaluated for a misfire situation, and that the scheduler will simply try to fire it as soon as it can, and then update the Trigger as if it had fired at the proper time.
static final int	MISFIRE_INSTRUCTION_SMART_POLICY	Instructs the Scheduler that upon a mis-fire situation, the updateAfterMisfire() method will be called on the Trigger to determine the mis-fire instruction, which logic will be trigger-implementation-dependent.

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object other)	Trigger equality is based upon the equality of the TriggerKey.
String	getCalendarName()	Get the name of the Calendar associated with this Trigger.
String	getDescription()	Return the description given to the Trigger instance by its creator (if any).
Date	getEndTime()	Get the time at which the Trigger should quit repeating - regardless of any remaining repeats (based on the trigger's particular repeat settings).
Date	getFinalFireTime()	Returns the last time at which the Trigger will fire, if the Trigger will repeat indefinitely, null will be returned.
Date	getFireTimeAfter(Date afterTime)	Returns the next time at which the Trigger will fire, after the given time.
JobDataMap	getJobDataMap()	Get the JobDataMap that is associated with the Trigger.
String	getJobName()	Get the name of the associated JobDetail.
int	getMisfireInstruction()	Get the instruction the Scheduler should be given for handling misfire situations for this Trigger- the concrete Trigger type that you are using will have defined a set of additional MISFIRE_INSTRUCTION_XXX constants that may be set as this property's value.
String	getName()	Get the name of this Trigger.
Date	getNextFireTime()	Returns the next time at which the Trigger is scheduled to fire.
Date	getPreviousFireTime()	Returns the previous time at which the Trigger fired.
int	getPriority()	The priority of a Trigger acts as a tiebreaker such that if two Trigger s have the same scheduled fire time, then the one with the higher priority will get first access to a worker thread.
Date	getStartTime()	Get the time at which the Trigger should occur.
boolean	mayFireAgain()	Used by the Scheduler to determine whether or not it is possible for this Trigger to fire again.

Methods inherited from interface java.lang.Comparable

compareTo

Field Details

MISFIRE_INSTRUCTION_SMART_POLICY

static final int MISFIRE_INSTRUCTION_SMART_POLICY

Instructs the Scheduler that upon a mis-fire situation, the updateAfterMisfire() method will be called on the Trigger to determine the mis-fire instruction, which logic will be trigger-implementation-dependent.

In order to see if this instruction fits your needs, you should look at the documentation for the getSmartMisfirePolicy() method on the particular Trigger implementation you are using.

See Also:

• Constant Field Values

MISFIRE_INSTRUCTION_IGNORE_MISFIRE_POLICY

static final int MISFIRE_INSTRUCTION_IGNORE_MISFIRE_POLICY

Instructs the Scheduler that the Trigger will never be evaluated for a misfire situation, and that the scheduler will simply try to fire it as soon as it can, and then update the Trigger as if it had fired at the proper time.

NOTE: if a trigger uses this instruction, and it has missed several of its scheduled firings, then

See Also:

• Constant Field Values

DEFAULT_PRIORITY

static final int DEFAULT_PRIORITY

The default value for priority.

See Also:

• Constant Field Values

Method Details

getName

String getName()

Get the name of this Trigger.

getJobName

String getJobName()

Get the name of the associated JobDetail.

getDescription

String getDescription()

Return the description given to the Trigger instance by its creator (if any).

Returns:

null if no description was set.

getCalendarName

String getCalendarName()

Get the name of the Calendar associated with this Trigger.

Returns:

null if there is no associated Calendar.

getJobDataMap

JobDataMap getJobDataMap()

Get the JobDataMap that is associated with the Trigger.

Changes made to this map during job execution are not re-persisted, and in fact typically result in an IllegalStateException.

getPriority

int getPriority()

The priority of a Trigger acts as a tiebreaker such that if two Trigger s have the same scheduled fire time, then the one with the higher priority will get first access to a worker thread.

If not explicitly set, the default value is 5.

See Also:

• DEFAULT_PRIORITY

mayFireAgain

boolean mayFireAgain()

Used by the Scheduler to determine whether or not it is possible for this Trigger to fire again.

If the returned value is false then the Scheduler may remove the Trigger from the JobStore.

getStartTime

Date getStartTime()

Get the time at which the Trigger should occur.

getEndTime

Date getEndTime()

Get the time at which the Trigger should quit repeating - regardless of any remaining repeats (based on the trigger's particular repeat settings).

See Also:

• getFinalFireTime()

getNextFireTime

Date getNextFireTime()

Returns the next time at which the Trigger is scheduled to fire. If the trigger will not fire again, null will be returned. Note that the time returned can possibly be in the past, if the time that was computed for the trigger to next fire has already arrived, but the scheduler has not yet been able to fire the trigger (which would likely be due to lack of resources e.g. threads).

The value returned is not guaranteed to be valid until after the Trigger has been added to the scheduler.

See Also:

• invalid @see

  TriggerUtils#computeFireTimesBetween(Trigger, Calendar, Date, Date)

getPreviousFireTime

Date getPreviousFireTime()

Returns the previous time at which the Trigger fired. If the trigger has not yet fired, null will be returned.

getFireTimeAfter

Date getFireTimeAfter(Date afterTime)

Returns the next time at which the Trigger will fire, after the given time. If the trigger will not fire after the given time, null will be returned.

getFinalFireTime

Date getFinalFireTime()

Returns the last time at which the Trigger will fire, if the Trigger will repeat indefinitely, null will be returned.

Note that the return time *may* be in the past.

getMisfireInstruction

int getMisfireInstruction()

Get the instruction the Scheduler should be given for handling misfire situations for this Trigger- the concrete Trigger type that you are using will have defined a set of additional MISFIRE_INSTRUCTION_XXX constants that may be set as this property's value.

If not explicitly set, the default value is MISFIRE_INSTRUCTION_SMART_POLICY.

See Also:

• MISFIRE_INSTRUCTION_SMART_POLICY
• invalid @see

  #updateAfterMisfire(Calendar)

• SimpleTrigger
• CronTrigger

equals

boolean equals(Object other)

Trigger equality is based upon the equality of the TriggerKey.

Overrides:

equals in class Object

Returns:

true if the key of this Trigger equals that of the given Trigger.