综观目前的 Web 应用,多数应用都具备任务调度的功能。本文由浅入深介绍了几种任务调度的 Java 实现方法,包括 Timer,Scheduler, Quartz 以及 JCron Tab,并对其优缺点进行比较,目的在于给需要开发任务调度的程序员提供有价值的参考。

 

前言

任务调度是指基于给定时间点,给定时间间隔或者给定执行次数自动执行任务。本文由浅入深介绍四种任务调度的 Java 实现:

  • Timer
  • ScheduledExecutor
  • 开源工具包 Quartz
  • 开源工具包 JCronTab

此外,为结合实现复杂的任务调度,本文还将介绍 Calendar 的一些使用方法。

Timer

相信大家都已经非常熟悉 java.util.Timer 了,它是最简单的一种实现任务调度的方法,下面给出一个具体的例子:

01 package com.ibm.scheduler; 
02  import java.util.Timer; 
03  import java.util.TimerTask; 
04   
05  public class TimerTest extends TimerTask { 
06   
07  private String jobName = ""
08   
09  public TimerTest(String jobName) { 
10  super(); 
11  this.jobName = jobName; 
12  
13   
14  @Override 
15  public void run() { 
16  System.out.println("execute " + jobName); 
17  
18   
19  public static void main(String[] args) { 
20  Timer timer = new Timer(); 
21  long delay1 = 1 * 1000
22  long period1 = 1000
23  // 从现在开始 1 秒钟之后,每隔 1 秒钟执行一次 job1 
24  timer.schedule(new TimerTest("job1"), delay1, period1); 
25  long delay2 = 2 * 1000
26  long period2 = 2000
27  // 从现在开始 2 秒钟之后,每隔 2 秒钟执行一次 job2 
28  timer.schedule(new TimerTest("job2"), delay2, period2); 
29  
30  
31 /**
32  输出结果: 
33  execute job1 
34  execute job1 
35  execute job2 
36  execute job1 
37  execute job1 
38  execute job2 
39 */

 

使用 Timer 实现任务调度的核心类是 Timer 和 TimerTask。其中 Timer 负责设定 TimerTask 的起始与间隔执行时间。使用者只需要创建一个 TimerTask 的继承类,实现自己的 run 方法,然后将其丢给 Timer 去执行即可。

Timer 的设计核心是一个 TaskList 和一个 TaskThread。Timer 将接收到的任务丢到自己的 TaskList 中,TaskList 按照 Task 的最初执行时间进行排序。TimerThread 在创建 Timer 时会启动成为一个守护线程。这个线程会轮询所有任务,找到一个最近要执行的任务,然后休眠,当到达最近要执行任务的开始时间点,TimerThread 被唤醒并执行该任务。之后 TimerThread 更新最近一个要执行的任务,继续休眠。

Timer 的优点在于简单易用,但由于所有任务都是由同一个线程来调度,因此所有任务都是串行执行的,同一时间只能有一个任务在执行,前一个任务的延迟或异常都将会影响到之后的任务。

 

 

ScheduledExecutor

鉴于 Timer 的上述缺陷,Java 5 推出了基于线程池设计的 ScheduledExecutor。其设计思想是,每一个被调度的任务都会由线程池中一个线程去执行,因此任务是并发执行的,相互之间不会受到干扰。需 要注意的是,只有当任务的执行时间到来时,ScheduedExecutor 才会真正启动一个线程,其余时间 ScheduledExecutor 都是在轮询任务的状态。

01 package com.ibm.scheduler;
02 import java.util.concurrent.Executors;
03 import java.util.concurrent.ScheduledExecutorService;
04 import java.util.concurrent.TimeUnit;
05   
06 public class ScheduledExecutorTest implements Runnable {
07     private String jobName = "";
08   
09     public ScheduledExecutorTest(String jobName) {
10         super();
11         this.jobName = jobName;
12     }
13   
14     @Override
15     public void run() {
16         System.out.println("execute " + jobName);
17     }
18   
19     public static void main(String[] args) {
20         ScheduledExecutorService service = Executors.newScheduledThreadPool(10);
21   
22         long initialDelay1 = 1;
23         long period1 = 1;
24         // 从现在开始1秒钟之后,每隔1秒钟执行一次job1
25         service.scheduleAtFixedRate(
26                 new ScheduledExecutorTest("job1"), initialDelay1,
27                 period1, TimeUnit.SECONDS);
28   
29         long initialDelay2 = 1;
30         long delay2 = 1;
31         // 从现在开始2秒钟之后,每隔2秒钟执行一次job2
32         service.scheduleWithFixedDelay(
33                 new ScheduledExecutorTest("job2"), initialDelay2,
34                 delay2, TimeUnit.SECONDS);
35     }
36 }
37 /**
38 输出结果:
39 execute job1
40 execute job1
41 execute job2
42 execute job1
43 execute job1
44 execute job2
45 */

 

上面代码展示了 ScheduledExecutorService 中两种最常用的调度方法 ScheduleAtFixedRate 和 ScheduleWithFixedDelay。ScheduleAtFixedRate 每次执行时间为上一次任务开始起向后推一个时间间隔,即每次执行时间为 :initialDelay, initialDelay+period, initialDelay+2*period, …;ScheduleWithFixedDelay 每次执行时间为上一次任务结束起向后推一个时间间隔,即每次执行时间为:initialDelay, initialDelay+executeTime+delay, initialDelay+2*executeTime+2*delay。由此可见,ScheduleAtFixedRate 是基于固定时间间隔进行任务调度,ScheduleWithFixedDelay 取决于每次任务执行的时间长短,是基于不固定时间间隔进行任务调度。  

 

用 ScheduledExecutor 和 Calendar 实现复杂任务调度

Timer 和 ScheduledExecutor 都仅能提供基于开始时间与重复间隔的任务调度,不能胜任更加复杂的调度需求。比如,设置每星期二的 16:38:10 执行任务。该功能使用 Timer 和 ScheduledExecutor 都不能直接实现,但我们可以借助 Calendar 间接实现该功能。

001 package com.ibm.scheduler;
002   
003 import java.util.Calendar;
004 import java.util.Date;
005 import java.util.TimerTask;
006 import java.util.concurrent.Executors;
007 import java.util.concurrent.ScheduledExecutorService;
008 import java.util.concurrent.TimeUnit;
009   
010 public class ScheduledExceutorTest2 extends TimerTask {
011   
012     private String jobName = "";
013   
014     public ScheduledExceutorTest2(String jobName) {
015         super();
016         this.jobName = jobName;
017     }
018   
019     @Override
020     public void run() {
021         System.out.println("Date = "+new Date()+", execute " + jobName);
022     }
023   
024     /**
025      * 计算从当前时间currentDate开始,满足条件dayOfWeek, hourOfDay, 
026      * minuteOfHour, secondOfMinite的最近时间
027      * @return
028      */
029     public Calendar getEarliestDate(Calendar currentDate, int dayOfWeek,
030             int hourOfDay, int minuteOfHour, int secondOfMinite) {
031         //计算当前时间的WEEK_OF_YEAR,DAY_OF_WEEK, HOUR_OF_DAY, MINUTE,SECOND等各个字段值
032         int currentWeekOfYear = currentDate.get(Calendar.WEEK_OF_YEAR);
033         int currentDayOfWeek = currentDate.get(Calendar.DAY_OF_WEEK);
034         int currentHour = currentDate.get(Calendar.HOUR_OF_DAY);
035         int currentMinute = currentDate.get(Calendar.MINUTE);
036         int currentSecond = currentDate.get(Calendar.SECOND);
037   
038         //如果输入条件中的dayOfWeek小于当前日期的dayOfWeek,则WEEK_OF_YEAR需要推迟一周
039         boolean weekLater = false;
040         if (dayOfWeek < currentDayOfWeek) {
041             weekLater = true;
042         } else if (dayOfWeek == currentDayOfWeek) {
043             //当输入条件与当前日期的dayOfWeek相等时,如果输入条件中的
044             //hourOfDay小于当前日期的
045             //currentHour,则WEEK_OF_YEAR需要推迟一周   
046             if (hourOfDay < currentHour) {
047                 weekLater = true;
048             } else if (hourOfDay == currentHour) {
049                  //当输入条件与当前日期的dayOfWeek, hourOfDay相等时,
050                  //如果输入条件中的minuteOfHour小于当前日期的
051                 //currentMinute,则WEEK_OF_YEAR需要推迟一周
052                 if (minuteOfHour < currentMinute) {
053                     weekLater = true;
054                 } else if (minuteOfHour == currentSecond) {
055                      //当输入条件与当前日期的dayOfWeek, hourOfDay, 
056                      //minuteOfHour相等时,如果输入条件中的
057                     //secondOfMinite小于当前日期的currentSecond,
058                     //则WEEK_OF_YEAR需要推迟一周
059                     if (secondOfMinite < currentSecond) {
060                         weekLater = true;
061                     }
062                 }
063             }
064         }
065         if (weekLater) {
066             //设置当前日期中的WEEK_OF_YEAR为当前周推迟一周
067             currentDate.set(Calendar.WEEK_OF_YEAR, currentWeekOfYear + 1);
068         }
069         // 设置当前日期中的DAY_OF_WEEK,HOUR_OF_DAY,MINUTE,SECOND为输入条件中的值。
070         currentDate.set(Calendar.DAY_OF_WEEK, dayOfWeek);
071         currentDate.set(Calendar.HOUR_OF_DAY, hourOfDay);
072         currentDate.set(Calendar.MINUTE, minuteOfHour);
073         currentDate.set(Calendar.SECOND, secondOfMinite);
074         return currentDate;
075   
076     }
077   
078     public static void main(String[] args) throws Exception {
079   
080         ScheduledExceutorTest2 test = new ScheduledExceutorTest2("job1");
081         //获取当前时间
082         Calendar currentDate = Calendar.getInstance();
083         long currentDateLong = currentDate.getTime().getTime();
084         System.out.println("Current Date = " + currentDate.getTime().toString());
085         //计算满足条件的最近一次执行时间
086         Calendar earliestDate = test
087                 .getEarliestDate(currentDate, 3, 16, 38, 10);
088         long earliestDateLong = earliestDate.getTime().getTime();
089         System.out.println("Earliest Date = "
090                 + earliestDate.getTime().toString());
091         //计算从当前时间到最近一次执行时间的时间间隔
092         long delay = earliestDateLong - currentDateLong;
093         //计算执行周期为一星期
094         long period = 7 * 24 * 60 * 60 * 1000;
095         ScheduledExecutorService service = Executors.newScheduledThreadPool(10);
096         //从现在开始delay毫秒之后,每隔一星期执行一次job1
097         service.scheduleAtFixedRate(test, delay, period,
098                 TimeUnit.MILLISECONDS);
099   
100     }
101
102 /**
103 输出结果:
104 Current Date = Wed Feb 02 17:32:01 CST 2011
105 Earliest Date = Tue Feb 8 16:38:10 CST 2011
106 Date = Tue Feb 8 16:38:10 CST 2011, execute job1
107 Date = Tue Feb 15 16:38:10 CST 2011, execute job1
108 */

 

清单 3 实现了每星期二 16:38:10 调度任务的功能。其核心在于根据当前时间推算出最近一个星期二 16:38:10 的绝对时间,然后计算与当前时间的时间差,作为调用 ScheduledExceutor 函数的参数。计算最近时间要用到 java.util.calendar 的功能。首先需要解释 calendar 的一些设计思想。Calendar 有以下几种唯一标识一个日期的组合方式:

 YEAR + MONTH + DAY_OF_MONTH 
 YEAR + MONTH + WEEK_OF_MONTH + DAY_OF_WEEK 
 YEAR + MONTH + DAY_OF_WEEK_IN_MONTH + DAY_OF_WEEK 
 YEAR + DAY_OF_YEAR 
 YEAR + DAY_OF_WEEK + WEEK_OF_YEAR 

上述组合分别加上 HOUR_OF_DAY + MINUTE + SECOND 即为一个完整的时间标识。本例采用了最后一种组合方式。输入为 DAY_OF_WEEK, HOUR_OF_DAY, MINUTE, SECOND 以及当前日期 , 输出为一个满足 DAY_OF_WEEK, HOUR_OF_DAY, MINUTE, SECOND 并且距离当前日期最近的未来日期。计算的原则是从输入的 DAY_OF_WEEK 开始比较,如果小于当前日期的 DAY_OF_WEEK,则需要向 WEEK_OF_YEAR 进一, 即将当前日期中的 WEEK_OF_YEAR 加一并覆盖旧值;如果等于当前的 DAY_OF_WEEK, 则继续比较 HOUR_OF_DAY;如果大于当前的 DAY_OF_WEEK,则直接调用 java.util.calenda 的 calendar.set(field, value) 函数将当前日期的 DAY_OF_WEEK, HOUR_OF_DAY, MINUTE, SECOND 赋值为输入值,依次类推,直到比较至 SECOND。读者可以根据输入需求选择不同的组合方式来计算最近执行时间。

可以看出,用上述方法实现该任务调度比较麻烦,这就需要一个更加完善的任务调度框架来解决这些复杂的调度问题。幸运的是,开源工具包 Quartz 与 JCronTab 提供了这方面强大的支持。

 

 

Quartz

Quartz 可以满足更多更复杂的调度需求,首先让我们看看如何用 Quartz 实现每星期二 16:38 的调度安排:

01 package com.ibm.scheduler;
02 import java.util.Date;
03   
04 import org.quartz.Job;
05 import org.quartz.JobDetail;
06 import org.quartz.JobExecutionContext;
07 import org.quartz.JobExecutionException;
08 import org.quartz.Scheduler;
09 import org.quartz.SchedulerFactory;
10 import org.quartz.Trigger;
11 import org.quartz.helpers.TriggerUtils;
12   
13 public class QuartzTest implements Job {
14   
15     @Override
16     //该方法实现需要执行的任务
17     public void execute(JobExecutionContext arg0) throws JobExecutionException {
18         System.out.println("Generating report - "
19                 + arg0.getJobDetail().getFullName() + ", type ="
20                 + arg0.getJobDetail().getJobDataMap().get("type"));
21         System.out.println(new Date().toString());
22     }
23     public static void main(String[] args) {
24         try {
25             // 创建一个Scheduler
26             SchedulerFactory schedFact = 
27             new org.quartz.impl.StdSchedulerFactory();
28             Scheduler sched = schedFact.getScheduler();
29             sched.start();
30             // 创建一个JobDetail,指明name,groupname,以及具体的Job类名,
31             //该Job负责定义需要执行任务
32             JobDetail jobDetail = new JobDetail("myJob", "myJobGroup",
33                     QuartzTest.class);
34             jobDetail.getJobDataMap().put("type", "FULL");
35             // 创建一个每周触发的Trigger,指明星期几几点几分执行
36             Trigger trigger = TriggerUtils.makeWeeklyTrigger(3, 16, 38);
37             trigger.setGroup("myTriggerGroup");
38             // 从当前时间的下一秒开始执行
39             trigger.setStartTime(TriggerUtils.getEvenSecondDate(new Date()));
40             // 指明trigger的name
41             trigger.setName("myTrigger");
42             // 用scheduler将JobDetail与Trigger关联在一起,开始调度任务
43             sched.scheduleJob(jobDetail, trigger);
44   
45         } catch (Exception e) {
46             e.printStackTrace();
47         }
48     }
49
50 /**
51 输出结果:
52 Generating report - myJobGroup.myJob, type =FULL
53 Tue Feb 8 16:38:00 CST 2011
54 Generating report - myJobGroup.myJob, type =FUL
55 Tue Feb 15 16:38:00 CST 2011
56 */

 

清单 4 非常简洁地实现了一个上述复杂的任务调度。Quartz 设计的核心类包括 Scheduler, Job 以及 Trigger。其中,Job 负责定义需要执行的任务,Trigger 负责设置调度策略,Scheduler 将二者组装在一起,并触发任务开始执行。

Job

使用者只需要创建一个 Job 的继承类,实现 execute 方法。JobDetail 负责封装 Job 以及 Job 的属性,并将其提供给 Scheduler 作为参数。每次 Scheduler 执行任务时,首先会创建一个 Job 的实例,然后再调用 execute 方法执行。Quartz 没有为 Job 设计带参数的构造函数,因此需要通过额外的 JobDataMap 来存储 Job 的属性。JobDataMap 可以存储任意数量的 Key,Value 对,例如:

1 jobDetail.getJobDataMap().put("myDescription", "my job description"); 
2 jobDetail.getJobDataMap().put("myValue", 1998); 
3 ArrayList<String> list = new ArrayList<String>(); 
4 list.add("item1"); 
5 jobDetail.getJobDataMap().put("myArray", list);

 

JobDataMap 中的数据可以通过下面的方式获取:
01 public class JobDataMapTest implements Job {
02   
03     @Override
04     public void execute(JobExecutionContext context)
05             throws JobExecutionException {
06         //从context中获取instName,groupName以及dataMap
07         String instName = context.getJobDetail().getName();
08         String groupName = context.getJobDetail().getGroup();
09         JobDataMap dataMap = context.getJobDetail().getJobDataMap();
10         //从dataMap中获取myDescription,myValue以及myArray
11         String myDescription = dataMap.getString("myDescription");
12         int myValue = dataMap.getInt("myValue");
13         ArrayList<String> myArray = (ArrayListlt;Strin>) dataMap.get("myArray");
14         System.out.println("
15                 Instance =" + instName + ", group = " + groupName
16                 + ", description = " + myDescription + ", value =" + myValue
17                 + ", array item0 = " + myArray.get(0));
18   
19     }
20 }
21 /**
22 输出结果:
23 Instance = myJob, group = myJobGroup, 
24 description = my job description, 
25 value =1998, array item0 = item1
26 */

 

Trigger

Trigger 的作用是设置调度策略。Quartz 设计了多种类型的 Trigger,其中最常用的是 SimpleTrigger 和 CronTrigger。

SimpleTrigger 适用于在某一特定的时间执行一次,或者在某一特定的时间以某一特定时间间隔执行多次。上述功能决定了 SimpleTrigger 的参数包括 start-time, end-time, repeat count, 以及 repeat interval。

Repeat count 取值为大于或等于零的整数,或者常量 SimpleTrigger.REPEAT_INDEFINITELY。

Repeat interval 取值为大于或等于零的长整型。当 Repeat interval 取值为零并且 Repeat count 取值大于零时,将会触发任务的并发执行。

Start-time 与 dnd-time 取值为 java.util.Date。当同时指定 end-time 与 repeat count 时,优先考虑 end-time。一般地,可以指定 end-time,并设定 repeat count 为 REPEAT_INDEFINITELY。

以下是 SimpleTrigger 的构造方法:

 public SimpleTrigger(String name, 
                       String group, 
                       Date startTime, 
                       Date endTime, 
                       int repeatCount, 
                       long repeatInterval) 

举例如下:

创建一个立即执行且仅执行一次的 SimpleTrigger:

1 SimpleTrigger trigger=
2  new SimpleTrigger("myTrigger", "myGroup", new Date(), null, 0, 0L);

创建一个半分钟后开始执行,且每隔一分钟重复执行一次的 SimpleTrigger:

1 SimpleTrigger trigger=
2  new SimpleTrigger("myTrigger", "myGroup"
3     new Date(System.currentTimeMillis()+30*1000), null, 0, 60*1000);

创建一个 2011 年 6 月 1 日 8:30 开始执行,每隔一小时执行一次,一共执行一百次,一天之后截止的 SimpleTrigger:

01 Calendar calendar = Calendar.getInstance(); 
02 calendar.set(Calendar.YEAR, 2011); 
03 calendar.set(Calendar.MONTH, Calendar.JUNE); 
04 calendar.set(Calendar.DAY_OF_MONTH, 1); 
05 calendar.set(Calendar.HOUR, 8); 
06 calendar.set(Calendar.MINUTE, 30); 
07 calendar.set(Calendar.SECOND, 0); 
08 calendar.set(Calendar.MILLISECOND, 0); 
09 Date startTime = calendar.getTime(); 
10 Date endTime = new Date (calendar.getTimeInMillis() +24*60*60*1000); 
11 SimpleTrigger trigger=new SimpleTrigger("myTrigger"
12        "myGroup", startTime, endTime, 100, 60*60*1000);

上述最后一个例子中,同时设置了 end-time 与 repeat count,则优先考虑 end-time,总共可以执行二十四次。

CronTrigger 的用途更广,相比基于特定时间间隔进行调度安排的 SimpleTrigger,CronTrigger 主要适用于基于日历的调度安排。例如:每星期二的 16:38:10 执行,每月一号执行,以及更复杂的调度安排等。

CronTrigger 同样需要指定 start-time 和 end-time,其核心在于 Cron 表达式,由七个字段组成:

 Seconds 
 Minutes 
 Hours 
 Day-of-Month 
 Month 
 Day-of-Week 
 Year (Optional field) 

举例如下:

创建一个每三小时执行的 CronTrigger,且从每小时的整点开始执行:

 0 0 0/3  * * ? 

创建一个每十分钟执行的 CronTrigger,且从每小时的第三分钟开始执行:

 0 3/10 * * * ? 

创建一个每周一,周二,周三,周六的晚上 20:00 到 23:00,每半小时执行一次的 CronTrigger:

 0 0/30 20-23 ? * MON-WED,SAT 

创建一个每月最后一个周四,中午 11:30-14:30,每小时执行一次的 trigger:

 0 30 11-14/1 ? * 5L 

解释一下上述例子中各符号的含义:

首先所有字段都有自己特定的取值,例如,Seconds 和 Minutes 取值为 0 到 59,Hours 取值为 0 到 23,Day-of-Month 取值为 0-31, Month 取值为 0-11,或者 JAN,FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC,Days-of-Week 取值为 1-7 或者 SUN, MON, TUE, WED, THU, FRI, SAT。每个字段可以取单个值,多个值,或一个范围,例如 Day-of-Week 可取值为“MON,TUE,SAT”,“MON-FRI”或者“TUE-THU,SUN”。

通配符 * 表示该字段可接受任何可能取值。例如 Month 字段赋值 * 表示每个月,Day-of-Week 字段赋值 * 表示一周的每天。

/ 表示开始时刻与间隔时段。例如 Minutes 字段赋值 2/10 表示在一个小时内每 20 分钟执行一次,从第 2 分钟开始。

? 仅适用于 Day-of-Month 和 Day-of-Week。? 表示对该字段不指定特定值。适用于需要对这两个字段中的其中一个指定值,而对另一个不指定值的情况。一般情况下,这两个字段只需对一个赋值。

L 仅适用于 Day-of-Month 和 Day-of-Week。L 用于 Day-of-Month 表示该月最后一天。L 单独用于 Day-of-Week 表示周六,否则表示一个月最后一个星期几,例如 5L 或者 THUL 表示该月最后一个星期四。

W 仅适用于 Day-of-Month,表示离指定日期最近的一个工作日,例如 Day-of-Month 赋值为 10W 表示该月离 10 号最近的一个工作日。

# 仅适用于 Day-of-Week,表示该月第 XXX 个星期几。例如 Day-of-Week 赋值为 5#2 或者 THU#2,表示该月第二个星期四。

CronTrigger 的使用如下:

 CronTrigger cronTrigger = new CronTrigger("myTrigger", "myGroup"); 
 try { 
     cronTrigger.setCronExpression("0 0/30 20-13 ? * MON-WED,SAT"); 
 } catch (Exception e) { 
     e.printStackTrace(); 
 } 

Job 与 Trigger 的松耦合设计是 Quartz 的一大特点,其优点在于同一个 Job 可以绑定多个不同的 Trigger,同一个 Trigger 也可以调度多个 Job,灵活性很强。

Listener

除了上述基本的调度功能,Quartz 还提供了 listener 的功能。主要包含三种 listener:JobListener,TriggerListener 以及 SchedulerListener。当系统发生故障,相关人员需要被通知时,Listener 便能发挥它的作用。最常见的情况是,当任务被执行时,系统发生故障,Listener 监听到错误,立即发送邮件给管理员。下面给出 JobListener 的实例:


清单 7. JobListener 的实现
				 
 import org.quartz.JobExecutionContext;
import org.quartz.JobExecutionException;
import org.quartz.JobListener;
import org.quartz.SchedulerException;


public class MyListener implements JobListener{

	@Override
	public String getName() {
		return "My Listener";
	}
	@Override
	public void jobWasExecuted(JobExecutionContext context,
			JobExecutionException jobException) {
		if(jobException != null){
			try {
				//停止Scheduler
				context.getScheduler().shutdown();
				System.out.println("
                Error occurs when executing jobs, shut down the scheduler ");
                // 给管理员发送邮件…
			} catch (SchedulerException e) {
				e.printStackTrace();
			}
		}
	}
}

从清单 7 可以看出,使用者只需要创建一个 JobListener 的继承类,重载需要触发的方法即可。当然,需要将 listener 的实现类注册到 Scheduler 和 JobDetail 中:

 sched.addJobListener(new MyListener()); 
 jobDetail.addJobListener("My Listener"); // listener 的名字

使用者也可以将 listener 注册为全局 listener,这样便可以监听 scheduler 中注册的所有任务 :

 sched.addGlobalJobListener(new MyListener()); 

为了测试 listener 的功能,可以在 job 的 execute 方法中强制抛出异常。清单 7 中,listener 接收到异常,将 job 所在的 scheduler 停掉,阻止后续的 job 继续执行。scheduler、jobDetail 等信息都可以从 listener 的参数 context 中检索到。

清单 7 的输出结果为:

 Generating report - myJob.myJob, type =FULL 
 Tue Feb 15 18:57:35 CST 2011 
 2011-2-15 18:57:35 org.quartz.core.JobRunShell run 
信息 : Job myJob.myJob threw a JobExecutionException: 
 org.quartz.JobExecutionException 
 at com.ibm.scheduler.QuartzListenerTest.execute(QuartzListenerTest.java:22) 
 at org.quartz.core.JobRunShell.run(JobRunShell.java:191) 
 at org.quartz.simpl.SimpleThreadPool$WorkerThread.run(SimpleThreadPool.java:516) 
 2011-2-15 18:57:35 org.quartz.core.QuartzScheduler shutdown 
信息 : Scheduler DefaultQuartzScheduler_$_NON_CLUSTERED shutting down. 
 Error occurs when executing jobs, shut down the scheduler 

TriggerListener、SchedulerListener 与 JobListener 有类似的功能,只是各自触发的事件不同,如 JobListener 触发的事件为:

Job to be executed, Job has completed execution 等

TriggerListener 触发的事件为:

Trigger firings, trigger mis-firings, trigger completions 等

SchedulerListener 触发的事件为:

add a job/trigger, remove a job/trigger, shutdown a scheduler 等

读者可以根据自己的需求重载相应的事件。

JobStores

Quartz 的另一显著优点在于持久化,即将任务调度的相关数据保存下来。这样,当系统重启后,任务被调度的状态依然存在于系统中,不会丢失。默认情况 下,Quartz 采用的是 org.quartz.simpl.RAMJobStore,在这种情况下,数据仅能保存在内存中,系统重启后会全部丢失。若想持久化数据,需要采用 org.quartz.simpl.JDBCJobStoreTX。

实现持久化的第一步,是要创建 Quartz 持久化所需要的表格。在 Quartz 的发布包 docs/dbTables 中可以找到相应的表格创建脚本。Quartz 支持目前大部分流行的数据库。本文以 DB2 为例,所需要的脚本为 tables_db2.sql。首先需要对脚本做一点小的修改,即在开头指明 Schema:

 SET CURRENT SCHEMA quartz; 

为了方便重复使用 , 创建表格前首先删除之前的表格:
drop table qrtz_job_details;

 drop table qrtz_job_listeners; 

然后创建数据库 sched,执行 tables_db2.sql 创建持久化所需要的表格。

第二步,配置数据源。数据源与其它所有配置,例如 ThreadPool,均放在 quartz.properties 里:


清单 8. Quartz 配置文件
				 
 # Configure ThreadPool 
 org.quartz.threadPool.class = org.quartz.simpl.SimpleThreadPool 
 org.quartz.threadPool.threadCount =  5 
 org.quartz.threadPool.threadPriority = 4 

 # Configure Datasources 
 org.quartz.jobStore.class = org.quartz.impl.jdbcjobstore.JobStoreTX 
 org.quartz.jobStore.driverDelegateClass = org.quartz.impl.jdbcjobstore.StdJDBCDelegate 
 org.quartz.jobStore.dataSource = db2DS 
 org.quartz.jobStore.tablePrefix = QRTZ_ 

 org.quartz.dataSource.db2DS.driver = com.ibm.db2.jcc.DB2Driver 
 org.quartz.dataSource.db2DS.URL = jdbc:db2://localhost:50001/sched 
 org.quartz.dataSource.db2DS.user = quartz 
 org.quartz.dataSource.db2DS.password = passw0rd 
 org.quartz.dataSource.db2DS.maxConnections = 5 

使用时只需要将 quatz.properties 放在 classpath 下面,不用更改一行代码,再次运行之前的任务调度实例,trigger、job 等信息便会被记录在数据库中。

将清单 4 中的 makeWeeklyTrigger 改成 makeSecondlyTrigger,重新运行 main 函数,在 sched 数据库中查询表 qrtz_simple_triggers 中的数据。其查询语句为“db2 ‘ select repeat_interval, times_triggered from qrtz_simple_triggers ’”。结果 repeat_interval 为 1000,与程序中设置的 makeSecondlyTrigger 相吻合,times_triggered 值为 21。

停掉程序,将数据库中记录的任务调度数据重新导入程序运行:

01 package com.ibm.scheduler; 
02 import org.quartz.Scheduler; 
03 import org.quartz.SchedulerException; 
04 import org.quartz.SchedulerFactory; 
05 import org.quartz.Trigger; 
06 import org.quartz.impl.StdSchedulerFactory; 
07  
08 public class QuartzReschedulerTest { 
09 public static void main(String[] args) throws SchedulerException { 
10 // 初始化一个 Schedule Factory 
11 SchedulerFactory schedulerFactory = new StdSchedulerFactory(); 
12 // 从 schedule factory 中获取 scheduler 
13 Scheduler scheduler = schedulerFactory.getScheduler(); 
14 // 从 schedule factory 中获取 trigger 
15 Trigger trigger = scheduler.getTrigger("myTrigger", "myTriggerGroup"); 
16 // 重新开启调度任务
17 scheduler.rescheduleJob("myTrigger", "myTriggerGroup", trigger); 
18 scheduler.start(); 
19
20 }

 

 

上面代码中,schedulerFactory.getScheduler() 将 quartz.properties 的内容加载到内存,然后根据数据源的属性初始化数据库的链接,并将数据库中存储的数据加载到内存。之后,便可以在内存中查询某一具体的 trigger,并将其重新启动。这时候重新查询 qrtz_simple_triggers 中的数据,发现 times_triggered 值比原来增长了。

 

 

JCronTab

习惯使用 unix/linux 的开发人员应该对 crontab 都不陌生。Crontab 是一个非常方便的用于 unix/linux 系统的任务调度命令。JCronTab 则是一款完全按照 crontab 语法编写的 java 任务调度工具。

首先简单介绍一下 crontab 的语法,与上面介绍的 Quartz 非常相似,但更加简洁 , 集中了最常用的语法。主要由六个字段组成(括弧中标识了每个字段的取值范围):

 Minutes (0-59)
 Hours   (0-23) 
 Day-of-Month (1-31)
 Month    (1-12/JAN-DEC) 
 Day-of-Week  (0-6/SUN-SAT)
 Command 

与 Quartz 相比,省略了 Seconds 与 Year,多了一个 command 字段,即为将要被调度的命令。JCronTab 中也包含符号“*”与“/”, 其含义与 Quartz 相同。

举例如下:

每天 12 点到 15 点 , 每隔 1 小时执行一次 Date 命令:

 0 12-15/1 * * * Date 

每月 2 号凌晨 1 点发一封信给 zhjingbj@cn.ibm.com:

 0 1 2 * * mail -s “good” zhjingbj@cn.ibm.com 

每周一,周二,周三,周六的晚上 20:00 到 23:00,每半小时打印“normal”:

 0/30 20-23 * * MON-WED,SAT echo “normal”

JCronTab 借鉴了 crontab 的语法,其区别在于 command 不再是 unix/linux 的命令,而是一个 Java 类。如果该类带参数,例如“com.ibm.scheduler.JCronTask2#run”,则定期执行 run 方法;如果该类不带参数,则默认执行 main 方法。此外,还可以传参数给 main 方法或者构造函数,例如“com.ibm.scheduler.JCronTask2#run Hello World“表示传两个参数 Hello 和 World 给构造函数。

JCronTab 与 Quartz 相比,其优点在于,第一,支持多种任务调度的持久化方法,包括普通文件、数据库以及 XML 文件进行持久化;第二,JCronTab 能够非常方便地与 Web 应用服务器相结合,任务调度可以随 Web 应用服务器的启动自动启动;第三,JCronTab 还内置了发邮件功能,可以将任务执行结果方便地发送给需要被通知的人。

JCronTab 与 Web 应用服务器的结合非常简单,只需要在 Web 应用程序的 web.xml 中添加如下行:

01 <servlet
02    <servlet-name>LoadOnStartupServlet</servlet-name
03    <servlet-class>org.jcrontab.web.loadCrontabServlet</servlet-class
04    <init-param
05  <param-name>PROPERTIES_FILE</param-name
06  <param-value>D:/Scheduler/src/jcrontab.properties</param-value
07    </init-param
08    <load-on-startup>1</load-on-startup
09  </servlet
10  <!-- Mapping of the StartUp Servlet --> 
11  <servlet-mapping
12    <servlet-name>LoadOnStartupServlet</servlet-name
13  <url-pattern>/Startup</url-pattern
14  </servlet-mapping>

 

在清单 10 中,需要注意两点:第一,必须指定 servlet-class 为 org.jcrontab.web.loadCrontabServlet,因为它是整个任务调度的入口;第二,必须指定一个参数为 PROPERTIES_FILE,才能被 loadCrontabServlet 识别。

接下来,需要撰写 D:/Scheduler/src/jcrontab.properties 的内容,其内容根据需求的不同而改变。

当采用普通文件持久化时,jcrontab.properties 的内容主要包括:

 org.jcrontab.data.file = D:/Scheduler/src/crontab 
 org.jcrontab.data.datasource = org.jcrontab.data.FileSource 

其中数据来源 org.jcrontab.data.datasource 被描述为普通文件,即 org.jcrontab.data.FileSource。具体的文件即 org.jcrontab.data.file 指明为 D:/Scheduler/src/crontab。

Crontab 描述了任务的调度安排:

 */2 * * * * com.ibm.scheduler.JCronTask1 
 * * * * * com.ibm.scheduler.JCronTask2#run Hello World 

其中包含了两条任务的调度,分别是每两分钟执行一次 JCronTask1 的 main 方法,每一分钟执行一次 JCronTask2 的 run 方法。

01 package com.ibm.scheduler;
02   
03 import java.util.Date;
04   
05 public class JCronTask1 {
06   
07     private static int count = 0;
08   
09     public static void main(String[] args) {
10         System.out.println("--------------Task1-----------------");
11         System.out.println("Current Time = " + new Date() + ", Count = "
12                 + count++);
13     }
14 }
15   
16 package com.ibm.scheduler;
17   
18 import java.util.Date;
19   
20 public class JCronTask2 implements Runnable {
21   
22     private static int count = 0;
23   
24     private static String[] args;
25   
26     public JCronTask2(String[] args) {
27         System.out.println("--------------Task2-----------------");
28         System.out.println("Current Time = " + new Date() + ", Count = "
29                 + count++);
30         JCronTask2.args = args;
31     }
32   
33     @Override
34     public void run() {
35         System.out.println("enter into run method");
36         if (args != null && args.length > 0) {
37             for (int i = 0; i < args.length; i++) {
38          System.out.print("This is arg " + i + " " + args[i] + "\n");
39             }
40         }
41     }
42 }

 

 

到此为止,基于普通文件持久化的 JCronTab 的实例就全部配置好了。启动 Web 应用服务器,便可以看到任务调度的输出结果:
 --------------Task2----------------- 
 Current Time = Tue Feb 15 09:22:00 CST 2011, Count = 0 
 enter into run method 
 This is arg 0 Hello 
 This is arg 1 World 
 --------------Task1----------------- 
 Current Time = Tue Feb 15 09:22:00 CST 2011, Count = 0 
 --------------Task2----------------- 
 Current Time = Tue Feb 15 09:23:00 CST 2011, Count = 1 
 enter into run method 
 This is arg 0 Hello 
 This is arg 1 World 
 --------------Task2----------------- 
 Current Time = Tue Feb 15 09:24:00 CST 2011, Count = 2 
 enter into run method 
 This is arg 0 Hello 
 This is arg 1 World 
 --------------Task1----------------- 
 Current Time = Tue Feb 15 09:24:00 CST 2011, Count = 1 

通过修改 jcrontab.properties 中 datasource,可以选择采用数据库或 xml 文件持久化,感兴趣的读者可以参考 进阶学习 JCronTab

此外,JCronTab 还内置了发邮件功能,可以将任务执行结果方便地发送给需要被通知的人。其配置非常简单,只需要在 jcontab.properties 中添加几行配置即可:

 org.jcrontab.sendMail.to= Ther email you want to send to 
 org.jcrontab.sendMail.from=The email you want to send from 
 org.jcrontab.sendMail.smtp.host=smtp server 
 org.jcrontab.sendMail.smtp.user=smtp username 
 org.jcrontab.sendMail.smtp.password=smtp password 

结束语

本文介绍了四种常用的对任务进行调度的 Java 实现方法,即 Timer,ScheduledExecutor, Quartz 以及 JCronTab。文本对每种方法都进行了实例解释,并对其优缺点进行比较。对于简单的基于起始时间点与时间间隔的任务调度,使用 Timer 就足够了;如果需要同时调度多个任务,基于线程池的 ScheduledTimer 是更为合适的选择;当任务调度的策略复杂到难以凭借起始时间点与时间间隔来描述时,Quartz 与 JCronTab 则体现出它们的优势。熟悉 Unix/Linux 的开发人员更倾向于 JCronTab,且 JCronTab 更适合与 Web 应用服务器相结合。Quartz 的 Trigger 与 Job 松耦合设计使其更适用于 Job 与 Trigger 的多对多应用场景。

原文转自:IBM developerWorks