Quartz job scheduler 學(xué)習(xí)

CHENGKANG 發(fā)布于2019-08-15 17:40 / 3368人閱讀

摘要：觸發(fā)器，執(zhí)行任務(wù)的規(guī)則，比如定時(shí)每天小時(shí)每天等等。任務(wù)調(diào)度，將和注冊(cè)到里，即可根據(jù)設(shè)定執(zhí)行任務(wù)。用來描敘最接近指定天的工作日周一到周五。用來指定這個(gè)月的第幾個(gè)周幾。如果指定的日期不存在，觸發(fā)器就不會(huì)觸發(fā)。

Quartz是個(gè)任務(wù)調(diào)度框架： http://www.quartz-scheduler.org/
一、基本概念
Job: 任務(wù)，必須implements Job這個(gè)借口，在execute方法中寫具體要做得事。
Trigger: 觸發(fā)器，執(zhí)行任務(wù)的規(guī)則，比如定時(shí)、每天小時(shí)、每天等等。分為SimpleTrigger和CronTrigger，SimpleTrigger用于執(zhí)行例如立即執(zhí)行、每隔多長時(shí)間做任務(wù)等，而CronTrigger用于例如每天什么時(shí)間、每月第一天執(zhí)行等等。
Scheduler: 任務(wù)調(diào)度，將Job和Trigger注冊(cè)到Scheduler里，即可根據(jù)設(shè)定執(zhí)行任務(wù)。

二、代碼
首先上官網(wǎng)下載相應(yīng)的jar包，或在pom.xml里設(shè)定Maven的dependency, 以下以我當(dāng)前版本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測(cè)試，包含了簡單的定時(shí)，有規(guī)則的定時(shí)以及根據(jù)timezone定時(shí)等

public class MyScheduler {

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

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

                // 通過schedulerFactory獲取一個(gè)調(diào)度器 
        Scheduler sc = StdSchedulerFactory.getDefaultScheduler();
        
               // 把作業(yè)和觸發(fā)器注冊(cè)到任務(wù)調(diào)度中
        sc.scheduleJob(job, t3);
        sc.start();
    }

}

當(dāng)需要修改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);
}

對(duì)于CronExpression可以參考http://www.cronmaker.com/ 來給出表達(dá)式，詳解如下：
字段允許值允許的特殊字符
秒 0-59 , - * /
分 0-59 , - * /
小時(shí) 0-23 , - * /
日期 1-31 , - * ? / L W C
月份 1-12 或者 JAN-DEC , - * /
星期 1-7 或者 SUN-SAT , - * ? / L C #
年（可選）留空, 1970-2099 , - * /

表達(dá)式意義
"0 0 12 ?" 每天中午12點(diǎn)觸發(fā)
"0 15 10 ? " 每天上午10:15觸發(fā)
"0 15 10 ?" 每天上午10:15觸發(fā)
"0 15 10 ? *" 每天上午10:15觸發(fā)
"0 15 10 ? 2005" 2005年的每天上午10:15觸發(fā)
"0 14 * ?" 在每天下午2點(diǎn)到下午2:59期間的每1分鐘觸發(fā)
"0 0/5 14 ?" 在每天下午2點(diǎn)到下午2:55期間的每5分鐘觸發(fā)
"0 0/5 14,18 ?" 在每天下午2點(diǎn)到2:55期間和下午6點(diǎn)到6:55期間的每5分鐘觸發(fā)
"0 0-5 14 ?" 在每天下午2點(diǎn)到下午2:05期間的每1分鐘觸發(fā)
"0 10,44 14 ? 3 WED" 每年三月的星期三的下午2:10和2:44觸發(fā)
"0 15 10 ? * MON-FRI" 周一至周五的上午10:15觸發(fā)
"0 15 10 15 * ?" 每月15日上午10:15觸發(fā)
"0 15 10 L * ?" 每月最后一日的上午10:15觸發(fā)
"0 15 10 ? * 6L" 每月的最后一個(gè)星期五上午10:15觸發(fā)
"0 15 10 ? * 6L 2002-2005" 2002年至2005年的每月的最后一個(gè)星期五上午10:15觸發(fā)
"0 15 10 ? * 6#3" 每月的第三個(gè)星期五上午10:15觸發(fā)

特殊字符意義
* 表示所有值；
? 表示未說明的值，即不關(guān)心它為何值；
- 表示一個(gè)指定的范圍；
, 表示附加一個(gè)可能值；
/ 符號(hào)前表示開始時(shí)間，符號(hào)后表示每次遞增的值；
L("last") ("last") "L" 用在day-of-month字段意思是 "這個(gè)月最后一天"；用在 day-of-week字段, 它簡單意思是 "7" or "SAT"。如果在day-of-week字段里和數(shù)字聯(lián)合使用，它的意思就是 "這個(gè)月的最后一個(gè)星期幾" – 例如： "6L" means "這個(gè)月的最后一個(gè)星期五". 當(dāng)我們用“L”時(shí)，不指明一個(gè)列表值或者范圍是很重要的，不然的話，我們會(huì)得到一些意想不到的結(jié)果。
W("weekday") 只能用在day-of-month字段。用來描敘最接近指定天的工作日（周一到周五）。例如：在day-of-month字段用“15W”指“最接近這個(gè)月第15天的工作日”，即如果這個(gè)月第15天是周六，那么觸發(fā)器將會(huì)在這個(gè)月第14天即周五觸發(fā)；如果這個(gè)月第15天是周日，那么觸發(fā)器將會(huì)在這個(gè)月第16天即周一觸發(fā)；如果這個(gè)月第15天是周二，那么就在觸發(fā)器這天觸發(fā)。注意一點(diǎn)：這個(gè)用法只會(huì)在當(dāng)前月計(jì)算值，不會(huì)越過當(dāng)前月。“W”字符僅能在day-of-month指明一天，不能是一個(gè)范圍或列表。也可以用“LW”來指定這個(gè)月的最后一個(gè)工作日。
# 只能用在day-of-week字段。用來指定這個(gè)月的第幾個(gè)周幾。例：在day-of-week字段用"6#3"指這個(gè)月第3個(gè)周五（6指周五，3指第3個(gè)）。如果指定的日期不存在，觸發(fā)器就不會(huì)觸發(fā)。
C 指和calendar聯(lián)系后計(jì)算過的值。例：在day-of-month 字段用“5C”指在這個(gè)月第5天或之后包括calendar的第一天；在day-of-week字段用“1C”指在這周日或之后包括calendar的第一天