spring定時器----JobExecutionContext

    1. 層次結構

       

    2. 類
    

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 <code>Scheduler</code> instance that fired the
     * <code>Job</code>.
     */
    public Scheduler getScheduler() {
        return scheduler;
    }
 
    /**
     * Get a handle to the <code>Trigger</code> instance that fired the
     * <code>Job</code>.
     */
    public Trigger getTrigger() {
        return trigger;
    }
 
    /**
     * Get a handle to the <code>Calendar</code> referenced by the <code>Trigger</code>
     * instance that fired the <code>Job</code>.
     */
    public Calendar getCalendar() {
        return calendar;
    }
 
    /**
     * If the <code>Job</code> is being re-executed because of a 'recovery'
     * situation, this method will return <code>true</code>.
     */
    public boolean isRecovering() {
        return recovering;
    }
 
    public void incrementRefireCount() {
        numRefires++;
    }
 
    public int getRefireCount() {
        return numRefires;
    }
 
    /**
     * Get the convenience <code>JobDataMap</code> of this execution context.
     * 
     * The <code>JobDataMap</code> found on this object serves as a convenience -
     * it is a merge of the <code>JobDataMap</code> found on the 
     * <code>JobDetail</code> and the one found on the <code>Trigger</code>, with 
     * the value in the latter overriding any same-named values in the former.
     * <i>It is thus considered a 'best practice' that the execute code of a Job
     * retrieve data from the JobDataMap found on this object</i>
     * 
     * NOTE: Do not
     * expect value 'set' into this JobDataMap to somehow be set back onto a
     * <code>StatefulJob</code>'s own JobDataMap.
     * 
     * Attempts to change the contents of this map typically result in an 
     * <code>IllegalStateException</code>.
     * 
     */
    public JobDataMap getMergedJobDataMap() {
        return jobDataMap;
    }
 
    /**
     * Get the <code>JobDetail</code> associated with the <code>Job</code>.
     */
    public JobDetail getJobDetail() {
        return jobDetail;
    }
 
    /**
     * Get the instance of the <code>Job</code> 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 <code>Job</code> 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 <code>{@link JobListener}s</code> or 
     * <code>{@link TriggerListener}s</code> that are watching the job's 
     * execution.
     * 
     * @return Returns the result.
     */
    public Object getResult() {
        return result;
    }
     
    /**
     * Set the result (if any) of the <code>Job</code>'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 <code>{@link JobListener}s</code> or 
     * <code>{@link TriggerListener}s</code> 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 
     * <code>JobListener</code>s and <code>TriggerListener</code>s.
     * 
     * @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);
    }
}

    3. 經常使用方法        <1> public Scheduler getScheduler()