JobExecutionContext (Quartz Parent POM 2.0.1 API)

JobExecutionContext s are also returned from the Scheduler.getCurrentlyExecutingJobs() method. These are the same instances as those passed into the jobs that are currently executing within the scheduler. The exception to this is when your application is using Quartz remotely (i.e. via RMI) - in which case you get a clone of the JobExecutionContexts, and their references to the Scheduler and Job instances have been lost (a clone of the JobDetail is still available - just not a handle to the job instance that is running).

Author:

James House

See Also:

getScheduler(), getMergedJobDataMap(), getJobDetail(), Job, Trigger, JobDataMap

getScheduler

Scheduler getScheduler()

Get a handle to the Scheduler instance that fired the Job.

getTrigger

Trigger getTrigger()

Get a handle to the Trigger instance that fired the Job.

getCalendar

Calendar getCalendar()

Get a handle to the Calendar referenced by the Trigger instance that fired the Job.

isRecovering

boolean isRecovering()

If the Job is being re-executed because of a 'recovery' situation, this method will return true.

getRefireCount

int getRefireCount()

getMergedJobDataMap

JobDataMap getMergedJobDataMap()

Get the convenience JobDataMap of this execution context.

The JobDataMap found on this object serves as a convenience - it is a merge of the JobDataMap found on the JobDetail and the one found on the Trigger, with the value in the latter overriding any same-named values in the former. It is thus considered a 'best practice' that the execute code of a Job retrieve data from the JobDataMap found on this object.

NOTE: Do not expect value 'set' into this JobDataMap to somehow be set back onto a StatefulJob's own JobDataMap.

Attempts to change the contents of this map typically result in an IllegalStateException.

getJobDetail

JobDetail getJobDetail()

Get the JobDetail associated with the Job.

getJobInstance

Job getJobInstance()

Get the instance of the Job that was created for this execution.

Note: The Job instance is not available through remote scheduler interfaces.

getFireTime

Date getFireTime()

The actual time the trigger fired. For instance the scheduled time may have been 10:00:00 but the actual fire time may have been 10:00:03 if the scheduler was too busy.

Returns:

Returns the fireTime.

See Also:

getScheduledFireTime()

getScheduledFireTime

Date getScheduledFireTime()

The scheduled time the trigger fired for. For instance the scheduled time may have been 10:00:00 but the actual fire time may have been 10:00:03 if the scheduler was too busy.

Returns:

Returns the scheduledFireTime.

See Also:

getFireTime()

getPreviousFireTime

Date getPreviousFireTime()

getNextFireTime

Date getNextFireTime()

getResult

Object getResult()

Returns the result (if any) that the Job set before its execution completed (the type of object set as the result is entirely up to the particular job).

The result itself is meaningless to Quartz, but may be informative to JobListeners or TriggerListeners that are watching the job's execution.

Returns:

Returns the result.

void setResult(Object result)

long getJobRunTime()

void put(Object key,
         Object value)

Object get(Object key)