Quartzs的job，trriger监听器源码分析

在job存储之后，之后做了job添加通知，通知调度器下一刻执行时间，并唤醒正在等在执行的job，然后添加trriger通知。
Java代码   

1. public class QuartzScheduler  
2.     implements RemotableQuartzScheduler  
3. {  
4.  public Date scheduleJob(JobDetail jobDetail, Trigger trigger)  
5.         throws SchedulerException  
6.     {  
7.         validateState();  
8.         if(jobDetail == null)  
9.             throw new SchedulerException("JobDetail cannot be null");  
10.         if(trigger == null)  
11.             throw new SchedulerException("Trigger cannot be null");  
12.         if(jobDetail.getKey() == null)  
13.             throw new SchedulerException("Job's key cannot be null");  
14.         if(jobDetail.getJobClass() == null)  
15.             throw new SchedulerException("Job's class cannot be null");  
16.     //包装触发器  
17.         OperableTrigger trig = (OperableTrigger)trigger;  
18.         if(trigger.getJobKey() == null)  
19.         //设置触发器jobKey  
20.             trig.setJobKey(jobDetail.getKey());  
21.         else  
22.         if(!trigger.getJobKey().equals(jobDetail.getKey()))  
23.             throw new SchedulerException("Trigger does not reference given job!");  
24.         trig.validate();  
25.         Calendar cal = null;  
26.         if(trigger.getCalendarName() != null)  
27.             cal = resources.getJobStore().retrieveCalendar(trigger.getCalendarName());  
28.         Date ft = trig.computeFirstFireTime(cal);  
29.         if(ft == null)  
30.         {  
31.             throw new SchedulerException((new StringBuilder()).append("Based on configured schedule, the given trigger '").append(trigger.getKey()).append("' will never fire.").toString());  
32.         } else  
33.         {  
34.         //存储job and trriger到jobStrore  
35.             resources.getJobStore().storeJobAndTrigger(jobDetail, trig);  
36.         //添加jobDetail到调度监听器  
37.             notifySchedulerListenersJobAdded(jobDetail);  
38.             //通知调度器下一刻调度时间  
39.             notifySchedulerThread(trigger.getNextFireTime().getTime());  
40.              //添加trigger到调度监听器  
41.             notifySchedulerListenersSchduled(trigger);  
42.             return ft;  
43.         }  
44.      //添加jobDetail  
45.      public void notifySchedulerListenersJobAdded(JobDetail jobDetail)  
46.     {  
47.         List schedListeners = buildSchedulerListenerList();  
48.         for(Iterator i$ = schedListeners.iterator(); i$.hasNext();)  
49.         {  
50.             SchedulerListener sl = (SchedulerListener)i$.next();  
51.             try  
52.             {  
53.                 sl.jobAdded(jobDetail);  
54.             }  
55.             catch(Exception e)  
56.             {  
57.                 getLog().error("Error while notifying SchedulerListener of JobAdded.", e);  
58.             }  
59.         }  
60.   
61.     }  
62.     //获取调度监听器  
63.      private List buildSchedulerListenerList()  
64.     {  
65.         List allListeners = new LinkedList();  
66.         allListeners.addAll(getListenerManager().getSchedulerListeners());  
67.         allListeners.addAll(getInternalSchedulerListeners());  
68.         return allListeners;  
69.     }  
70.     //获取内部调度器  
71.       public List getInternalSchedulerListeners()  
72.     {  
73.         ArrayList arraylist = internalSchedulerListeners;  
74.         JVM INSTR monitorenter ;  
75.         return Collections.unmodifiableList(new ArrayList(internalSchedulerListeners));  
76.         Exception exception;  
77.         exception;  
78.         throw exception;  
79.     }  
80.      //通知调度器下一刻调度时间  
81.     protected void notifySchedulerThread(long candidateNewNextFireTime)  
82.     {  
83.         if(isSignalOnSchedulingChange())  
84.             signaler.signalSchedulingChange(candidateNewNextFireTime);  
85.     }  
86.     //添加trigger到调度监听器  
87.     public void notifySchedulerListenersSchduled(Trigger trigger)  
88.     {  
89.         List schedListeners = buildSchedulerListenerList();  
90.         for(Iterator i$ = schedListeners.iterator(); i$.hasNext();)  
91.         {  
92.             SchedulerListener sl = (SchedulerListener)i$.next();  
93.             try  
94.             {  
95.                 sl.jobScheduled(trigger);  
96.             }  
97.             catch(Exception e)  
98.             {  
99.                 getLog().error((new StringBuilder()).append("Error while notifying SchedulerListener of scheduled job.  Triger=").append(trigger.getKey()).toString(), e);  
100.             }  
101.         }  
102.   
103.     }  
104.     private static String VERSION_MAJOR;  
105.     private static String VERSION_MINOR;  
106.     private static String VERSION_ITERATION;  
107.     private QuartzSchedulerResources resources;  
108.     private QuartzSchedulerThread schedThread;  
109.     private ThreadGroup threadGroup;  
110.     private SchedulerContext context;  
111.     private ListenerManager listenerManager;//监听管理器  
112.     private HashMap internalJobListeners;  
113.     private HashMap internalTriggerListeners;  
114.     private ArrayList internalSchedulerListeners;  
115.     private JobFactory jobFactory;  
116.     ExecutingJobsManager jobMgr;  
117.     ErrorLogger errLogger;  
118.     private SchedulerSignaler signaler;  
119.     private Random random;  
120.     private ArrayList holdToPreventGC;  
121.     private boolean signalOnSchedulingChange;  
122.     private volatile boolean closed;  
123.     private volatile boolean shuttingDown;  
124.     private boolean boundRemotely;  
125.     private QuartzSchedulerMBean jmxBean;  
126.     private Date initialStart;  
127.     private final Timer updateTimer;  
128. }  

//调度监听器 下载

Java代码   

1.  public class ListenerManagerImpl  
2.     implements ListenerManager  
3. {  
4. public ListenerManagerImpl()  
5.     {  
6.         globalJobListeners = new LinkedHashMap(10);  
7.         globalTriggerListeners = new LinkedHashMap(10);  
8.         globalJobListenersMatchers = new LinkedHashMap(10);  
9.         globalTriggerListenersMatchers = new LinkedHashMap(10);  
10.         schedulerListeners = new ArrayList(10);  
11.     }  
12.     //添加调度监听器  
13.      public void addSchedulerListener(SchedulerListener schedulerListener)  
14.     {  
15.         synchronized(schedulerListeners)  
16.         {  
17.             schedulerListeners.add(schedulerListener);  
18.         }  
19.     }  
20.     //添加job监听器  
21.     public void addJobListener(JobListener jobListener, List matchers)  
22.     {  
23.         if(jobListener.getName() == null || jobListener.getName().length() == 0)  
24.             throw new IllegalArgumentException("JobListener name cannot be empty.");  
25.         synchronized(globalJobListeners)  
26.         {  
27.             globalJobListeners.put(jobListener.getName(), jobListener);  
28.             LinkedList matchersL = new LinkedList();  
29.             if(matchers != null && matchers.size() > 0)  
30.                 matchersL.addAll(matchers);  
31.             else  
32.                 matchersL.add(EverythingMatcher.allJobs());  
33.             globalJobListenersMatchers.put(jobListener.getName(), matchersL);  
34.         }  
35.     }  
36.      //添加Trigger监听器  
37.       public void addTriggerListener(TriggerListener triggerListener, List matchers)  
38.     {  
39.         if(triggerListener.getName() == null || triggerListener.getName().length() == 0)  
40.             throw new IllegalArgumentException("TriggerListener name cannot be empty.");  
41.         synchronized(globalTriggerListeners)  
42.         {  
43.             globalTriggerListeners.put(triggerListener.getName(), triggerListener);  
44.             LinkedList matchersL = new LinkedList();  
45.             if(matchers != null && matchers.size() > 0)  
46.                 matchersL.addAll(matchers);  
47.             else  
48.                 matchersL.add(EverythingMatcher.allTriggers());  
49.             globalTriggerListenersMatchers.put(triggerListener.getName(), matchersL);  
50.         }  
51.     }  
52.      public List getSchedulerListeners()  
53.     {  
54.         ArrayList arraylist = schedulerListeners;  
55.         JVM INSTR monitorenter ;  
56.         return Collections.unmodifiableList(new ArrayList(schedulerListeners));  
57.         Exception exception;  
58.         exception;  
59.         throw exception;  
60.     }  
61.   
62.     private Map globalJobListeners;//LinkedHashMap<String,JobListener>,key为JobListener.getName()，全局job监听器  
63.     private Map globalTriggerListeners;//LinkedHashMap<String,TriggerListener>,key为TriggerListener.getName()，全局Trriger监听器  
64.     private Map globalJobListenersMatchers;  
65.     private Map globalTriggerListenersMatchers;  
66.     private ArrayList schedulerListeners;//List<SchedulerListener>调度监听器  
67. }  

//QuartzSchedulerMBean 下载

Java代码   

1. public class QuartzSchedulerMBeanImpl extends StandardMBean  
2.     implements NotificationEmitter, QuartzSchedulerMBean, JobListener, SchedulerListener  
3. {  
4.   //添加jobDetail通知到JMX  
5.   public void jobAdded(JobDetail jobDetail)  
6.     {  
7.         sendNotification("jobAdded", JobDetailSupport.toCompositeData(jobDetail));  
8.     }  
9.  //添加trigger通知到JMX  
10.   public void jobScheduled(Trigger trigger)  
11.     {  
12.         sendNotification("jobScheduled", TriggerSupport.toCompositeData(trigger));  
13.     }  
14.   public void sendNotification(String eventType, Object data)  
15.     {  
16.         sendNotification(eventType, data, null);  
17.     }  
18.   
19.  public void sendNotification(String eventType, Object data, String msg)  
20.     {  
21.         Notification notif = new Notification(eventType, this, sequenceNumber.incrementAndGet(), System.currentTimeMillis(), msg);  
22.         if(data != null)  
23.             notif.setUserData(data);  
24.         emitter.sendNotification(notif);  
25.     }  
26. }  

//调度通知器 下载

Java代码   

1. public class SchedulerSignalerImpl  
2.     implements SchedulerSignaler  
3. {  
4.   
5.     public SchedulerSignalerImpl(QuartzScheduler sched, QuartzSchedulerThread schedThread)  
6.     {  
7.         log = LoggerFactory.getLogger(org/quartz/core/SchedulerSignalerImpl);  
8.         this.sched = sched;  
9.         this.schedThread = schedThread;  
10.         log.info((new StringBuilder()).append("Initialized Scheduler Signaller of type: ").append(getClass()).toString());  
11.     }  
12.   
13.     public void signalSchedulingChange(long candidateNewNextFireTime)  
14.     {  
15.         schedThread.signalSchedulingChange(candidateNewNextFireTime);  
16.     }  
17.   
18.     Logger log;  
19.     protected QuartzScheduler sched;  
20.     protected QuartzSchedulerThread schedThread;  
21. }  

//调度器线程 下载

Java代码   

1. public class QuartzSchedulerThread extends Thread  
2. {  
3. QuartzSchedulerThread(QuartzScheduler qs, QuartzSchedulerResources qsRsrcs)  
4.     {  
5.         this(qs, qsRsrcs, qsRsrcs.getMakeSchedulerThreadDaemon(), 5);  
6.     }  
7.     //唤醒所有等待sigLock的调度器  
8.      public void signalSchedulingChange(long candidateNewNextFireTime)  
9.     {  
10.         synchronized(sigLock)  
11.         {  
12.             signaled = true;  
13.             signaledNextFireTime = candidateNewNextFireTime;  
14.             sigLock.notifyAll();  
15.         }  
16.     }  
17.  private QuartzScheduler qs;  
18.     private QuartzSchedulerResources qsRsrcs;  
19.     private final Object sigLock;  
20.     private boolean signaled;  
21.     private long signaledNextFireTime;  
22.     private boolean paused;  
23.     private AtomicBoolean halted;  
24.     private Random random;  
25.     private static long DEFAULT_IDLE_WAIT_TIME = 30000L;  
26.     private long idleWaitTime;  
27.     private int idleWaitVariablness;  
28.     private final Logger log;  
29.   
30. }  

//SchedulerListener 下载

Java代码   

1. public interface SchedulerListener  
2. {  
3.     public abstract void jobScheduled(Trigger trigger);  
4.     public abstract void jobUnscheduled(TriggerKey triggerkey);  
5.     public abstract void triggerFinalized(Trigger trigger);  
6.     public abstract void triggerPaused(TriggerKey triggerkey);  
7.     public abstract void triggersPaused(String s);  
8.     public abstract void triggerResumed(TriggerKey triggerkey);  
9.     public abstract void triggersResumed(String s);  
10.     public abstract void jobAdded(JobDetail jobdetail);  
11.     public abstract void jobDeleted(JobKey jobkey);  
12.     public abstract void jobPaused(JobKey jobkey);  
13.     public abstract void jobsPaused(String s);  
14.     public abstract void jobResumed(JobKey jobkey);  
15.     public abstract void jobsResumed(String s);  
16.     public abstract void schedulerError(String s, SchedulerException schedulerexception);  
17.     public abstract void schedulerInStandbyMode();  
18.     public abstract void schedulerStarted();  
19.     public abstract void schedulerStarting();  
20.     public abstract void schedulerShutdown();  
21.     public abstract void schedulerShuttingdown();  
22.     public abstract void schedulingDataCleared();  
23. }  

//job监听器 下载

Java代码   

1. public interface JobListener  
2. {  
3.     public abstract String getName();  
4.     public abstract void jobToBeExecuted(JobExecutionContext jobexecutioncontext);  
5.     public abstract void jobExecutionVetoed(JobExecutionContext jobexecutioncontext);  
6.     public abstract void jobWasExecuted(JobExecutionContext jobexecutioncontext, JobExecutionException jobexecutionexception);  
7. }  

//Trigger监听器 

Java代码   

1. public interface TriggerListener  
2. {  
3.     public abstract String getName();  
4.     public abstract void triggerFired(Trigger trigger, JobExecutionContext jobexecutioncontext);  
5.     public abstract boolean vetoJobExecution(Trigger trigger, JobExecutionContext jobexecutioncontext);  
6.     public abstract void triggerMisfired(Trigger trigger);  
7.     public abstract void triggerComplete(Trigger trigger, JobExecutionContext jobexecutioncontext, Trigger.CompletedExecutionInstruction completedexecutioninstruction);  
8. }