天天看點

推薦幾種Java任務排程的實作幾種任務排程的 Java 實作方法與比較--轉載

幾種任務排程的 Java 實作方法與比較--轉載

原文:http://www.ibm.com/developerworks/cn/java/j-lo-taskschedule/

寫了一天的作業排程,這算是最好的一篇了

前言

任務排程是指基于給定時間點,給定時間間隔或者給定執行次數自動執行任務。本文由淺入深介紹四種任務排程的 Java 實作:

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

此外,為結合實作複雜的任務排程,本文還将介紹 Calendar 的一些使用方法。

http://www.ibm.com/developerworks/cn/java/j-lo-taskschedule/#ibm-pcon

相信大家都已經非常熟悉 java.util.Timer 了,它是最簡單的一種實作任務排程的方法,下面給出一個具體的例子:

清單 1. 使用 Timer 進行任務排程
package com.ibm.scheduler; 
 import java.util.Timer; 
 import java.util.TimerTask; 

 public class TimerTest extends TimerTask { 

 private String jobName = ""; 

 public TimerTest(String jobName) { 
 super(); 
 this.jobName = jobName; 
 } 

 @Override 
 public void run() { 
 System.out.println("execute " + jobName); 
 } 

 public static void main(String[] args) { 
 Timer timer = new Timer(); 
 long delay1 = 1 * 1000; 
 long period1 = 1000; 
 // 從現在開始 1 秒鐘之後,每隔 1 秒鐘執行一次 job1 
 timer.schedule(new TimerTest("job1"), delay1, period1); 
 long delay2 = 2 * 1000; 
 long period2 = 2000; 
 // 從現在開始 2 秒鐘之後,每隔 2 秒鐘執行一次 job2 
 timer.schedule(new TimerTest("job2"), delay2, period2); 
 } 
 } 
 Output: 
 execute job1 
 execute job1 
 execute job2 
 execute job1 
 execute job1 
 execute job2      

使用 Timer 實作任務排程的核心類是 Timer 和 TimerTask。其中 Timer 負責設定 TimerTask 的起始與間隔執行時間。使用者隻需要建立一個 TimerTask 的繼承類,實作自己的 run 方法,然後将其丢給 Timer 去執行即可。

Timer 的設計核心是一個 TaskList 和一個 TaskThread。Timer 将接收到的任務丢到自己的 TaskList 中,TaskList 按照 Task 的最初執行時間進行排序。TimerThread 在建立 Timer 時會啟動成為一個守護線程。這個線程會輪詢所有任務,找到一個最近要執行的任務,然後休眠,當到達最近要執行任務的開始時間點,TimerThread 被喚醒并執行該任務。之後 TimerThread 更新最近一個要執行的任務,繼續休眠。

Timer 的優點在于簡單易用,但由于所有任務都是由同一個線程來排程,是以所有任務都是串行執行的,同一時間隻能有一個任務在執行,前一個任務的延遲或異常都将會影響到之後的任務。

http://www.ibm.com/developerworks/cn/java/j-lo-taskschedule/#ibm-pcon

鑒于 Timer 的上述缺陷,Java 5 推出了基于線程池設計的 ScheduledExecutor。其設計思想是,每一個被排程的任務都會由線程池中一個線程去執行,是以任務是并發執行的,互相之間不會受到幹擾。需要注意的是,隻有當任務的執行時間到來時,ScheduedExecutor 才會真正啟動一個線程,其餘時間 ScheduledExecutor 都是在輪詢任務的狀态。

清單 2. 使用 ScheduledExecutor 進行任務排程
package com.ibm.scheduler;
import java.util.concurrent.Executors;
import java.util.concurrent.ScheduledExecutorService;
import java.util.concurrent.TimeUnit;

public class ScheduledExecutorTest implements Runnable {
	private String jobName = "";

	public ScheduledExecutorTest(String jobName) {
		super();
		this.jobName = jobName;
	}

	@Override
	public void run() {
		System.out.println("execute " + jobName);
	}

	public static void main(String[] args) {
		ScheduledExecutorService service = Executors.newScheduledThreadPool(10);

		long initialDelay1 = 1;
		long period1 = 1;
        // 從現在開始1秒鐘之後,每隔1秒鐘執行一次job1
		service.scheduleAtFixedRate(
		        new ScheduledExecutorTest("job1"), initialDelay1,
				period1, TimeUnit.SECONDS);

		long initialDelay2 = 1;
		long delay2 = 1;
        // 從現在開始2秒鐘之後,每隔2秒鐘執行一次job2
		service.scheduleWithFixedDelay(
		        new ScheduledExecutorTest("job2"), initialDelay2,
				delay2, TimeUnit.SECONDS);
	}
}
Output:
execute job1
execute job1
execute job2
execute job1
execute job1
execute job2      

清單 2 展示了 ScheduledExecutorService 中兩種最常用的排程方法 ScheduleAtFixedRate 和 ScheduleWithFixedDelay。ScheduleAtFixedRate 每次執行時間為上一次任務開始起向後推一個時間間隔,即每次執行時間為 :initialDelay, initialDelay+period, initialDelay+2*period, …;ScheduleWithFixedDelay 每次執行時間為上一次任務結束起向後推一個時間間隔,即每次執行時間為:initialDelay, initialDelay+executeTime+delay, initialDelay+2*executeTime+2*delay。由此可見,ScheduleAtFixedRate 是基于固定時間間隔進行任務排程,ScheduleWithFixedDelay 取決于每次任務執行的時間長短,是基于不固定時間間隔進行任務排程。

http://www.ibm.com/developerworks/cn/java/j-lo-taskschedule/#ibm-pcon

用 ScheduledExecutor 和 Calendar 實作複雜任務排程

Timer 和 ScheduledExecutor 都僅能提供基于開始時間與重複間隔的任務排程,不能勝任更加複雜的排程需求。比如,設定每星期二的 16:38:10 執行任務。該功能使用 Timer 和 ScheduledExecutor 都不能直接實作,但我們可以借助 Calendar 間接實作該功能。

清單 3. 使用 ScheduledExcetuor 和 Calendar 進行任務排程
package com.ibm.scheduler;

import java.util.Calendar;
import java.util.Date;
import java.util.TimerTask;
import java.util.concurrent.Executors;
import java.util.concurrent.ScheduledExecutorService;
import java.util.concurrent.TimeUnit;

public class ScheduledExceutorTest2 extends TimerTask {

	private String jobName = "";

	public ScheduledExceutorTest2(String jobName) {
		super();
		this.jobName = jobName;
	}

	@Override
	public void run() {
		System.out.println("Date = "+new Date()+", execute " + jobName);
	}

	/**
	 * 計算從目前時間currentDate開始,滿足條件dayOfWeek, hourOfDay, 
	 * minuteOfHour, secondOfMinite的最近時間
	 * @return
	 */
	public Calendar getEarliestDate(Calendar currentDate, int dayOfWeek,
			int hourOfDay, int minuteOfHour, int secondOfMinite) {
		//計算目前時間的WEEK_OF_YEAR,DAY_OF_WEEK, HOUR_OF_DAY, MINUTE,SECOND等各個字段值
		int currentWeekOfYear = currentDate.get(Calendar.WEEK_OF_YEAR);
		int currentDayOfWeek = currentDate.get(Calendar.DAY_OF_WEEK);
		int currentHour = currentDate.get(Calendar.HOUR_OF_DAY);
		int currentMinute = currentDate.get(Calendar.MINUTE);
		int currentSecond = currentDate.get(Calendar.SECOND);

		//如果輸入條件中的dayOfWeek小于目前日期的dayOfWeek,則WEEK_OF_YEAR需要推遲一周
		boolean weekLater = false;
		if (dayOfWeek < currentDayOfWeek) {
			weekLater = true;
		} else if (dayOfWeek == currentDayOfWeek) {
			//當輸入條件與目前日期的dayOfWeek相等時,如果輸入條件中的
			//hourOfDay小于目前日期的
			//currentHour,則WEEK_OF_YEAR需要推遲一周	
			if (hourOfDay < currentHour) {
				weekLater = true;
			} else if (hourOfDay == currentHour) {
                 //當輸入條件與目前日期的dayOfWeek, hourOfDay相等時,
                 //如果輸入條件中的minuteOfHour小于目前日期的
				//currentMinute,則WEEK_OF_YEAR需要推遲一周
				if (minuteOfHour < currentMinute) {
					weekLater = true;
				} else if (minuteOfHour == currentSecond) {
                     //當輸入條件與目前日期的dayOfWeek, hourOfDay, 
                     //minuteOfHour相等時,如果輸入條件中的
                    //secondOfMinite小于目前日期的currentSecond,
                    //則WEEK_OF_YEAR需要推遲一周
					if (secondOfMinite < currentSecond) {
						weekLater = true;
					}
				}
			}
		}
		if (weekLater) {
			//設定目前日期中的WEEK_OF_YEAR為目前周推遲一周
			currentDate.set(Calendar.WEEK_OF_YEAR, currentWeekOfYear + 1);
		}
		// 設定目前日期中的DAY_OF_WEEK,HOUR_OF_DAY,MINUTE,SECOND為輸入條件中的值。
		currentDate.set(Calendar.DAY_OF_WEEK, dayOfWeek);
		currentDate.set(Calendar.HOUR_OF_DAY, hourOfDay);
		currentDate.set(Calendar.MINUTE, minuteOfHour);
		currentDate.set(Calendar.SECOND, secondOfMinite);
		return currentDate;

	}

	public static void main(String[] args) throws Exception {

		ScheduledExceutorTest2 test = new ScheduledExceutorTest2("job1");
		//擷取目前時間
		Calendar currentDate = Calendar.getInstance();
		long currentDateLong = currentDate.getTime().getTime();
		System.out.println("Current Date = " + currentDate.getTime().toString());
		//計算滿足條件的最近一次執行時間
		Calendar earliestDate = test
				.getEarliestDate(currentDate, 3, 16, 38, 10);
		long earliestDateLong = earliestDate.getTime().getTime();
		System.out.println("Earliest Date = "
				+ earliestDate.getTime().toString());
		//計算從目前時間到最近一次執行時間的時間間隔
		long delay = earliestDateLong - currentDateLong;
		//計算執行周期為一星期
		long period = 7 * 24 * 60 * 60 * 1000;
		ScheduledExecutorService service = Executors.newScheduledThreadPool(10);
		//從現在開始delay毫秒之後,每隔一星期執行一次job1
		service.scheduleAtFixedRate(test, delay, period,
				TimeUnit.MILLISECONDS);

	}
} 
Output:
Current Date = Wed Feb 02 17:32:01 CST 2011
Earliest Date = Tue Feb 8 16:38:10 CST 2011
Date = Tue Feb 8 16:38:10 CST 2011, execute job1
Date = Tue Feb 15 16:38:10 CST 2011, execute job1      

清單 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 提供了這方面強大的支援。

http://www.ibm.com/developerworks/cn/java/j-lo-taskschedule/#ibm-pcon

Quartz

Quartz 可以滿足更多更複雜的排程需求,首先讓我們看看如何用 Quartz 實作每星期二 16:38 的排程安排:

清單 4. 使用 Quartz 進行任務排程
package com.ibm.scheduler;
import java.util.Date;

import org.quartz.Job;
import org.quartz.JobDetail;
import org.quartz.JobExecutionContext;
import org.quartz.JobExecutionException;
import org.quartz.Scheduler;
import org.quartz.SchedulerFactory;
import org.quartz.Trigger;
import org.quartz.helpers.TriggerUtils;

public class QuartzTest implements Job {

	@Override
	//該方法實作需要執行的任務
	public void execute(JobExecutionContext arg0) throws JobExecutionException {
		System.out.println("Generating report - "
				+ arg0.getJobDetail().getFullName() + ", type ="
				+ arg0.getJobDetail().getJobDataMap().get("type"));
		System.out.println(new Date().toString());
	}
	public static void main(String[] args) {
		try {
			// 建立一個Scheduler
			SchedulerFactory schedFact = 
			new org.quartz.impl.StdSchedulerFactory();
			Scheduler sched = schedFact.getScheduler();
			sched.start();
			// 建立一個JobDetail,指明name,groupname,以及具體的Job類名,
			//該Job負責定義需要執行任務
			JobDetail jobDetail = new JobDetail("myJob", "myJobGroup",
					QuartzTest.class);
			jobDetail.getJobDataMap().put("type", "FULL");
            // 建立一個每周觸發的Trigger,指明星期幾幾點幾分執行
			Trigger trigger = TriggerUtils.makeWeeklyTrigger(3, 16, 38);
			trigger.setGroup("myTriggerGroup");
			// 從目前時間的下一秒開始執行
			trigger.setStartTime(TriggerUtils.getEvenSecondDate(new Date()));
			// 指明trigger的name
			trigger.setName("myTrigger");
			// 用scheduler将JobDetail與Trigger關聯在一起,開始排程任務
			sched.scheduleJob(jobDetail, trigger);

		} catch (Exception e) {
			e.printStackTrace();
		}
	}
} 
Output:
Generating report - myJobGroup.myJob, type =FULL
Tue Feb 8 16:38:00 CST 2011
Generating report - myJobGroup.myJob, type =FULL
Tue Feb 15 16:38:00 CST 2011      

清單 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 對,例如:

清單 5. 為 JobDataMap 指派
jobDetail.getJobDataMap().put("myDescription", "my job description"); 
 jobDetail.getJobDataMap().put("myValue", 1998); 
 ArrayList<String> list = new ArrayList<String>(); 
 list.add("item1"); 
 jobDetail.getJobDataMap().put("myArray", list);      

JobDataMap 中的資料可以通過下面的方式擷取:

清單 6. 擷取 JobDataMap 的值
public class JobDataMapTest implements Job {

	@Override
	public void execute(JobExecutionContext context)
			throws JobExecutionException {
		//從context中擷取instName,groupName以及dataMap
		String instName = context.getJobDetail().getName();
		String groupName = context.getJobDetail().getGroup();
		JobDataMap dataMap = context.getJobDetail().getJobDataMap();
		//從dataMap中擷取myDescription,myValue以及myArray
		String myDescription = dataMap.getString("myDescription");
		int myValue = dataMap.getInt("myValue");
		ArrayList<String> myArray = (ArrayListlt;Strin>) dataMap.get("myArray");
		System.out.println("
		        Instance =" + instName + ", group = " + groupName
                + ", description = " + myDescription + ", value =" + myValue
                + ", array item0 = " + myArray.get(0));

	}
}
Output:
Instance = myJob, group = myJobGroup, 
description = my job description, 
value =1998, array item0 = item1      

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:

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

建立一個半分鐘後開始執行,且每隔一分鐘重複執行一次的 SimpleTrigger:

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

建立一個 2011 年 6 月 1 日 8:30 開始執行,每隔一小時執行一次,一共執行一百次,一天之後截止的 SimpleTrigger:

Calendar calendar = Calendar.getInstance(); 
 calendar.set(Calendar.YEAR, 2011); 
 calendar.set(Calendar.MONTH, Calendar.JUNE); 
 calendar.set(Calendar.DAY_OF_MONTH, 1); 
 calendar.set(Calendar.HOUR, 8); 
 calendar.set(Calendar.MINUTE, 30); 
 calendar.set(Calendar.SECOND, 0); 
 calendar.set(Calendar.MILLISECOND, 0); 
 Date startTime = calendar.getTime(); 
 Date endTime = new Date (calendar.getTimeInMillis() +24*60*60*1000); 
 SimpleTrigger trigger=new SimpleTrigger("myTrigger", 
        "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。

停掉程式,将資料庫中記錄的任務排程資料重新導入程式運作:

清單 9. 從資料庫中導入任務排程資料重新運作
package com.ibm.scheduler; 
 import org.quartz.Scheduler; 
 import org.quartz.SchedulerException; 
 import org.quartz.SchedulerFactory; 
 import org.quartz.Trigger; 
 import org.quartz.impl.StdSchedulerFactory; 

 public class QuartzReschedulerTest { 
 public static void main(String[] args) throws SchedulerException { 
 // 初始化一個 Schedule Factory 
 SchedulerFactory schedulerFactory = new StdSchedulerFactory(); 
 // 從 schedule factory 中擷取 scheduler 
 Scheduler scheduler = schedulerFactory.getScheduler(); 
 // 從 schedule factory 中擷取 trigger 
 Trigger trigger = scheduler.getTrigger("myTrigger", "myTriggerGroup"); 
 // 重新開啟排程任務
 scheduler.rescheduleJob("myTrigger", "myTriggerGroup", trigger); 
 scheduler.start(); 
 } 
 }      

清單 9 中,schedulerFactory.getScheduler() 将 quartz.properties 的内容加載到記憶體,然後根據資料源的屬性初始化資料庫的連結,并将資料庫中存儲的資料加載到記憶體。之後,便可以在記憶體中查詢某一具體的 trigger,并将其重新啟動。這時候重新查詢 qrtz_simple_triggers 中的資料,發現 times_triggered 值比原來增長了。

http://www.ibm.com/developerworks/cn/java/j-lo-taskschedule/#ibm-pcon

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 點發一封信給 [email protected]

0 1 2 * * mail -s “good” [email protected]      

每周一,周二,周三,周六的晚上 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 中添加如下行:

清單 10. 在 web.xml 中配置 JCronTab 的屬性
<servlet> 
   <servlet-name>LoadOnStartupServlet</servlet-name> 
   <servlet-class>org.jcrontab.web.loadCrontabServlet</servlet-class> 
   <init-param> 
 <param-name>PROPERTIES_FILE</param-name> 
 <param-value>D:/Scheduler/src/jcrontab.properties</param-value> 
   </init-param> 
   <load-on-startup>1</load-on-startup> 
 </servlet> 
 <!-- Mapping of the StartUp Servlet --> 
 <servlet-mapping> 
   <servlet-name>LoadOnStartupServlet</servlet-name> 
 <url-pattern>/Startup</url-pattern> 
 </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 方法。

清單 11. JcronTask1 與 JCronTask2 的實作
package com.ibm.scheduler;

import java.util.Date;

public class JCronTask1 {

	private static int count = 0;

	public static void main(String[] args) {
		System.out.println("--------------Task1-----------------");
		System.out.println("Current Time = " + new Date() + ", Count = "
				+ count++);
	}
}

package com.ibm.scheduler;

import java.util.Date;

public class JCronTask2 implements Runnable {

	private static int count = 0;

	private static String[] args;

	public JCronTask2(String[] args) {
		System.out.println("--------------Task2-----------------");
		System.out.println("Current Time = " + new Date() + ", Count = "
				+ count++);
		JCronTask2.args = args;
	}

	@Override
	public void run() {
		System.out.println("enter into run method");
		if (args != null && args.length > 0) {
			for (int i = 0; i < args.length; i++) {
         System.out.print("This is arg " + i + " " + args[i] + "\n");
			}
		}
	}
}      

到此為止,基于普通檔案持久化的 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      
http://www.ibm.com/developerworks/cn/java/j-lo-taskschedule/#ibm-pcon

結束語

本文介紹了四種常用的對任務進行排程的 Java 實作方法,即 Timer,ScheduledExecutor, Quartz 以及 JCronTab。文本對每種方法都進行了執行個體解釋,并對其優缺點進行比較。對于簡單的基于起始時間點與時間間隔的任務排程,使用 Timer 就足夠了;如果需要同時排程多個任務,基于線程池的 ScheduledTimer 是更為合适的選擇;當任務排程的政策複雜到難以憑借起始時間點與時間間隔來描述時,Quartz 與 JCronTab 則展現出它們的優勢。熟悉 Unix/Linux 的開發人員更傾向于 JCronTab,且 JCronTab 更适合與 Web 應用伺服器相結合。Quartz 的 Trigger 與 Job 松耦合設計使其更适用于 Job 與 Trigger 的多對多應用場景。