Quartz job scheduler 學習

Even發表於2019-01-19
quartz

Quartz是個任務排程框架： http://www.quartz-scheduler.org/
一、基本概念
Job: 任務，必須implements Job這個藉口，在execute方法中寫具體要做得事。
Trigger: 觸發器，執行任務的規則，比如定時、每天小時、每天等等。分為SimpleTrigger和CronTrigger，SimpleTrigger用於執行例如立即執行、每隔多長時間做任務等，而CronTrigger用於例如每天什麼時間、每月第一天執行等等。
Scheduler: 任務排程，將Job和Trigger註冊到Scheduler裡，即可根據設定執行任務。

二、程式碼
首先上官網下載相應的jar包，或在pom.xml裡設定Maven的dependency, 以下以我當前版本2.2.1為例。

Job類

public class MyJob implements Job {

    @Override
    public void execute(JobExecutionContext context) throws JobExecutionException {
        System.out.println("Hello");
        System.out.println(new Date());
    }

}

Scheduler測試，包含了簡單的定時，有規則的定時以及根據timezone定時等

public class MyScheduler {

    public static void main(String[] args) throws SchedulerException {
        JobDetail job = JobBuilder.newJob(MyJob.class).build();
        
               // 簡單任務
        Trigger t1 = TriggerBuilder.newTrigger().withIdentity("mySimpleTrigger").startNow().build();
        
               // 每天12:47分執行
        Trigger t2 = TriggerBuilder.newTrigger().withIdentity("myCronTrigger").withSchedule(CronScheduleBuilder.cronSchedule("0 47 12 1/1 * ? *")).build();
        
        // 每隔5秒執行
                 Trigger t3 = TriggerBuilder.newTrigger().withIdentity("myCronTrigger").
                withSchedule(SimpleScheduleBuilder.simpleSchedule().withIntervalInSeconds(5).repeatForever()).build();

               // 每天12:47(GMT+8)執行, 注意使用了inTimeZone。如果schedule是根據客戶時區安排的，就非常有用，順帶解決了DSTSaving的問題
        Trigger t4 = TriggerBuilder.newTrigger().withIdentity("myCronTrigger").withSchedule(CronScheduleBuilder.cronSchedule("0 47 12 1/1 * ? *").inTimeZone(TimeZone.getTimeZone("GMT+8"))).build();

                // 通過schedulerFactory獲取一個排程器 
        Scheduler sc = StdSchedulerFactory.getDefaultScheduler();
        
               // 把作業和觸發器註冊到任務排程中
        sc.scheduleJob(job, t3);
        sc.start();
    }

}

當需要修改job，重新reschedule

public void execute(JobExecutionContext context) throws JobExecutionException {
    Trigger newTrigger = what_ever_you_want;
    Trigger oldTrigger = context.getTrigger();
    Scheduler scheduler = StdSchedulerFactory.getDefaultScheduler();
    scheduler.rescheduleJob(oldTrigger.getKey(), newTrigger);
}

對於CronExpression可以參考http://www.cronmaker.com/ 來給出表示式，詳解如下：
欄位 允許值 允許的特殊字元
秒 0-59 , – * /
分 0-59 , – * /
小時 0-23 , – * /
日期 1-31 , – * ? / L W C
月份 1-12 或者 JAN-DEC , – * /
星期 1-7 或者 SUN-SAT , – * ? / L C #
年（可選） 留空, 1970-2099 , – * /

表示式 意義
“0 0 12 ?” 每天中午12點觸發
“0 15 10 ? ” 每天上午10:15觸發
“0 15 10 ?” 每天上午10:15觸發
“0 15 10 ? *” 每天上午10:15觸發
“0 15 10 ? 2005″ 2005年的每天上午10:15觸發
“0 14 * ?” 在每天下午2點到下午2:59期間的每1分鐘觸發
“0 0/5 14 ?” 在每天下午2點到下午2:55期間的每5分鐘觸發
“0 0/5 14,18 ?” 在每天下午2點到2:55期間和下午6點到6:55期間的每5分鐘觸發
“0 0-5 14 ?” 在每天下午2點到下午2:05期間的每1分鐘觸發
“0 10,44 14 ? 3 WED” 每年三月的星期三的下午2:10和2:44觸發
“0 15 10 ? * MON-FRI” 週一至週五的上午10:15觸發
“0 15 10 15 * ?” 每月15日上午10:15觸發
“0 15 10 L * ?” 每月最後一日的上午10:15觸發
“0 15 10 ? * 6L” 每月的最後一個星期五上午10:15觸發
“0 15 10 ? * 6L 2002-2005” 2002年至2005年的每月的最後一個星期五上午10:15觸發
“0 15 10 ? * 6#3” 每月的第三個星期五上午10:15觸發

特殊字元 意義
* 表示所有值；
? 表示未說明的值，即不關心它為何值；
– 表示一個指定的範圍；
, 表示附加一個可能值；
/ 符號前表示開始時間，符號後表示每次遞增的值；
L(“last”) (“last”) “L” 用在day-of-month欄位意思是 “這個月最後一天”；用在 day-of-week欄位, 它簡單意思是 “7” or “SAT”。 如果在day-of-week欄位裡和數字聯合使用，它的意思就是 “這個月的最後一個星期幾” – 例如： “6L” means “這個月的最後一個星期五”. 當我們用“L”時，不指明一個列表值或者範圍是很重要的，不然的話，我們會得到一些意想不到的結果。
W(“weekday”) 只能用在day-of-month欄位。用來描敘最接近指定天的工作日（週一到週五）。例如：在day-of-month欄位用“15W”指“最接近這個月第15天的工作日”，即如果這個月第15天是週六，那麼觸發器將會在這個月第14天即週五觸發；如果這個月第15天是週日，那麼觸發器將會在這個月第16天即週一觸發；如果這個月第15天是週二，那麼就在觸發器這天觸發。注意一點：這個用法只會在當前月計算值，不會越過當前月。“W”字元僅能在day-of-month指明一天，不能是一個範圍或列表。也可以用“LW”來指定這個月的最後一個工作日。
# 只能用在day-of-week欄位。用來指定這個月的第幾個周幾。例：在day-of-week欄位用”6#3″指這個月第3個週五（6指週五，3指第3個）。如果指定的日期不存在，觸發器就不會觸發。
C 指和calendar聯絡後計算過的值。例：在day-of-month 欄位用“5C”指在這個月第5天或之後包括calendar的第一天；在day-of-week欄位用“1C”指在這週日或之後包括calendar的第一天

相關文章