org.quartz.impl.triggers
Class CalendarIntervalTriggerImpl

java.lang.Object
  org.quartz.impl.triggers.AbstractTrigger
      org.quartz.impl.triggers.CalendarIntervalTriggerImpl

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, java.lang.Comparable<Trigger>, CalendarIntervalTrigger, CoreTrigger, MutableTrigger, OperableTrigger, Trigger

public class CalendarIntervalTriggerImpl
extends AbstractTrigger
implements CalendarIntervalTrigger, CoreTrigger

A concrete Trigger that is used to fire a JobDetail based upon repeating calendar time intervals.

The trigger will fire every N (see setRepeatInterval(int) ) units of calendar time (see #setRepeatIntervalUnit(IntervalUnit)) as specified in the trigger's definition. This trigger can achieve schedules that are not possible with SimpleTrigger (e.g because months are not a fixed number of seconds) or CronTrigger (e.g. because "every 5 months" is not an even divisor of 12).

If you use an interval unit of MONTH then care should be taken when setting a startTime value that is on a day near the end of the month. For example, if you choose a start time that occurs on January 31st, and have a trigger with unit MONTH and interval 1, then the next fire time will be February 28th, and the next time after that will be March 28th - and essentially each subsequent firing will occur on the 28th of the month, even if a 31st day exists. If you want a trigger that always fires on the last day of the month - regardless of the number of days in the month, you should use CronTrigger.

Since:

1.7

Author:

James House

See Also:

Trigger, CronTrigger, SimpleTrigger, NthIncludedDayTrigger, TriggerUtils, Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface org.quartz.Trigger

Trigger.CompletedExecutionInstruction, Trigger.TriggerState, Trigger.TriggerTimeComparator

Field Summary

Fields inherited from interface org.quartz.CalendarIntervalTrigger

MISFIRE_INSTRUCTION_DO_NOTHING, MISFIRE_INSTRUCTION_FIRE_ONCE_NOW

Fields inherited from interface org.quartz.Trigger

DEFAULT_PRIORITY, MISFIRE_INSTRUCTION_IGNORE_MISFIRE_POLICY, MISFIRE_INSTRUCTION_SMART_POLICY

Constructor Summary

CalendarIntervalTriggerImpl()
Create a DateIntervalTrigger with no settings.

CalendarIntervalTriggerImpl(java.lang.String name, DateBuilder.IntervalUnit intervalUnit, int repeatInterval)
Create a DateIntervalTrigger that will occur immediately, and repeat at the the given interval.

CalendarIntervalTriggerImpl(java.lang.String name, java.util.Date startTime, java.util.Date endTime, DateBuilder.IntervalUnit intervalUnit, int repeatInterval)
Create a DateIntervalTrigger that will occur at the given time, and repeat at the the given interval until the given end time.

CalendarIntervalTriggerImpl(java.lang.String name, java.lang.String group, DateBuilder.IntervalUnit intervalUnit, int repeatInterval)
Create a DateIntervalTrigger that will occur immediately, and repeat at the the given interval.

CalendarIntervalTriggerImpl(java.lang.String name, java.lang.String group, java.util.Date startTime, java.util.Date endTime, DateBuilder.IntervalUnit intervalUnit, int repeatInterval)
Create a DateIntervalTrigger that will occur at the given time, and repeat at the the given interval until the given end time.

CalendarIntervalTriggerImpl(java.lang.String name, java.lang.String group, java.lang.String jobName, java.lang.String jobGroup, java.util.Date startTime, java.util.Date endTime, DateBuilder.IntervalUnit intervalUnit, int repeatInterval)
Create a DateIntervalTrigger that will occur at the given time, fire the identified Job and repeat at the the given interval until the given end time.

Method Summary

java.util.Date	computeFirstFireTime(Calendar calendar) Called by the scheduler at the time a Trigger is first added to the scheduler, in order to have the Trigger compute its first fire time, based on any associated calendar.
java.util.Date	getEndTime() Get the time at which the DateIntervalTrigger should quit repeating.
java.util.Date	getFinalFireTime() Returns the final time at which the DateIntervalTrigger will fire, if there is no end time set, null will be returned.
java.util.Date	getFireTimeAfter(java.util.Date afterTime) Returns the next time at which the DateIntervalTrigger will fire, after the given time.
protected java.util.Date	getFireTimeAfter(java.util.Date afterTime, boolean ignoreEndTime)
java.util.Date	getNextFireTime() Returns the next time at which the Trigger is scheduled to fire.
java.util.Date	getPreviousFireTime() Returns the previous time at which the DateIntervalTrigger fired.
int	getRepeatInterval() Get the the time interval that will be added to the DateIntervalTrigger's fire time (in the set repeat interval unit) in order to calculate the time of the next trigger repeat.
DateBuilder.IntervalUnit	getRepeatIntervalUnit() Get the interval unit - the time unit on with the interval applies.
ScheduleBuilder<CalendarIntervalTrigger>	getScheduleBuilder() Get a ScheduleBuilder that is configured to produce a schedule identical to this trigger's schedule.
java.util.Date	getStartTime() Get the time at which the DateIntervalTrigger should occur.
int	getTimesTriggered() Get the number of times the DateIntervalTrigger has already fired.
boolean	hasAdditionalProperties()
boolean	mayFireAgain() Determines whether or not the DateIntervalTrigger will occur again.
void	setEndTime(java.util.Date endTime) Set the time at which the DateIntervalTrigger should quit repeating (and be automatically deleted).
void	setNextFireTime(java.util.Date nextFireTime) Set the next time at which the DateIntervalTrigger should fire.
void	setPreviousFireTime(java.util.Date previousFireTime) Set the previous time at which the DateIntervalTrigger fired.
void	setRepeatInterval(int repeatInterval) set the the time interval that will be added to the DateIntervalTrigger's fire time (in the set repeat interval unit) in order to calculate the time of the next trigger repeat.
void	setRepeatIntervalUnit(DateBuilder.IntervalUnit intervalUnit) Set the interval unit - the time unit on with the interval applies.
void	setStartTime(java.util.Date startTime) Set the time at which the DateIntervalTrigger should occur.
void	setTimesTriggered(int timesTriggered) Set the number of times the DateIntervalTrigger has already fired.
void	triggered(Calendar calendar) Called when the Scheduler has decided to 'fire' the trigger (execute the associated Job), in order to give the Trigger a chance to update itself for its next triggering (if any).
void	updateAfterMisfire(Calendar cal) Updates the DateIntervalTrigger's state based on the MISFIRE_INSTRUCTION_XXX that was selected when the DateIntervalTrigger was created.
void	updateWithNewCalendar(Calendar calendar, long misfireThreshold) This method should not be used by the Quartz client.
void	validate() Validates whether the properties of the JobDetail are valid for submission into a Scheduler.
protected boolean	validateMisfireInstruction(int misfireInstruction)

Methods inherited from class org.quartz.impl.triggers.AbstractTrigger

clone, compareTo, equals, executionComplete, getCalendarName, getDescription, getFireInstanceId, getFullJobName, getFullName, getGroup, getJobDataMap, getJobGroup, getJobKey, getJobName, getKey, getMisfireInstruction, getName, getPriority, getTriggerBuilder, hashCode, setCalendarName, setDescription, setFireInstanceId, setGroup, setJobDataMap, setJobGroup, setJobKey, setJobName, setKey, setMisfireInstruction, setName, setPriority, toString

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.quartz.CalendarIntervalTrigger

getTriggerBuilder

Methods inherited from interface org.quartz.Trigger

compareTo, equals, getCalendarName, getDescription, getJobDataMap, getJobKey, getKey, getMisfireInstruction, getPriority

Constructor Detail

CalendarIntervalTriggerImpl

public CalendarIntervalTriggerImpl()

Create a DateIntervalTrigger with no settings.

CalendarIntervalTriggerImpl

public CalendarIntervalTriggerImpl(java.lang.String name,
                                   DateBuilder.IntervalUnit intervalUnit,
                                   int repeatInterval)

Create a DateIntervalTrigger that will occur immediately, and repeat at the the given interval.

CalendarIntervalTriggerImpl

public CalendarIntervalTriggerImpl(java.lang.String name,
                                   java.lang.String group,
                                   DateBuilder.IntervalUnit intervalUnit,
                                   int repeatInterval)

Create a DateIntervalTrigger that will occur immediately, and repeat at the the given interval.

CalendarIntervalTriggerImpl

public CalendarIntervalTriggerImpl(java.lang.String name,
                                   java.util.Date startTime,
                                   java.util.Date endTime,
                                   DateBuilder.IntervalUnit intervalUnit,
                                   int repeatInterval)

Create a DateIntervalTrigger that will occur at the given time, and repeat at the the given interval until the given end time.

Parameters:

startTime - A Date set to the time for the Trigger to fire.

endTime - A Date set to the time for the Trigger to quit repeat firing.

intervalUnit - The repeat interval unit (minutes, days, months, etc).

repeatInterval - The number of milliseconds to pause between the repeat firing.

CalendarIntervalTriggerImpl

public CalendarIntervalTriggerImpl(java.lang.String name,
                                   java.lang.String group,
                                   java.util.Date startTime,
                                   java.util.Date endTime,
                                   DateBuilder.IntervalUnit intervalUnit,
                                   int repeatInterval)

Create a DateIntervalTrigger that will occur at the given time, and repeat at the the given interval until the given end time.

Parameters:

startTime - A Date set to the time for the Trigger to fire.

endTime - A Date set to the time for the Trigger to quit repeat firing.

intervalUnit - The repeat interval unit (minutes, days, months, etc).

repeatInterval - The number of milliseconds to pause between the repeat firing.

CalendarIntervalTriggerImpl

public CalendarIntervalTriggerImpl(java.lang.String name,
                                   java.lang.String group,
                                   java.lang.String jobName,
                                   java.lang.String jobGroup,
                                   java.util.Date startTime,
                                   java.util.Date endTime,
                                   DateBuilder.IntervalUnit intervalUnit,
                                   int repeatInterval)

Create a DateIntervalTrigger that will occur at the given time, fire the identified Job and repeat at the the given interval until the given end time.

Parameters:

startTime - A Date set to the time for the Trigger to fire.

endTime - A Date set to the time for the Trigger to quit repeat firing.

intervalUnit - The repeat interval unit (minutes, days, months, etc).

repeatInterval - The number of milliseconds to pause between the repeat firing.

Method Detail

getStartTime

public java.util.Date getStartTime()

Get the time at which the DateIntervalTrigger should occur.

Specified by:

getStartTime in interface Trigger

Specified by:

getStartTime in class AbstractTrigger

setStartTime

public void setStartTime(java.util.Date startTime)

Set the time at which the DateIntervalTrigger should occur.

Specified by:

setStartTime in interface MutableTrigger

Specified by:

setStartTime in class AbstractTrigger

Throws:

java.lang.IllegalArgumentException - if startTime is null.

getEndTime

public java.util.Date getEndTime()

Get the time at which the DateIntervalTrigger should quit repeating.

Specified by:

getEndTime in interface Trigger

Specified by:

getEndTime in class AbstractTrigger

See Also:

getFinalFireTime()

setEndTime

public void setEndTime(java.util.Date endTime)

Set the time at which the DateIntervalTrigger should quit repeating (and be automatically deleted).

Specified by:

setEndTime in interface MutableTrigger

Specified by:

setEndTime in class AbstractTrigger

Throws:

java.lang.IllegalArgumentException - if endTime is before start time.

See Also:

TriggerUtils#computeEndTimeToAllowParticularNumberOfFirings(AbstractTrigger, Calendar, int)

getRepeatIntervalUnit

public DateBuilder.IntervalUnit getRepeatIntervalUnit()

Description copied from interface: CalendarIntervalTrigger

Get the interval unit - the time unit on with the interval applies.

Specified by:

getRepeatIntervalUnit in interface CalendarIntervalTrigger

setRepeatIntervalUnit

public void setRepeatIntervalUnit(DateBuilder.IntervalUnit intervalUnit)

Set the interval unit - the time unit on with the interval applies.

getRepeatInterval

public int getRepeatInterval()

Description copied from interface: CalendarIntervalTrigger

Get the the time interval that will be added to the DateIntervalTrigger's fire time (in the set repeat interval unit) in order to calculate the time of the next trigger repeat.

Specified by:

getRepeatInterval in interface CalendarIntervalTrigger

setRepeatInterval

public void setRepeatInterval(int repeatInterval)

set the the time interval that will be added to the DateIntervalTrigger's fire time (in the set repeat interval unit) in order to calculate the time of the next trigger repeat.

Throws:

java.lang.IllegalArgumentException - if repeatInterval is < 1

getTimesTriggered

public int getTimesTriggered()

Description copied from interface: CalendarIntervalTrigger

Get the number of times the DateIntervalTrigger has already fired.

Specified by:

getTimesTriggered in interface CalendarIntervalTrigger

setTimesTriggered

public void setTimesTriggered(int timesTriggered)

Set the number of times the DateIntervalTrigger has already fired.

validateMisfireInstruction

protected boolean validateMisfireInstruction(int misfireInstruction)

Specified by:

validateMisfireInstruction in class AbstractTrigger

updateAfterMisfire

public void updateAfterMisfire(Calendar cal)

Updates the DateIntervalTrigger's state based on the MISFIRE_INSTRUCTION_XXX that was selected when the DateIntervalTrigger was created.

If the misfire instruction is set to MISFIRE_INSTRUCTION_SMART_POLICY, then the following scheme will be used:

• The instruction will be interpreted as MISFIRE_INSTRUCTION_FIRE_ONCE_NOW

Specified by:

updateAfterMisfire in interface OperableTrigger

Specified by:

updateAfterMisfire in class AbstractTrigger

triggered

public void triggered(Calendar calendar)

Called when the Scheduler has decided to 'fire' the trigger (execute the associated Job), in order to give the Trigger a chance to update itself for its next triggering (if any).

Specified by:

triggered in interface OperableTrigger

Specified by:

triggered in class AbstractTrigger

See Also:

AbstractTrigger.executionComplete(JobExecutionContext, JobExecutionException)

updateWithNewCalendar

public void updateWithNewCalendar(Calendar calendar,
                                  long misfireThreshold)

Description copied from class: AbstractTrigger

This method should not be used by the Quartz client.

To be implemented by the concrete class.

The implementation should update the Trigger's state based on the given new version of the associated Calendar (the state should be updated so that it's next fire time is appropriate given the Calendar's new settings).

Specified by:

updateWithNewCalendar in interface OperableTrigger

Specified by:

updateWithNewCalendar in class AbstractTrigger

See Also:

org.quartz.Trigger#updateWithNewCalendar(org.quartz.Calendar, long)

computeFirstFireTime

public java.util.Date computeFirstFireTime(Calendar calendar)

Called by the scheduler at the time a Trigger is first added to the scheduler, in order to have the Trigger compute its first fire time, based on any associated calendar.

After this method has been called, getNextFireTime() should return a valid answer.

Specified by:

computeFirstFireTime in interface OperableTrigger

Specified by:

computeFirstFireTime in class AbstractTrigger

Returns:

the first time at which the Trigger will be fired by the scheduler, which is also the same value getNextFireTime() will return (until after the first firing of the Trigger).

getNextFireTime

public java.util.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.

Specified by:

getNextFireTime in interface Trigger

Specified by:

getNextFireTime in class AbstractTrigger

See Also:

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

getPreviousFireTime

public java.util.Date getPreviousFireTime()

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

Specified by:

getPreviousFireTime in interface Trigger

Specified by:

getPreviousFireTime in class AbstractTrigger

setNextFireTime

public void setNextFireTime(java.util.Date nextFireTime)

Set the next time at which the DateIntervalTrigger should fire.

This method should not be invoked by client code.

Specified by:

setNextFireTime in interface OperableTrigger

setPreviousFireTime

public void setPreviousFireTime(java.util.Date previousFireTime)

Set the previous time at which the DateIntervalTrigger fired.

This method should not be invoked by client code.

Specified by:

setPreviousFireTime in interface OperableTrigger

getFireTimeAfter

public java.util.Date getFireTimeAfter(java.util.Date afterTime)

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

Specified by:

getFireTimeAfter in interface Trigger

Specified by:

getFireTimeAfter in class AbstractTrigger

getFireTimeAfter

protected java.util.Date getFireTimeAfter(java.util.Date afterTime,
                                          boolean ignoreEndTime)

getFinalFireTime

public java.util.Date getFinalFireTime()

Returns the final time at which the DateIntervalTrigger will fire, if there is no end time set, null will be returned.

Note that the return time may be in the past.

Specified by:

getFinalFireTime in interface Trigger

Specified by:

getFinalFireTime in class AbstractTrigger

mayFireAgain

public boolean mayFireAgain()

Determines whether or not the DateIntervalTrigger will occur again.

Specified by:

mayFireAgain in interface Trigger

Specified by:

mayFireAgain in class AbstractTrigger

validate

public void validate()
              throws SchedulerException

Validates whether the properties of the JobDetail are valid for submission into a Scheduler.

Specified by:

validate in interface OperableTrigger

Overrides:

validate in class AbstractTrigger

Throws:

java.lang.IllegalStateException - if a required property (such as Name, Group, Class) is not set.

SchedulerException

getScheduleBuilder

public ScheduleBuilder<CalendarIntervalTrigger> getScheduleBuilder()

Get a ScheduleBuilder that is configured to produce a schedule identical to this trigger's schedule.

Specified by:

getScheduleBuilder in interface Trigger

Specified by:

getScheduleBuilder in class AbstractTrigger

See Also:

AbstractTrigger.getTriggerBuilder()

hasAdditionalProperties

public boolean hasAdditionalProperties()

Specified by:

hasAdditionalProperties in interface CoreTrigger