quartz使用教程

1.在官网下载文件

http://www.quartz-scheduler.org/

现在的版本是2.2    quartz-2.2.0-distribution.tar.gz 

2.学习example

example1 -  Your first Quartz Program

[java]  view plain copy print ?

1. package org.quartz.examples.example1;  
2.   
3. import java.util.Date;  
4. import org.quartz.DateBuilder;  
5. import org.quartz.JobBuilder;  
6. import org.quartz.JobDetail;  
7. import org.quartz.Scheduler;  
8. import org.quartz.SchedulerFactory;  
9. import org.quartz.Trigger;  
10. import org.quartz.TriggerBuilder;  
11. import org.quartz.impl.StdSchedulerFactory;  
12. import org.slf4j.Logger;  
13. import org.slf4j.LoggerFactory;  
14.   
15. public class SimpleExample  
16. {  
17.   public void run() throws Exception  
18.   {  
19.     Logger log = LoggerFactory.getLogger(SimpleExample.class);  
20.   
21.     log.info("------- Initializing ----------------------");  
22.   
23.     SchedulerFactory sf = new StdSchedulerFactory();  
24.     Scheduler sched = sf.getScheduler();  
25.   
26.     log.info("------- Initialization Complete -----------");  
27.   
28.     Date runTime = DateBuilder.evenMinuteDate(new Date());  
29.   
30.     log.info("------- Scheduling Job  -------------------");  
31.   
32.     JobDetail job = JobBuilder.newJob(HelloJob.class).withIdentity("job1", "group1").build();  
33.   
34.     Trigger trigger = TriggerBuilder.newTrigger().withIdentity("trigger1", "group1").startAt(runTime).build();  
35.   
36.     sched.scheduleJob(job, trigger);  
37.     log.info(job.getKey() + " will run at: " + runTime);  
38.   
39.     sched.start();  
40.   
41.     log.info("------- Started Scheduler -----------------");  
42.   
43.     log.info("------- Waiting 65 seconds... -------------");  
44.     try  
45.     {  
46.       Thread.sleep(65000L);  
47.     }  
48.     catch (Exception e)  
49.     {  
50.     }  
51.   
52.     log.info("------- Shutting Down ---------------------");  
53.     sched.shutdown(true);  
54.     log.info("------- Shutdown Complete -----------------");  
55.   }  
56.   
57.   public static void main(String[] args) throws Exception  
58.   {  
59.     SimpleExample example = new SimpleExample();  
60.     example.run();  
61.   }  
62. }  

初始化schedulerFactory , schedulerFactory 有两个实现类,一个是DirectSchedulerFactory ,另外一个是StdSchedulerFactory

StdSchedulerFactory

实现了org.quartz.SchedulerFactory接口。它用了一系列的属性（java.util.Properties）来创建和初始化一个Quartz的调度器。这些属性通常保存和加载在一个文件里，但是也可以通过你的程序创建直接交给工厂处理。在工厂上调用getScheduler()就可以产生调度器，初始化它（还有线程池，JobStore和数据源），然后返回一个句柄到这个公共的接口。

DirectSchedulerFactory

是另外的一个SchedulerFactory实现。在更多的编程方法里创建调度器时，他很有用。他的用法不被赞成，原因有：1.它需要用户更清楚的知道他们在做什么。2.它不允许配置，就是说，你必须要在代码里配置所有的调度器属性。

JobBuilder

根据自己定义的工作类HelloJob 使用给定的工作名称job1和给定的组名称group1 来创建一个工作详情.

已知的Job类型有:DirectoryScanJob, EJB3InvokerJob, EJBInvokerJob, FileScanJob, JMXInvokerJob, NativeJob, NoOpJob, SendDestinationMessageJob, SendMailJob, SendQueueMessageJob, SendTopicMessageJob

TriggerBuilder

用触发器builder来设置任务的开始时间(下一分钟)

将JobDetail,和Trigger注册到调度器中,并启动了调度器.

这样,就会在指定时间类运行 HelloJob

已知的Trigger类型有:CalendarIntervalTrigger, CoreTrigger, CronTrigger, DailyTimeIntervalTrigger, MutableTrigger, OperableTrigger, SimpleTrigger

SimpleTrigger

 支持简单的循环次数以及循环间隔.

CronTrigger 

支持比 SimpleTrigger 更具体的调度，而且也不是很复杂。基于 cron 表达式，CronTrigger 支持类似日历的重复间隔，而不是单一的时间间隔 —— 这相对 SimpleTrigger 而言是一大改进。

Cron 表达式包括以下 7 个字段：

秒
分
小时
月内日期
月
周内日期
年（可选字段）

Cron 触发器利用一系列特殊字符，如下所示：

• 反斜线（/）字符表示增量值。例如，在秒字段中“5/15”代表从第 5 秒开始，每 15 秒一次。
• 问号（?）字符和字母 L 字符只有在月内日期和周内日期字段中可用。问号表示这个字段不包含具体值。所以，如果指定月内日期，可以在周内日期字段中插入“?”，表示周内日期值无关紧要。字母 L 字符是 last 的缩写。放在月内日期字段中，表示安排在当月最后一天执行。在周内日期字段中，如果“L”单独存在，就等于“7”，否则代表当月内周内日期的最后一个实例。所以“0L”表示安排在当月的最后一个星期日执行。
• 在月内日期字段中的字母（W）字符把执行安排在最靠近指定值的工作日。把“1W”放在月内日期字段中，表示把执行安排在当月的第一个工作日内。
• 井号（#）字符为给定月份指定具体的工作日实例。把“MON#2”放在周内日期字段中，表示把任务安排在当月的第二个星期一。
• 星号（*）字符是通配字符，表示该字段可以接受任何可能的值。

所有这些定义看起来可能有些吓人，但是只要几分钟练习之后，cron 表达式就会显得十分简单。

CalendarIntervalTrigger

和SimpleTrigger不同的是，SimpleTrigger是基于秒的

和CronTrigger不同的是,CalendarIntervalTrigger是以日历为初始时间,然后,间隔多少秒执行一次.而CronTrigger的“0/19 * * * * ?”只在00秒19秒和38秒处触发，因为CronTrigger完成基于表达式验证规则来的，

DailyTimeIntervalTrigger

基于每天的时间间隔来触发任务。该触发器可以设置的间隔类型有：秒，分，小时。并且可以指定在每周内哪几天执行任务。

example2 -  Simple Triggers

[java]  view plain copy print ?

1. package org.quartz.examples.example2;  
2.   
3. import java.util.Date;  
4. import org.quartz.DateBuilder;  
5. import org.quartz.DateBuilder.IntervalUnit;  
6. import org.quartz.JobBuilder;  
7. import org.quartz.JobDetail;  
8. import org.quartz.JobKey;  
9. import org.quartz.Scheduler;  
10. import org.quartz.SchedulerFactory;  
11. import org.quartz.SchedulerMetaData;  
12. import org.quartz.SimpleScheduleBuilder;  
13. import org.quartz.SimpleTrigger;  
14. import org.quartz.TriggerBuilder;  
15. import org.quartz.impl.StdSchedulerFactory;  
16. import org.slf4j.Logger;  
17. import org.slf4j.LoggerFactory;  
18.   
19. public class SimpleTriggerExample  
20. {  
21.   public void run()  
22.     throws Exception  
23.   {  
24.     Logger log = LoggerFactory.getLogger(SimpleTriggerExample.class);  
25.   
26.     log.info("------- Initializing -------------------");  
27.   
28.     SchedulerFactory sf = new StdSchedulerFactory();  
29.     Scheduler sched = sf.getScheduler();  
30.   
31.     log.info("------- Initialization Complete --------");  
32.   
33.     log.info("------- Scheduling Jobs ----------------");  
34.   
35.     Date startTime = DateBuilder.nextGivenSecondDate(null, 15);  
36.   
37.     JobDetail job = JobBuilder.newJob(SimpleJob.class).withIdentity("job1", "group1").build();  
38.   
39.     SimpleTrigger trigger = (SimpleTrigger)TriggerBuilder.newTrigger().withIdentity("trigger1", "group1").startAt(startTime).build();  
40.   
41.     Date ft = sched.scheduleJob(job, trigger);  
42.     log.info(job.getKey() + " will run at: " + ft + " and repeat: " + trigger.getRepeatCount() + " times, every " + (trigger.getRepeatInterval() / 1000L) + " seconds");  
43.   
44.     job = JobBuilder.newJob(SimpleJob.class).withIdentity("job2", "group1").build();  
45.   
46.     trigger = (SimpleTrigger)TriggerBuilder.newTrigger().withIdentity("trigger2", "group1").startAt(startTime).build();  
47.   
48.     ft = sched.scheduleJob(job, trigger);  
49.     log.info(job.getKey() + " will run at: " + ft + " and repeat: " + trigger.getRepeatCount() + " times, every " + (trigger.getRepeatInterval() / 1000L) + " seconds");  
50.   
51.     job = JobBuilder.newJob(SimpleJob.class).withIdentity("job3", "group1").build();  
52.   
53.     trigger = (SimpleTrigger)TriggerBuilder.newTrigger().withIdentity("trigger3", "group1").startAt(startTime).withSchedule(SimpleScheduleBuilder.simpleSchedule().withIntervalInSeconds(10).withRepeatCount(10)).build();  
54.   
55.     ft = sched.scheduleJob(job, trigger);  
56.     log.info(job.getKey() + " will run at: " + ft + " and repeat: " + trigger.getRepeatCount() + " times, every " + (trigger.getRepeatInterval() / 1000L) + " seconds");  
57.   
58.     trigger = (SimpleTrigger)TriggerBuilder.newTrigger().withIdentity("trigger3", "group2").startAt(startTime).withSchedule(SimpleScheduleBuilder.simpleSchedule().withIntervalInSeconds(10).withRepeatCount(2)).forJob(job).build();  
59.   
60.     ft = sched.scheduleJob(trigger);  
61.     log.info(job.getKey() + " will [also] run at: " + ft + " and repeat: " + trigger.getRepeatCount() + " times, every " + (trigger.getRepeatInterval() / 1000L) + " seconds");  
62.   
63.     job = JobBuilder.newJob(SimpleJob.class).withIdentity("job4", "group1").build();  
64.   
65.     trigger = (SimpleTrigger)TriggerBuilder.newTrigger().withIdentity("trigger4", "group1").startAt(startTime).withSchedule(SimpleScheduleBuilder.simpleSchedule().withIntervalInSeconds(10).withRepeatCount(5)).build();  
66.   
67.     ft = sched.scheduleJob(job, trigger);  
68.     log.info(job.getKey() + " will run at: " + ft + " and repeat: " + trigger.getRepeatCount() + " times, every " + (trigger.getRepeatInterval() / 1000L) + " seconds");  
69.   
70.     job = JobBuilder.newJob(SimpleJob.class).withIdentity("job5", "group1").build();  
71.   
72.     trigger = (SimpleTrigger)TriggerBuilder.newTrigger().withIdentity("trigger5", "group1").startAt(DateBuilder.futureDate(5, DateBuilder.IntervalUnit.MINUTE)).build();  
73.   
74.     ft = sched.scheduleJob(job, trigger);  
75.     log.info(job.getKey() + " will run at: " + ft + " and repeat: " + trigger.getRepeatCount() + " times, every " + (trigger.getRepeatInterval() / 1000L) + " seconds");  
76.   
77.     job = JobBuilder.newJob(SimpleJob.class).withIdentity("job6", "group1").build();  
78.   
79.     trigger = (SimpleTrigger)TriggerBuilder.newTrigger().withIdentity("trigger6", "group1").startAt(startTime).withSchedule(SimpleScheduleBuilder.simpleSchedule().withIntervalInSeconds(40).repeatForever()).build();  
80.   
81.     ft = sched.scheduleJob(job, trigger);  
82.     log.info(job.getKey() + " will run at: " + ft + " and repeat: " + trigger.getRepeatCount() + " times, every " + (trigger.getRepeatInterval() / 1000L) + " seconds");  
83.   
84.     log.info("------- Starting Scheduler ----------------");  
85.   
86.     sched.start();  
87.   
88.     log.info("------- Started Scheduler -----------------");  
89.   
90.     job = JobBuilder.newJob(SimpleJob.class).withIdentity("job7", "group1").build();  
91.   
92.     trigger = (SimpleTrigger)TriggerBuilder.newTrigger().withIdentity("trigger7", "group1").startAt(startTime).withSchedule(SimpleScheduleBuilder.simpleSchedule().withIntervalInMinutes(5).withRepeatCount(20)).build();  
93.   
94.     ft = sched.scheduleJob(job, trigger);  
95.     log.info(job.getKey() + " will run at: " + ft + " and repeat: " + trigger.getRepeatCount() + " times, every " + (trigger.getRepeatInterval() / 1000L) + " seconds");  
96.   
97.     job = JobBuilder.newJob(SimpleJob.class).withIdentity("job8", "group1").storeDurably().build();  
98.   
99.     sched.addJob(job, true);  
100.   
101.     log.info("'Manually' triggering job8...");  
102.     sched.triggerJob(JobKey.jobKey("job8", "group1"));  
103.   
104.     log.info("------- Waiting 30 seconds... --------------");  
105.     try  
106.     {  
107.       Thread.sleep(30000L);  
108.     }  
109.     catch (Exception e)  
110.     {  
111.     }  
112.   
113.     log.info("------- Rescheduling... --------------------");  
114.     trigger = (SimpleTrigger)TriggerBuilder.newTrigger().withIdentity("trigger7", "group1").startAt(startTime).withSchedule(SimpleScheduleBuilder.simpleSchedule().withIntervalInMinutes(5).withRepeatCount(20)).build();  
115.   
116.     ft = sched.rescheduleJob(trigger.getKey(), trigger);  
117.     log.info("job7 rescheduled to run at: " + ft);  
118.   
119.     log.info("------- Waiting five minutes... ------------");  
120.     try  
121.     {  
122.       Thread.sleep(300000L);  
123.     }  
124.     catch (Exception e)  
125.     {  
126.     }  
127.   
128.     log.info("------- Shutting Down ---------------------");  
129.   
130.     sched.shutdown(true);  
131.   
132.     log.info("------- Shutdown Complete -----------------");  
133.   
134.     SchedulerMetaData metaData = sched.getMetaData();  
135.     log.info("Executed " + metaData.getNumberOfJobsExecuted() + " jobs.");  
136.   }  
137.   
138.   public static void main(String[] args)  
139.     throws Exception  
140.   {  
141.     SimpleTriggerExample example = new SimpleTriggerExample();  
142.     example.run();  
143.   }  
144. }  

一个是所有的

该例子中出现了一个新的用法,一个schedule可以不指定触发器.而添加job后直接执行.sched.addJob(job, true); 以及重置任务sched.rescheduleJob(trigger.getKey(), trigger);

ScheduleBuilder  

用于循环调度任务,参数有调度次数,以及间隔时间,总共有四个实现类

SimpleScheduleBuilder,CalendarIntervalScheduleBuilder, CronScheduleBuilder, DailyTimeIntervalScheduleBuilder

example3 -  Cron Triggers

[java]  view plain copy print ?

1. package org.quartz.examples.example3;  
2.   
3. import java.util.Date;  
4. import org.quartz.CronScheduleBuilder;  
5. import org.quartz.CronTrigger;  
6. import org.quartz.JobBuilder;  
7. import org.quartz.JobDetail;  
8. import org.quartz.Scheduler;  
9. import org.quartz.SchedulerFactory;  
10. import org.quartz.SchedulerMetaData;  
11. import org.quartz.TriggerBuilder;  
12. import org.quartz.impl.StdSchedulerFactory;  
13. import org.slf4j.Logger;  
14. import org.slf4j.LoggerFactory;  
15.   
16. public class CronTriggerExample  
17. {  
18.   public void run()  
19.     throws Exception  
20.   {  
21.     Logger log = LoggerFactory.getLogger(CronTriggerExample.class);  
22.   
23.     log.info("------- 初始化 -------------------");  
24.   
25.     SchedulerFactory sf = new StdSchedulerFactory();  
26.     Scheduler sched = sf.getScheduler();  
27.   
28.     log.info("------- 初始化完毕 --------");  
29.   
30.     log.info("------- 开始调度任务 ----------------");  
31.     //创建一个group1.的job1的SimpleJob  
32.     JobDetail job = JobBuilder.newJob(SimpleJob.class).withIdentity("job1", "group1").build();  
33.     //创建一个用cron表达式的触发器(每分钟的 0 , 20 , 40秒的时候触发)  
34.     CronTrigger trigger = (CronTrigger)TriggerBuilder.newTrigger().withIdentity("trigger1", "group1").withSchedule(CronScheduleBuilder.cronSchedule("0/20 * * * * ?")).build();  
35.       
36.     Date ft = sched.scheduleJob(job, trigger);  
37.     log.info(job.getKey() + " has been scheduled to run at: " + ft + " and repeat based on expression: " + trigger.getCronExpression());  
38.     //创建一个group1下的名为job2的任务  
39.     job = JobBuilder.newJob(SimpleJob.class).withIdentity("job2", "group1").build();  
40.     //创建一个cron表达式的触发器  
41.     trigger = (CronTrigger)TriggerBuilder.newTrigger().withIdentity("trigger2", "group1").withSchedule(CronScheduleBuilder.cronSchedule("15 0/2 * * * ?")).build();  
42.   
43.     ft = sched.scheduleJob(job, trigger);  
44.     log.info(job.getKey() + " has been scheduled to run at: " + ft + " and repeat based on expression: " + trigger.getCronExpression());  
45.   
46.     job = JobBuilder.newJob(SimpleJob.class).withIdentity("job3", "group1").build();  
47.   
48.     trigger = (CronTrigger)TriggerBuilder.newTrigger().withIdentity("trigger3", "group1").withSchedule(CronScheduleBuilder.cronSchedule("0 0/2 8-17 * * ?")).build();  
49.   
50.     ft = sched.scheduleJob(job, trigger);  
51.     log.info(job.getKey() + " has been scheduled to run at: " + ft + " and repeat based on expression: " + trigger.getCronExpression());  
52.   
53.     job = JobBuilder.newJob(SimpleJob.class).withIdentity("job4", "group1").build();  
54.   
55.     trigger = (CronTrigger)TriggerBuilder.newTrigger().withIdentity("trigger4", "group1").withSchedule(CronScheduleBuilder.cronSchedule("0 0/3 17-23 * * ?")).build();  
56.   
57.     ft = sched.scheduleJob(job, trigger);  
58.     log.info(job.getKey() + " has been scheduled to run at: " + ft + " and repeat based on expression: " + trigger.getCronExpression());  
59.   
60.     job = JobBuilder.newJob(SimpleJob.class).withIdentity("job5", "group1").build();  
61.   
62.     trigger = (CronTrigger)TriggerBuilder.newTrigger().withIdentity("trigger5", "group1").withSchedule(CronScheduleBuilder.cronSchedule("0 0 10am 1,15 * ?")).build();  
63.   
64.     ft = sched.scheduleJob(job, trigger);  
65.     log.info(job.getKey() + " has been scheduled to run at: " + ft + " and repeat based on expression: " + trigger.getCronExpression());  
66.   
67.     job = JobBuilder.newJob(SimpleJob.class).withIdentity("job6", "group1").build();  
68.   
69.     trigger = (CronTrigger)TriggerBuilder.newTrigger().withIdentity("trigger6", "group1").withSchedule(CronScheduleBuilder.cronSchedule("0,30 * * ? * MON-FRI")).build();  
70.   
71.     ft = sched.scheduleJob(job, trigger);  
72.     log.info(job.getKey() + " has been scheduled to run at: " + ft + " and repeat based on expression: " + trigger.getCronExpression());  
73.   
74.     job = JobBuilder.newJob(SimpleJob.class).withIdentity("job7", "group1").build();  
75.   
76.     trigger = (CronTrigger)TriggerBuilder.newTrigger().withIdentity("trigger7", "group1").withSchedule(CronScheduleBuilder.cronSchedule("0,30 * * ? * SAT,SUN")).build();  
77.   
78.     ft = sched.scheduleJob(job, trigger);  
79.     log.info(job.getKey() + " has been scheduled to run at: " + ft + " and repeat based on expression: " + trigger.getCronExpression());  
80.   
81.     log.info("------- Starting Scheduler ----------------");  
82.   
83.     sched.start();  
84.   
85.     log.info("------- Started Scheduler -----------------");  
86.   
87.     log.info("------- Waiting five minutes... ------------");  
88.     try  
89.     {  
90.       Thread.sleep(300000L);  
91.     }  
92.     catch (Exception e)  
93.     {  
94.     }  
95.   
96.     log.info("------- Shutting Down ---------------------");  
97.   
98.     sched.shutdown(true);  
99.   
100.     log.info("------- Shutdown Complete -----------------");  
101.   
102.     SchedulerMetaData metaData = sched.getMetaData();  
103.     log.info("Executed " + metaData.getNumberOfJobsExecuted() + " jobs.");  
104.   }  
105.   
106.   public static void main(String[] args)  
107.     throws Exception  
108.   {  
109.     CronTriggerExample example = new CronTriggerExample();  
110.     example.run();  
111.   }  
112. }  

主要用的是CronScheduleBuilder.cronSchedule("0 0 10am 1,15 * ?") 这些cron表达式的用法.

example4 -  Job State and Job Parameters

example5 -  Job Misfires
example6 -  Handling Job Exceptions
example7 -  Interrupting Jobs
example8 -  How to use Quartz Calendars
example9 -  Using Job Listeners
example10 - Using Quartz Plug-Ins
example11 - Loading Up Quartz with Many Jobs
example12 - Remoting with Quartz using RMI
example13 - Clustering Quartz and JDBC Job Stores
example14 - Quartz Trigger Priorities
example15 - Clustering Quartz and Terracotta Job Store