quartz定時器工具

時間 2019-11-16

標籤 quartz 定時器工具欄目 Quartz 简体版

原文原文鏈接

一次工做的時候有用到。正好把以前作的一些記錄也貼出了作個總結好了。 spa

1.quartz核心接口

Scheduler 調度器、Job、JobDetail、Trigger、JobDataMap

2.Scheduler

1.這個 Scheduler 的實現，其實是一個代理，對其中方法調用會傳遞到 QuartzScheduler 實例上

2.SchedulerFactory實例化

3.org.quartz.impl.DirectoSchedulerFactory

org.quartz.impl.StdSchedulerFactory

StdSchedulerFactory會加載類路徑下的quartz.properties 文件

4.一旦scheduler被關閉（shutdown）,則它不能再從新啓動，除非從新實例化它

3.job

1.public interface Job { void execute(JobExecutionContext context) throws JobExecutionException; }

2.StatefulJob在任務的每次執行以後從新存儲JobDataMap

4.JobDetail

1.JobDetail對象由Quartz客戶端在Job被加入到scheduler時建立。它包含了Job的各類設置屬性以及一個JobDataMap對象，這個對象被用來存儲給定Job類實例的狀態信息。

2.每次scheduler執行這個任務時，它就建立這個類的新實例，而後調用該實例的execute(..)方法。

3.JobDataMap

JobDetail.getJobDataMap().put("jobSays", "Hello World!");

JobExecutionContext.getJobDetail().getJobDataMap();

Trigger.getJobDataMap();

JobExecutionContext.getMergedJobDataMap();

5.Trigger

1.Trigger對象被用來觸發jobs的執行。

2.經常使用的Trigger類是SimpleTrigger和CronTrigger。

3.SimpleTrigger

SimpleTrigger用來觸發只需執行一次或者在給定時間觸發而且重複N次且每次執行延遲必定時間的任務。

4.CronTriggers

像日曆那樣按日程來觸發任務

5.TriggerUtils

提供了許多便捷的方法簡化了構造和配置 trigger

public static Trigger makeSecondlyTrigger(int intervalInSeconds);

public static Trigger makeDailyTrigger(int hour, int minute);

public static Trigger makeWeeklyTrigger(int dayOfWeek, int hour, int minute);

public static Trigger makeMonthlyTrigger(int dayOfMonth, int hour, int minute);

public static Date getNextGivenMinuteDate(Date date, int minuteBase);

public static Date getEvenMinuteDate(Date date);

6.Listeners

1.TriggerListeners和JobListeners

監聽器是在scheduler事件發生時可以執行動做的對象。

TriggerListeners接收與triggers相關的事件

JobListeners則接收與Job相關的事件。

2.註冊

監聽器而後在執行的時候註冊到scheduler

聽器能夠被註冊爲「全局」的或者「非全局」

全局：scheduler.addGlobalJobListener(jobListener);

非全局scheduler.addJobListener(jobListener);

jobDetail.addJobListener(jobListener.getName());

3.SchedulerListeners

只接收與特定trigger 或job無關的Scheduler自身事件通知

4.jobListener的方法：

jobToBeExecuted() 方法

Scheduler 在 JobDetail 將要被執行時調用這個方法。

·jobExecutionVetoed() 方法

Scheduler 在 JobDetail 即將被執行，但又被 TriggerListener 否決了時調用這個方法。

·jobWasExecuted() 方法

Scheduler 在 JobDetail 被執行以後調用這個方法。

5.TriggerListener

·getName() 方法

和前面的 JobListener 同樣，TriggerListner 接口的 getName() 返回一個字符串用以說明監聽器的名稱。對於非全局的 TriggerListener，在 addTriggerListener() 方法中給定的名稱必須與監聽器的 getName() 方法返回值相匹配。

·triggerFired() 方法

當與監聽器相關聯的 Trigger 被觸發，Job 上的 execute() 方法將要被執行時，Scheduler 就調用這個方法。在全局 TriggerListener 狀況下，這個方法爲全部 Trigger 被調用。

·vetoJobExecution() 方法

在 Trigger 觸發後，Job 將要被執行時由 Scheduler 調用這個方法。TriggerListener 給了一個選擇去否決 Job 的執行。假如這個方法返回 true，這個 Job 將不會爲這次 Trigger 觸發而獲得執行。

·triggerMisfired() 方法

Scheduler 調用這個方法是在 Trigger 錯過觸發時。如這個方法的 JavaDoc 所指出的，你應該關注此方法中持續時間長的邏輯：在出現許多錯過觸發的 Trigger 時，長邏輯會致使骨牌效應。你應當保持這上方法儘可能的小。

·triggerComplete() 方法

Trigger 被觸發而且完成了 Job 的執行時，Scheduler 調用這個方法。這不是說這個 Trigger 將再也不觸發了，而僅僅是當前 Trigger 的觸發(而且緊接着的 Job 執行) 結束時。這個 Trigger 也許還要在未來觸發屢次的。

7.SchedulerPlugin插件

1.Quartz提供了一個接口(org.quartz.spi.SchedulerPlugin)來插入附加的功能。

2.public interface SchedulerPlugin {

public void initialize(String name, Scheduler scheduler) throws SchedulerException;

public void start();

public void shutdown();

}

8.Quartz cron

表 5.1. Quartz Cron 表達式支持到七個域

名稱	是否必須	容許值	特殊字符
秒	是	0-59	, - * /
分	是	0-59	, - * /
時	是	0-23	, - * /
日	是	1-31	, - * ? / L W C
月	是	1-12 或 JAN-DEC	, - * /
周	是	1-7 或 SUN-SAT	, - * ? / L C #
年	否	空或 1970-2099	, - * /