org.springframework.scheduling.quartz

Class SimpleTriggerBean

java.lang.Object

org.quartz.Trigger

org.quartz.SimpleTrigger

org.springframework.scheduling.quartz.SimpleTriggerBean

All Implemented Interfaces:

Serializable, Cloneable, Comparable, org.springframework.beans.factory.Aware, org.springframework.beans.factory.BeanNameAware, org.springframework.beans.factory.InitializingBean, JobDetailAwareTrigger

public class SimpleTriggerBean
extends SimpleTrigger
implements JobDetailAwareTrigger, org.springframework.beans.factory.BeanNameAware, org.springframework.beans.factory.InitializingBean

Convenience subclass of Quartz's SimpleTrigger class, making bean-style usage easier.

SimpleTrigger itself is already a JavaBean but lacks sensible defaults. This class uses the Spring bean name as job name, the Quartz default group ("DEFAULT") as job group, the current time as start time, and indefinite repetition, if not specified.

This class will also register the trigger with the job name and group of a given JobDetail. This allows SchedulerFactoryBean to automatically register a trigger for the corresponding JobDetail, instead of registering the JobDetail separately.

NOTE: This convenience subclass does not work against Quartz 2.0. Use Quartz 2.0's native JobDetailImpl class or the new Quartz 2.0 builder API instead. Alternatively, switch to Spring's SimpleTriggerFactoryBean which largely is a drop-in replacement for this class and its properties and consistently works against Quartz 1.x as well as Quartz 2.0/2.1.

Since:

18.02.2004

Author:

Juergen Hoeller

See Also:

Trigger.setName(java.lang.String), Trigger.setGroup(java.lang.String), SimpleTrigger.setStartTime(java.util.Date), Trigger.setJobName(java.lang.String), Trigger.setJobGroup(java.lang.String), setJobDetail(org.quartz.JobDetail), SchedulerAccessor.setTriggers(org.quartz.Trigger[]), SchedulerAccessor.setJobDetails(org.quartz.JobDetail[]), CronTriggerBean, Serialized Form

Field Summary

Fields inherited from class org.quartz.SimpleTrigger

MISFIRE_INSTRUCTION_FIRE_NOW, MISFIRE_INSTRUCTION_RESCHEDULE_NEXT_WITH_EXISTING_COUNT, MISFIRE_INSTRUCTION_RESCHEDULE_NEXT_WITH_REMAINING_COUNT, MISFIRE_INSTRUCTION_RESCHEDULE_NOW_WITH_EXISTING_REPEAT_COUNT, MISFIRE_INSTRUCTION_RESCHEDULE_NOW_WITH_REMAINING_REPEAT_COUNT, REPEAT_INDEFINITELY

Fields inherited from class org.quartz.Trigger

DEFAULT_PRIORITY, INSTRUCTION_DELETE_TRIGGER, INSTRUCTION_NOOP, INSTRUCTION_RE_EXECUTE_JOB, INSTRUCTION_SET_ALL_JOB_TRIGGERS_COMPLETE, INSTRUCTION_SET_ALL_JOB_TRIGGERS_ERROR, INSTRUCTION_SET_TRIGGER_COMPLETE, INSTRUCTION_SET_TRIGGER_ERROR, MISFIRE_INSTRUCTION_SMART_POLICY, STATE_BLOCKED, STATE_COMPLETE, STATE_ERROR, STATE_NONE, STATE_NORMAL, STATE_PAUSED

Fields inherited from interface org.springframework.scheduling.quartz.JobDetailAwareTrigger

JOB_DETAIL_KEY

Constructor Summary

Constructors

Constructor and Description
SimpleTriggerBean()

Method Summary

Methods

Modifier and Type	Method and Description
void	afterPropertiesSet()
JobDetail	getJobDetail() Return the JobDetail that this Trigger is associated with.
void	setBeanName(String beanName)
void	setJobDataAsMap(Map<String,?> jobDataAsMap) Register objects in the JobDataMap via a given Map.
void	setJobDetail(JobDetail jobDetail) Set the JobDetail that this trigger should be associated with.
void	setMisfireInstructionName(String constantName) Set the misfire instruction via the name of the corresponding constant in the SimpleTrigger class.
void	setStartDelay(long startDelay) Set the start delay in milliseconds.
void	setTriggerListenerNames(String[] names) Set a list of TriggerListener names for this job, referring to non-global TriggerListeners registered with the Scheduler.

Methods inherited from class org.quartz.SimpleTrigger

computeFirstFireTime, computeNumTimesFiredBetween, executionComplete, getEndTime, getFinalFireTime, getFireTimeAfter, getFireTimeBefore, getNextFireTime, getPreviousFireTime, getRepeatCount, getRepeatInterval, getStartTime, getTimesTriggered, hasAdditionalProperties, main, mayFireAgain, setEndTime, setNextFireTime, setPreviousFireTime, setRepeatCount, setRepeatInterval, setStartTime, setTimesTriggered, triggered, updateAfterMisfire, updateWithNewCalendar, validate, validateMisfireInstruction

Methods inherited from class org.quartz.Trigger

addTriggerListener, clearAllTriggerListeners, clone, compareTo, equals, getCalendarName, getDescription, getFireInstanceId, getFullJobName, getFullName, getGroup, getJobDataMap, getJobGroup, getJobName, getKey, getMisfireInstruction, getName, getPriority, getTriggerListenerNames, hashCode, isVolatile, removeTriggerListener, setCalendarName, setDescription, setFireInstanceId, setGroup, setJobDataMap, setJobGroup, setJobName, setMisfireInstruction, setName, setPriority, setVolatility, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleTriggerBean

public SimpleTriggerBean()

Method Detail

setJobDataAsMap

public void setJobDataAsMap(Map<String,?> jobDataAsMap)

Register objects in the JobDataMap via a given Map.

These objects will be available to this Trigger only, in contrast to objects in the JobDetail's data map.

Parameters:

jobDataAsMap - Map with String keys and any objects as values (for example Spring-managed beans)

See Also:

JobDetailBean.setJobDataAsMap(java.util.Map)

setMisfireInstructionName

public void setMisfireInstructionName(String constantName)

Set the misfire instruction via the name of the corresponding constant in the SimpleTrigger class. Default is MISFIRE_INSTRUCTION_SMART_POLICY.

See Also:

SimpleTrigger.MISFIRE_INSTRUCTION_FIRE_NOW, SimpleTrigger.MISFIRE_INSTRUCTION_RESCHEDULE_NEXT_WITH_EXISTING_COUNT, SimpleTrigger.MISFIRE_INSTRUCTION_RESCHEDULE_NEXT_WITH_REMAINING_COUNT, SimpleTrigger.MISFIRE_INSTRUCTION_RESCHEDULE_NOW_WITH_EXISTING_REPEAT_COUNT, SimpleTrigger.MISFIRE_INSTRUCTION_RESCHEDULE_NOW_WITH_REMAINING_REPEAT_COUNT, Trigger.MISFIRE_INSTRUCTION_SMART_POLICY

setTriggerListenerNames

public void setTriggerListenerNames(String[] names)

Set a list of TriggerListener names for this job, referring to non-global TriggerListeners registered with the Scheduler.

A TriggerListener name always refers to the name returned by the TriggerListener implementation.

See Also:

SchedulerAccessor.setTriggerListeners(org.quartz.TriggerListener[]), TriggerListener.getName()

setStartDelay

public void setStartDelay(long startDelay)

Set the start delay in milliseconds.

The start delay is added to the current system time (when the bean starts) to control the start time of the trigger.

If the start delay is non-zero, it will always take precedence over start time.

Parameters:

startDelay - the start delay, in milliseconds

setJobDetail

public void setJobDetail(JobDetail jobDetail)

Set the JobDetail that this trigger should be associated with.

This is typically used with a bean reference if the JobDetail is a Spring-managed bean. Alternatively, the trigger can also be associated with a job by name and group.

See Also:

Trigger.setJobName(java.lang.String), Trigger.setJobGroup(java.lang.String)

getJobDetail

public JobDetail getJobDetail()

Description copied from interface: JobDetailAwareTrigger

Return the JobDetail that this Trigger is associated with.

Specified by:

getJobDetail in interface JobDetailAwareTrigger

Returns:

the associated JobDetail, or null if none

setBeanName

public void setBeanName(String beanName)

Specified by:

setBeanName in interface org.springframework.beans.factory.BeanNameAware

afterPropertiesSet

public void afterPropertiesSet()
                        throws ParseException

Specified by:

afterPropertiesSet in interface org.springframework.beans.factory.InitializingBean

Throws:

ParseException