public class JobExecutionContext implements java.io.Serializable {     /*     * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~     * Data members.     * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~     */     private transient Scheduler scheduler;     private Trigger trigger;     private JobDetail jobDetail;         private JobDataMap jobDataMap;     private transient Job job;         private Calendar calendar;     private boolean recovering = false;     private int numRefires = 0;     private Date fireTime;     private Date scheduledFireTime;     private Date prevFireTime;     private Date nextFireTime;         private long jobRunTime = -1;         private Object result;         private HashMap data = new HashMap();     /*     * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~     * Constructors.     * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~     */     /**     * Create a JobExcecutionContext with the given context data.     */    public JobExecutionContext(Scheduler scheduler,            TriggerFiredBundle firedBundle, Job job) {        this.scheduler = scheduler;        this.trigger = firedBundle.getTrigger();        this.calendar = firedBundle.getCalendar();        this.jobDetail = firedBundle.getJobDetail();        this.job = job;        this.recovering = firedBundle.isRecovering();        this.fireTime = firedBundle.getFireTime();        this.scheduledFireTime = firedBundle.getScheduledFireTime();        this.prevFireTime = firedBundle.getPrevFireTime();        this.nextFireTime = firedBundle.getNextFireTime();                 this.jobDataMap = new JobDataMap();        this.jobDataMap.putAll(jobDetail.getJobDataMap());        this.jobDataMap.putAll(trigger.getJobDataMap());                 this.jobDataMap.setMutable(false);        this.trigger.getJobDataMap().setMutable(false);    }     /*     * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~     * Interface.     * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~     */     /**     * Get a handle to the Scheduler instance that fired the     * Job.     */    public Scheduler getScheduler() {        return scheduler;    }     /**     * Get a handle to the Trigger instance that fired the     * Job.     */    public Trigger getTrigger() {        return trigger;    }     /**     * Get a handle to the Calendar referenced by the Trigger     * instance that fired the Job.     */    public Calendar getCalendar() {        return calendar;    }     /**     * If the Job is being re-executed because of a 'recovery'     * situation, this method will return true.     */    public boolean isRecovering() {        return recovering;    }     public void incrementRefireCount() {        numRefires++;    }     public int getRefireCount() {        return numRefires;    }     /**     * 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.     *      */    public JobDataMap getMergedJobDataMap() {        return jobDataMap;    }     /**     * Get the JobDetail associated with the Job.     */    public JobDetail getJobDetail() {        return jobDetail;    }     /**     * Get the instance of the Job that was created for this     * execution.     *      * Note: The Job instance is not available through remote scheduler     * interfaces.     */    public Job getJobInstance() {        return job;    }     /**     * 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.     *      * @return Returns the fireTime.     * @see #getScheduledFireTime()     */    public Date getFireTime() {        return fireTime;    }     /**     * 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.     *      * @return Returns the scheduledFireTime.     * @see #getFireTime()     */    public Date getScheduledFireTime() {        return scheduledFireTime;    }     public Date getPreviousFireTime() {        return prevFireTime;    }     public Date getNextFireTime() {        return nextFireTime;    }     public String toString() {        return "JobExecutionContext:" + " trigger: '"                + getTrigger().getFullName() + " job: "                + getJobDetail().getFullName() + " fireTime: '" + getFireTime()                + " scheduledFireTime: " + getScheduledFireTime()                + " previousFireTime: '" + getPreviousFireTime()                + " nextFireTime: " + getNextFireTime() + " isRecovering: "                + isRecovering() + " refireCount: " + getRefireCount();    }     /**     * 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 {@link JobListener}s or      * {@link TriggerListener}s that are watching the job's      * execution.     *      * @return Returns the result.     */    public Object getResult() {        return result;    }         /**     * Set the result (if any) of the Job's execution (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 {@link JobListener}s or      * {@link TriggerListener}s that are watching the job's      * execution.     *      * @return Returns the result.     */    public void setResult(Object result) {        this.result = result;    }         /**     * The amount of time the job ran for (in milliseconds).  The returned      * value will be -1 until the job has actually completed (or thrown an      * exception), and is therefore generally only useful to      * JobListeners and TriggerListeners.     *      * @return Returns the jobRunTime.     */    public long getJobRunTime() {        return jobRunTime;    }         /**     * @param jobRunTime The jobRunTime to set.     */    public void setJobRunTime(long jobRunTime) {        this.jobRunTime = jobRunTime;    }     /**     * Put the specified value into the context's data map with the given key.     * Possibly useful for sharing data between listeners and jobs.     *     * NOTE: this data is volatile - it is lost after the job execution     * completes, and all TriggerListeners and JobListeners have been      * notified.     *       * @param key     * @param value     */    public void put(Object key, Object value) {        data.put(key, value);    }         /**     * Get the value with the given key from the context's data map.     *      * @param key     */    public Object get(Object key) {        return data.get(key);    }}