欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

Quartz 开发指南v2.2.1(翻译)

程序员文章站 2022-05-07 22:28:45
...

 

 

 

 

Quartz调度器开发指南

 

 

 

 

 

V 2.2.1


 

目录

使用Quartz API3

实例化Scheduler. 3

关键接口... 3

JobTrigger. 4

使用JobJobDetail6

JobJobDetail6

使用trigger. 10

Trigger. 10

SimpleTrigger. 11

CronTriggers. 14

使用TriggerListenerJobListener. 19

TriggerListenerJobListener. 19

创建你自己的监听器... 19

使用SchedulerListener. 21

SchedulerListener. 21

添加一个SchedulerListener. 22

移除一个SchedulerListener. 22

使用JobStore. 23

关于JobStores. 23

RAMJobStore. 23

JDBCJobStore. 23

TerracottaJobStore. 25

配置,Scheduler Factory和日志... 26

配置组件... 26

Scheduler工厂... 26

日志... 27

Quartz调度器的其他特性... 28

插件... 28

JobFactory. 28

Factory自带Job. 28

高级功能... 28

集群... 28

JTA事务... 29

 

 

使用Quartz API

实例化Scheduler

在你使用Scheduler之前,首先需要实例化。你必须使用SchedulerFactory来完成。

很多Quartz的使用者在JNDI中存储一个工厂的实例,这样非常容易直接使用一个工厂实例。

一旦一个scheduler被实例化,它就能被启动、设置为备用模式、停止。请注意,一旦你关闭了scheduler,不重新实例化就无法重启它。Scheduler不启动trigger也不会启动(因此,job也不会执行)。Scheduler处于暂停状态它们都不会工作。

下面的代码段实例化并启动一个scheduler,安排一个job执行。

         SchedulerFactory schedFact = new org.quartz.impl.StdSchedulerFactory();

         Scheduler sched = schedFact.getScheduler();

         sched.start();

         // define the job and tie it to our HelloJob class

         JobDetail job = new Job(HelloJob.class)

                   .withIdentity("myJob", "group1")

                   .build();

         // Trigger the job to run now, and then every 40 seconds

         Trigger trigger = new Trigger()

                   .withIdentity("myTrigger", "group1")

                   .startNow()

                   .withSchedule(simpleSchedule().withIntervalInSeconds(40).repeatForever())

                   .build();

         // Tell quartz to schedule the job using our trigger

         sched.scheduleJob(job, trigger);

关键接口

Quartz API的关键接口:

l  Scheduler——Scheduler进行交互的主要API

l  Job——你想让Scheduler执行时需要实现的接口组件。

l  JobDetail——用于定义Job的实例。

l  Trigger——一个定义在将要执行Jobscheduler上的组件。

l  JobBuilder——已定义的Job实例,用于定义/构建的JobDetail实例。

l  TriggerBuilder——用于定义/构建Trigger实例。

 

一个scheduler的生命周期是有限的,从SchedulerFactory开始直到调用它的shutdown()方法。

Scheduler接口一旦创建,就能添加、移除、和列出jobtrigger,并执行另一些与scheduling相关的操作(例如暂停trigger),然而,在schedulerstart()方法启动前,它不会作用于任何trigger(执行job),见第3实例化Scheduler”

Quartz提供”builder”类定义领域特定语言(DSL,有时也被称为“连贯接口”)。这里有一个例子:

         // define the job and tie it to our HelloJob class

         JobDetail job = new Job(HelloJob.class)

                   .withIdentity("myJob", "group1") // name "myJob", group "group1"

                   .build();

         // Trigger the job to run now, and then every 40 seconds

         Trigger trigger = new Trigger()

                   .withIdentity("myTrigger", "group1")

                   .startNow()

                   .withSchedule(simpleSchedule().withIntervalInSeconds(40).repeatForever())

                   .build();

         // Tell quartz to schedule the job using our trigger

         sched.scheduleJob(job, trigger);

使用JobBuilder类的静态方法创建job的代码块。同样,构建trigger的代码块使用TriggerBuilder类的静态方法创建,SimpleScheduleBulder类也一样。

DSL的静态导入可以接受这样的导入语句:

import static org.quartz.JobBuilder.*;

import static org.quartz.SimpleScheduleBuilder.*;

import static org.quartz.CronScheduleBuilder.*;

import static org.quartz.CalendarIntervalScheduleBuilder.*;

import static org.quartz.TriggerBuilder.*;

import static org.quartz.DateBuilder.*;

不同的SchedulerBuilder类拥有不同定义schedules类型的方法。

DateBuilder类包含有不同类型的方法去简单的构造java.util.Date实例的特定的时间点(例如如果当前时间为9:43:27,下一小时执行的时间,或者换句话说10:00)。

JobTrigger

一个job就是实现了Job接口的类。如下所示,这个接口有一个简单的方法:

package org.quartz;

publicinterface Job {

           publicvoid execute(JobExecutionContext context) throws JobExecutionException;

}

当一个job的触发器触发时,execute(..)方法被Scheduler的一个工作线程调用。JobExecutionContext对象就是通过这个方法提供job实例的信息,如运行环境,包括scheduler执行的句柄,trigger触发执行的句柄,jobJobDetail对象,和一些其它信息。

JobDetail对象由Quartz客户端(你的程序)在job添加进scheduler的时候创建。这个对象包含了很多job的属性设置,和JobDataMap一样,它能够存储你的job实例的状态信息。JobDetail对象本质上是定义的job实例。

Trigger对象常常用于触发job的执行(或者触发),当你希望安排一个job,你可以实例化一个trigger,并调整其属性来提供你想要的调度。

Trigger可能有一个与它们关联的JobDataMap对象。JobDataMap用于传递特定于触发器触发的工作参数。Quartz附带一些不同的触发类型,但是最常用的就是SimpleTriggerCronTrigger

l  SimpleTrigger很方便,如果你需要“一次性”执行(只是在一个给定时刻执行job),或者如果你需要一个job在一个给定的时间,并让它重复N,并在执行之间延迟T

l  CronTrigger是有用的,如果你想拥有引发基于当前日历时间表,如“每个星期五,中午”或“在每个月的第十天 10:15。”

为什么会同时有jobtrigger?许多工作调度器没有单独的jobtrigger的概念。一些定义一个job只是一个执行时间(或计划)以及一些小的工作标识符。其它的大部分就像Quartzjobtriiger对象的结合体。Quartz旨在创建一个分离的schedulerscheduler的执行。这个设计有很多好处。

例如,你可以创建独立于triggerjob并将他们存储在job scheduler。这使你能在同一个job上关联多个trigger。另一个解耦的好处是,能够在scheduler关联的trigger已过期时仍能配置job。这使你在重新安排它们后,不用重新定义它们。它还允许您修改或替换一个trigger,而不必重新定义相关的job

特性

Jobtrigger注册进Quartz scheduler时给出了keyJobtriggerJobKeyTriggerKey)的key允许它们放被放置到group中,group可用于分类组织你得jobtrigger,例如报表job”维护job”Job或者triggerkey值在group中必须是唯一的。换句话说,jobtrigger的完整的key(或标识)是由keygroup组成。

有关jobtrigger的详细信息,请参见第6页“JobJobDetails”和第10页“使用trigger”。


 

使用JobJobDetail

JobJobDetail

Job很容易实现,接口中只有一个“execute”方法。Job有更多的东西你需要了解,就是关于Job接口的execute(..)方法,和JobDetails

当你实现一个job类时,代码知道如何实现job的特定类型的实际工作,你或许希望了解job实例拥有的Quartz的各种属性。

使用JobBuilder类构建JobDetail实例。你通常会想要使用静态导入导入所有的方法,为了你的代码能够DSL-feel

import static org.quartz.JobBuilder.*;

下面的代码片段定义了一个job并安排它的执行:

         // define the job and tie it to our HelloJob class

         JobDetail job = new Job(HelloJob.class)

                   .withIdentity("myJob", "group1") // name "myJob", group "group1"

                   .build();

         // Trigger the job to run now, and then every 40 seconds

         Trigger trigger = new Trigger()

                   .withIdentity("myTrigger", "group1")

                   .startNow()

                   .withSchedule(simpleSchedule().withIntervalInSeconds(40).repeatForever())

                   .build();

         // Tell quartz to schedule the job using our trigger

         sched.scheduleJob(job, trigger);

现在考虑这个jobHelloJob,如下所示:

publicclass HelloJob implements Job {

     public HelloJob() {

     }

 

     publicvoid execute(JobExecutionContext context) throws JobExecutionException {

         System.err.println("Hello! HelloJob is executing.");

     }

}

请注意我们给scheduler一个JobDetail实例,而且它知道要执行的job的类型,只需提供我们构建JobDetailjob类。每次scheduler执行job,它会在调用它的execute(..)方法之前创建这个类的新实例。当执行完成,job实例的引用被删除,然后垃圾收集器回收实例。

这种行为的后果之一是job必须有一个无参数的构造函数(当使用默认JobFactory实现)。另一个是job类上定义的没有意义的数据字段的状态,它们的值在Job执行期间不会被保存。

你能够使用JobDataMapjob实例提供属性/配置或跟踪job执行间的状态,,它是JobDetail对象的一部分。

JobDataMap

JobDataMap可以用来保存大量那些在job实例执行时你希望得到的 (序列化)数据对象。JobDataMapJava Map接口的一个实现,并且添加一些便利的方法来存储和检索数据的原始类型。

当定义/构建JobDetail,这里有一些将job添加进scheduler之前放到JobDataMap的数据。

         // define the job and tie it to our DumbJob class

         JobDetail job = new Job(DumbJob.class)

                   .withIdentity("myJob", "group1") // name "myJob", group "group1"

                   .usingJobData("jobSays", "Hello World!")

                   .usingJobData("myFloatValue", 3.141f)

                   .build();

这是一个例子,在job执行期间,从JobDataMap获取数据:

publicclass DumbJob implements Job {

     public DumbJob() {

     }

 

     publicvoid execute(JobExecutionContext context) throws JobExecutionException {

         JobKey key = context.getJobDetail().getKey();

         JobDataMap dataMap = context.getJobDetail().getJobDataMap();

         String jobSays = dataMap.getString("jobSays");

         floatmyFloatValue = dataMap.getFloat("myFloatValue");

         System.err.println("Instance " + key + " of DumbJob says: " + jobSays + ", and val is: " + myFloatValue);

     }

}

如果你使用一个持久化的JobStore(在本教程的JobStore节讨论)你应该注意在决定你在JobDataMap中安排什么,因为里面的对象将序列化,他们因此会有类版本问题。显然标准Java类型应该很安全,但除此之外,任何时候有人改变一个类的定义的序列化实例,必须小心不要打破兼容性。可选地,您可以将JDBC-JobStoreJobDataMap放入model,只允许基本类型和字符串存储在map,从而消除任何后来序列化问题的可能性。

如果你为job类添加setter方法,相当于在JobDataMap中对应的key (如上面的示例中setJobSays(String val)方法,然后quartz的默认JobFactory实现将自动调用这些setterJob被实例化,从而防止需要显式地在你的执行方法获得map的值。

trigger也可以有与他们有关的JobDataMaps。如果你有一个job存储在scheduler由多个trigger常规/重复使用,然而每个独立的触发,你想工作提供不同的数据输入,这是有用的。

job执行期间在JobExecutionContext上建立JobDataMap十分方便。它是基于JobDetailJobDataMap和基于Trigger上的一个合并,后者任何相同名字的值将覆盖前者。

这是一个简单的例子在job执行期间从JobExecutionContext合并的JobDataMap获取数据:

publicclass DumbJob implements Job {

     public DumbJob() {

     }

 

     publicvoid execute(JobExecutionContext context) throws JobExecutionException {

         JobKey key = context.getJobDetail().getKey();

         JobDataMap dataMap = context.getMergedJobDataMap();

         // Note the difference from the previous example

         String jobSays = dataMap.getString("jobSays");

         floatmyFloatValue = dataMap.getFloat("myFloatValue");

         ArrayList state = (ArrayList) dataMap.get("myStateData");

         state.add(new Date());

         System.err.println("Instance " + key + " of DumbJob says: " + jobSays + ", and val is: " + myFloatValue);

     }

}

或者如果你想依靠JobFactory注入数据映射到类的值,它可能看起来像这样:

publicclass DumbJob implements Job {

     String jobSays;

     floatmyFloatValue;

     ArrayList state;

 

     public DumbJob() {

     }

 

     publicvoid execute(JobExecutionContext context) throws JobExecutionException {

         JobKey key = context.getJobDetail().getKey();

         JobDataMap dataMap = context.getMergedJobDataMap();

         // Note the difference from the previous example

         state.add(new Date());

         System.err.println("Instance " + key + " of DumbJob says: " + jobSays + ", and val is: " + myFloatValue);

     }

 

     publicvoid setJobSays(String jobSays) {

         this.jobSays = jobSays;

     }

 

     publicvoid setMyFloatValue(floatmyFloatValue) {

         myFloatValue = myFloatValue;

     }

 

     publicvoid setState(ArrayList state) {

         state = state;

     }

}

你会注意到整个代码的类是长,但是execute()方法中的代码更干净。当然你也可以说,虽然代码比较长,它实际上花了更少的编码,如果程序员用IDE自动生成setter方法,而不必手工从JobDataMap检索值。这是你的选择。

Job实例

你可以创建一个单一的工作类,scheduler中存储被JobDetails创建的多个实例定义——每个都有自己的一组属性和JobDataMap——并将它们添加到调度器。

例如,您可以创建一个类称为SalesReportJob,实现了job接口。这个job也许被编码成预计的参数(通过JobDataMap)发送给指定的基于销售报告的销售人员。然后,他们可能会创建多个Job定义(JobDetails),比如SalesReportForJoeSalesReportForMike中指定相应的JobDataMaps作为“Joe”和“Mike”各自的输入工作。

trigger触发,JobDetail(实例定义)被关联加载,Job类通过scheduler中的配置JobFactory实例化。默认JobFactory简单地调用Job类的newInstance(),然后试图调用类中与JobDataMap键的名称相匹配setter方法。您可能想要创建自己的JobFactory实现,诸如应用程序的IoCDI容器生产/实例化job类。

每个存储的JobDetail作为job定义或JobDetail实例被引用,每个执行的job都是一个job实例或job定义的实例。一般来说,使用术语“工作”时,指的是定义的名称或JobDetail。类实现的工作接口,称为“job类”。

Job状态和并发

下面是job状态数据和并发的一些注意点。你可以添加一些注解在你的job类上,在一些方面影响Quartz的行为。

@DisallowConcurrentExecution注释,可以添加到job类上,通知Quartz不要同时执行给定的job定义(引用给定的job类)的多个实例。在上一个例子中,如果SalesReportJob用了这个注解,在给定时间将只能执行SalesReportJob的一个实例,但是它可以同时执行“SalesReportForMike”的一个实例。约束是基于实例的定义(JobDetail),而不是job类的实例。然而,它决定了注解参与到类本身中(在Quartz设计时),因为它对类如何编码产生影响。

@PersistJobDataAfterExecution注释可以添加到job类,通知Quartzexecute()方法成功执行后更新JobDetailJobDataMap的拷贝,这样相同的job下一次执行时接收到更新的值,而不是原来存储的值。和@DisallowConcurrentExecution注解一样,应用到job定义的实例上,而不是job类的实例,虽然它给job类带来了属性,因为它对类如何编码产生影响。(例如,有状态性需要明确理解执行方法的代码)。

如果你使用@PersistJobDataAfterExecution注解,您还应该考虑使用@DisallowConcurrentExecution注解,以避免可能的混乱(竞争条件)的数据被存储在相同的工作的两个实例(JobDetail)并发执行。

Job的其他属性

这里有你可以通过JobDetail对象定义job实例的另一些属性的快速总结:

持久性——如果一个job不是持久的, 一旦不再有任何活动的与之关联的trigger它将自动从scheduler删除。换句话说,不持久的job的生命周期依赖于它的trigger的存在。

RequestsRecovery——如果一份工作“请求恢复”,scheduler强制关闭期间执行(即进程是运行崩溃,或机器关闭),在scheduler再次启动时会重新执行。在这种情况下,JobExecutionContext.isRecovering()方法将返回true

JobExecutionException

最后,我们需要告诉你Job.execute(..)一些细节。唯一类型的异常(包括RuntimException),你可以从执行方法抛出JobExecutionException。因此,你通常应该使用“rycatch”块包裹执行方法。你也应该花些时间看着JobExecutionException的文档,因为你的job可以使用它提供scheduler作为你想如何处理异常的各种指令。


 

使用trigger

Trigger

job一样,trigger容易处理,但是他们有不同的定制项,在你充分使用Quartz之前需要了解它们。

不同类型的trigger用来满足不同的调度需求。常用的有两种,SimpleTriggerCronTrigger。关于这些特定触发器的细节在第10使用trigger”

通用的trigger属性

除了所有的触发器都有TriggerKey属性作为追踪它们的标识符外,它们还有很多通用的其它属性。当你创建trigger定义时你可以使用TriggerBuilder设置这些通用的属性(如下示例)。

这是通用的触发器类型:

l  属性jobKeytrigger触发将要执行的job的标识。

l  startTimetrigger的计划第一次生效的标识。值是一个java.util.Date对象,定义了一个给定的日期时间。对于许多类型的trigger来说,trigger应该在开始时间准确的启动。对于其它类型来说标志着scheduler开始被追踪。这意味着你可以这样存储一个schedulertrigger,例如一月每月的第5天执行,如果startTime属性设置为41日,在首次触发前,还要过几个月。

l  endTime属性表示trigger的计划不再有效。换句话说,一个每月5triggerendTime71号,它上次执行的时间就是65号。

其它属性,还有更多的解析,将在下面讨论。

优先级

有时,当你有很多触发器(或者你得Quartz线程池有很多工作线程),Quartz也许没有足够的资源在同一时间触发所有的trigger。这种情况下,你也许想控制你的哪些触发器可以优先获得Quartz的工作线程。为此,你需要设置trigger的优先级属性。如果N个触发器同一时间触发,但是当前仅有Z和可用的工作线程,前Z个具有高优先级的触发器将首先执行。

任何整数,正数或者负数都允许作为优先级。如果你的trigger没有设定优先级它将使用默认的优先级为5

注意:优先级仅仅在同一时间触发的trigger中才有效。一个在10:59触发的trigger将永远比在11:00触发的trigger先执行。

注意:当触发器被监测到需要恢复时,它的优先级将与原始的优先级相同。

触发失败说明

Trigger另一个重要的属性就是过时触发指令。如果因为当前scheduler被关闭或者Quartz的线程池没有可用的线程用来执行job导致当前的触发器错过了触发时间,就是出现错误。

不同类型的trigger有不同的失败处理方式。默认情况下,它们使用智能策略,其拥有基于trigger类型和配置的动态行为。Scheduler启动时,它将搜索所有失败的持久化的trigger,然后基于它们的失败配置来更新它们。

当你在你的项目中使用Quartz,一定要熟悉它们javaDoc中给定trigger的失败处理策略。更多关于特殊trigger类型的失败策略在第10页“使用trigger”也有提供。

日历

Quartz日历对象(不是java.util.Calendar对象)能够与在scheduler中定义和存储的trigger时间相关联。

日历可用于从trigger的触发计划中排除时间块。例如,你可以创建一个trigger在工作日的9:30触发,但是排除法定假日。

日历可以使任何实现了Calendar接口的序列化对象(如下所示):

package org.quartz;

publicinterface Calendar {

     publicboolean isTimeIncluded(long timeStamp);

     publiclong getNextIncludedTime(long timeStamp);

}

注意这些方法的参数类型是long。这是毫秒的时间戳格式。这意味着日历可以“阻挡”精确至一毫秒的时间。最有可能的是你会对“屏蔽”一整天感兴趣。Quartz包括一个org.quartz.impl.HolidayCalendar就是干这个的,非常方便。

日历必须通过addCalendar(..)方法实例化并注册到scheduler中。如果你使用HolidayCalendar,实例化之后,你应该使用它的addExcludedDate(Date date)方法将你想排除在调度器之外的日期添加进去。同一个日历实例可以被多个trigger使用,如下所示:

         HolidayCalendar cal = new HolidayCalendar();

         cal.addExcludedDate(someDate);

         cal.addExcludedDate(someOtherDate);

         sched.addCalendar("myHolidays", cal, false);

         Trigger t = new Trigger()

                   .withIdentity("myTrigger")

                   .forJob("myJob")

                   .withSchedule(dailyAtHourAndMinute(9, 30)) // execute job daily at 9:30

                   .modifiedByCalendar("myHolidays") // but not on holidays

                   .build();

         // .. schedule job with trigger

         Trigger t2 = new Trigger()

                   .withIdentity("myTrigger2")

                   .forJob("myJob2")

                   .withSchedule(dailyAtHourAndMinute(11, 30)) // execute job daily at 11:30

                   .modifiedByCalendar("myHolidays") // but not on holidays

                   .build();

         // .. schedule job with trigger2

上面的代码创建了两个触发器,每天都会执行。然而,任何发生在排除日历的触发将被跳过。

org.quartz.impl.calendar包提供了许多Calendar的实现,也许可以满足你的需求。

SimpleTrigger

如果你需要一个job在特定的时间执行一次或者在特定的时间,以特定的间隔执行多次SimpleTrigger能够满足你的需求。例如:你想让一个trigger201511311:23:54分触发,或者你想在那个时间执行,执行5次,每10秒一次。

这样描述,你也许不难发现SimpleTrigger的属性:开始时间,结束时间,重复次数,重复间隔。所有这些属性正是你期望的,只有一组与结束时间关联的特殊属性。

重复的次数可以是0,正数或者常数SimpleTrigger.REPEAT_INDEFINITELY。重复的间隔属性必须是0或一个正的长整型,代表毫秒值。注意,间隔为0将导致触发器同时触发“重复次数”这么多次(尽可能接近scheduler的并发管理数)。

如果你还不熟悉QuartzDateBuilder类,你可能发现依赖于你的开始时间(或结束时间)计算trigger的触发次数很有帮助。

endTIme属性重写了重复次数的属性。如果你想创建一个每10秒触发一次的trigger直到一个给定的时刻,这也许会有用。而不必计算开始时间和结束时间间的重复次数,你可以简单的指出结束时间然后使用REPEAT_INDEFINITELY表明重复次数(你甚至可以指定较大的重复次数超过在结束时间到达之前trigger触发的次数)。SimpleTrigger实例通过使用TriggerBuilder(创建trigger的主属性)和SimpleSchedulerBuilder(创建SimpleTrigger特殊属性)创建。使用静态导入DSL-style使用这些构造工具。

import static org.quartz.TriggerBuilder.*;

import static org.quartz.SimpleScheduleBuilder.*;

import static org.quartz.DateBuilder.*:

使用不同的Scheduler定义trigger的例子

下面是使用简单的scheduler定义触发器的一些例子。仔细观察,它们每个至少展示了一个新的/不同的点。

同时,花费一些时间查看TriggerBuilderSimpleSchedulerBuilder定义的所有可用方法以便熟悉这里的示例没展示但是你可能会使用到的选项。

注意:注意如果你不显示的设置属性TriggerBuilder(和其它的quartz创建者)会选取一个合理的值。例如,如果你不调用withIdentity(..)的某个方法,TriggerBuilder将为你的trigger生成一个随机的名字,同样,如果你没有调用startAt(..),则设定为当前的时间(立即执行)。

创建一个指定时间执行的trigger,没有重复次数

         SimpleTrigger trigger = (SimpleTrigger) new Trigger()

                   .withIdentity("trigger1", "group1")

                   .startAt(myStartTime) // some Date

                   .forJob("job1", "group1") // identify job with name, group strings

              .build();

在指定的时间创建一个trigger,然后每10秒触发一次,共触发10

         trigger = new Trigger()

                   .withIdentity("trigger3", "group1")

                   .startAt(myTimeToStartFiring) // if a start time is not given (if this line  were omitted), "now" is implied

                   .withSchedule(simpleSchedule().withIntervalInSeconds(10).withRepeatCount(10)) // note that 10 repeats will give a total of 11 firings

                   .forJob(myJob) // identify job with handle to its JobDetail itself

                   .build();

创建一个触发一次的trigger5分钟后触发

         trigger = (SimpleTrigger) new Trigger()

                   .withIdentity("trigger5", "group1")

                   .startAt(futureDate(5, IntervalUnit.MINUTE)) // use DateBuilder to create a date in the future

                   .forJob(myJobKey) // identify job with its JobKey

                   .build();

创建一个立即触发的trigger,每5分钟触发一次,直到22:00结束

         trigger = new Trigger().withIdentity("trigger7", "group1")

                   .withSchedule(simpleSchedule().withIntervalInMinutes(5).repeatForever())

                   .endAt(dateOf(22, 0, 0))

              .build();

建立一个trigger,每小时开始的时候触发,每2小时出发一次,直到永远

         trigger = new Trigger()

                   .withIdentity("trigger8") // because group is not specified, "trigger8" will be in the default group

                   .startAt(evenHourDate(null)) // get the next even-hour (minutes and seconds zero ("00:00"))

                   .withSchedule(simpleSchedule().withIntervalInHours(2).repeatForever())// note that in this example, 'forJob(..)' is not called - which is valid if the trigger is passed to the scheduler along with the job

                   .build();

         scheduler.scheduleJob(trigger, job);

SimpleTrigger失败说明

SimpleTrigger有几个指令,用来通知quartz当触发失败该怎么做。(关于trigger触发失败的信息,参见trigger章节)这些指令被SimpleTrigger自己定义(它们的行为在Javadoc中有描述)。这些常量包括:

MISFIRE_INSTRUCTION_IGNORE_MISFIRE_POLICY

MISFIRE_INSTRUCTION_FIRE_NOW

MISFIRE_INSTRUCTION_RESCHEDULE_NOW_WITH_EXISTING_REPEAT_COUNT

MISFIRE_INSTRUCTION_RESCHEDULE_NOW_WITH_REMAINING_REPEAT_COUNT

MISFIRE_INSTRUCTION_RESCHEDULE_NEXT_WITH_REMAINING_COUNT

MISFIRE_INSTRUCTION_RESCHEDULE_NEXT_WITH_EXISTING_COUNT

所有的trigger都有MISFIRE_INSTRUCTION_SMART_POLICY属性可以使用,这个指定对所有的触发器类型都是可用的。

如果使用智能策略SimpleTrigger会基于给定SimpleTrigger实例的配置或语句之间动态的选择触发失败指令。SimpleTrigger.updateAfterMisfire()方法的Javadoc解释了这些动态行为的细节。

在创建SimpleTrigger时,你可以指定失败指令作为简单scheduler的一部分(通过SimpleSchedulerBuilder):

         trigger = new Trigger()

                   .withIdentity("trigger7", "group1")

              .withSchedule(simpleSchedule().withIntervalInMinutes(5).repeatForever().withMisfireHandlingInstructionNextWithExistingCount())

              .build();

CronTriggers

Cron是一个UNIX工具,已经存在了很长时间,所以它的调度功能强大且得到证实。CronTrigger类是基于cron的调度功能。

CronTrigger使用“cron表达式,其能够像这样创建触发的计划:每周一至周五早上8:00”或者每月最后一个周五早上1:30”

如果你需要基于类似日历的观念反复触发一个job,而不是使用SimpleTrigger指定一个固定的时间间隔,相对于SimpleTriggerCronTrigger往往更有用。

使用CronTrigger,你可以指定一个触发计划例如每周五的中午,或者每个工作日上午9:00”,甚至“1月的周一,周三和周五早上9:0010:00每五分钟

即便如此,和SimpleTrigger一样, CronTrigger也有一个startTime指定计划的生效时间也有一个(可选的)endTime指定计划的停止时间。

Cron表达式

Cron表达式用于CronTrigger实例的配置。Cron表达式实际上是由7个子表达式组成,用来描述计划安排的细节。这些子表达式使用空格分割:

l 

l 

l 

l  每月的第几天

l 

l  每周的第几天

l  年(可选字段)

一个完整的cron表达式是一个像这样的字符串“0 0 12 ? WED *”——这代表着每周三的12:00”

每个子表达式都能包含范围/或列表,例如前面每周的第几天(“WED”)可以替换成“MON-FRI”,“ MON,WED,FRI”,甚至“MON-WED,SAT”。

可使用通配符(“*”)代表这个字段上的每一个可能的值。因此“月”字段上使用“*”代表着“每个月”。“*”在“每周的第几天”代表“一周的每一天”。

所有的字段都可以指定一个有效值。这些值应该相当明显,例如数字0-59代表秒数和分钟数,0-23代表小时。每月中的第几天可能是1-31,但是你应该注意一个指定的月份应该有多少天!月份可以指定0-11,或者使用字符串JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOVDEC。每周的第几天可以使用1-71=周日)或者使用字符串SUN, MON, TUE, WED, THU, FRISAT

“/”符号被用来指定增量值。例如,如果你在分钟字段设置“0/15”,意味着0分开始,每15分钟。如果你在分钟字段使用“3/20”,意味着从第3分钟开始,每20分钟”——换句话说它和在分钟字段上指定“3,23,43”是一样的。注意“/35”并不是35分钟”——它是指0开始,每35分钟——换句话说就和“0,35”一样。

“?”允许在每月中的第几天和每周的第几天上设置。它用于指定无特殊值。当你需要在这两个字段之一指定一些值,但不能同时设置。具体参见下面示例(和CronTrigger Javadoc)。

“L”允许在每月的第几天和每周的第几天上设置。这个符号是“last”的简写,但是它在这两个字段上的意思是不同的。例如,“L”在每月的第几天字段上指的是每月的最后一天”——131号,和非闰年的228号。如果用在每周的第几天,就是“7”或者“SAT”的意思。但是如果用在每周第几天的一个值后面,就意味着“每月最后一个星期的第几天”——例如“6L”或者“FRIL”都表示“每月最后一个周五”。你还可以为每月的最后一天指定一个偏移量,例如“L-3”意味着每月倒数第三天。当使用“L”选项时,重要的是不要指定列表或范围值,不然你将得到混乱/不期望的结果。

“W”用于指定距离给定日期最近的一个工作日(周一至周五)。例如,如果你在每月的第几天字段上指定“15W”,意味着:离本月15号最近的工作日

“#”用于指定每月中的第几个周几。例如,在每周的第几天设置“6#3”或者“FRI#3”表示本月第三个周五

格式

字段如下:

字段名称

必填项

允许的值

允许的特殊字符

Seconds

YES

0-59

, - *

Minutes

YES

0-59

, - *

Hours

YES

0-23

, - *

Day of month

YES

1-31

, - * ? / L W

Month

YES

1-12JAN-DEC

, - *

Day of week

YES

1-7SUN-SAT

, - * ? / L #

Year

NO

空值,1970-2099

, - *

最简单的cron表达式可以写成:* * * * ? *

或者比较复杂的:0/5 14,18,3-39,52 * ? JAN,MAR,SEP MON-FRI 2002-2010

特殊字符

l  *(所有值)——用来选择一个字段上的所有值。例如:分钟字段上的“*”表示“每分钟”。

l  ?(无特定值)——当你需要在允许的两个字段中的一个指定一些值的时候使用。例如,你想让你得trigger在每月的某一天触发(假如,10号),但是不关系在周几发生,你应该在每月的第几天字段上设置“10”,在每周的第几天字段上设置“?”。具体参见下面实例。

l  -——用于指定范围。例如,小时字段上设置“10-12”表示“10点,11点,12

l  ,——用于指定额外的值。例如,在每周的第几天设置“MON,WED,FRI”表示“周一,周三,周五”。

l  /——用于指定增量。例如,秒字段上“0/15”表示“0秒,15秒,30秒,45秒”。秒字段上“5/15”表示“5秒,20秒,35秒,50秒”,你还可以在“character - in this case”后面指定“/”,相当于“/”前有一个“0”,每月中的第几天设置“1/3”表示“从每月的第一天开始每3天触发一次”。

l  L(“last”简写)——可用在两个字段每个子段的含义不同。例如,“L”在每月的第几天字段上指的是“每月的最后一天”——131号,和非闰年的228号。如果用在每周的第几天,就是“7”或者“SAT”的意思。但是如果用在每周第几天的一个值后面,就意味着“每月最后一个星期的第几天”——例如“6L”表示“每月最后一个周五”。你还可以为每月的最后一天指定一个偏移量,例如“L-3”意味着每月倒数第三天。当使用“L”选项时,重要的是不要指定列表或范围值,不然你将得到混乱/不期望的结果。

l  W(工作日)——用来指定距离指定日期最近的工作日(周一至周五)。例如,如果你指定了“15W”在每月第几天的字段上,表示:“离本月15号最近的工作日”。所以,如果15号是周六,trigger将在14号周五触发,如果15号是周日,trigger将在16号周一触发,如果15号是周二,trigger将在15号周二触发。然而如果在每月的第几天字段指定“1W”,而且1号是周六,trigger将会在3号周一触发,它不会跳过月的边界。“W”只能指定每月第几天字段中的一天,不能指定一个范围或列表。

l  “L”“W”字符也可以在每月的第几天字段组合成“LW”,表示每月的最后一个工作日

l  #——用于指定每月中的第几个周几。例如,每周第几天字段上的“6#3”表示每月的第3个周五”6“=周五,”#3“=每月的第3个)。另一个例子:”2#1“=每月的第1个周一,”4#5“每月的第5个周三。注意,如果你指定”#5”,但是该月没有第5个这一周的天数,触发器将不会执行。

注意:月份的英文名和周几的英文是不区分大小写的。MONmon都是合法的字符。

示例

这里有一些完整的示例:

表达式

含义

0 0 12 * * ?

每天12:00触发

0 15 10 ? * *

每天10:15触发

0 15 10 * * ?

每天10:15触发

0 15 10 * * ? *

每天10:15触发

0 15 10 * * ? 2005

2005年的每天10:15触发

0 * 14 * * ?

每天14:0014:59每分钟触发

0 0/5 14 * * ?

每天14:00开始至14:555分钟触发

0 0/5 14,18 * * ?

每天14:00开始至14:555分钟触发,18:00开始至18:555分钟触发

0 0-5 14 * * ?

每天14:00开始至14:05每分钟触发

0 10,44 14 ? 3 WED

三月份的每个周三14:1014:44触发

0 15 10 ? * MON-FRI

每个周一至周五上午10:15触发

0 15 10 15 * ?

每月1510:15触发

0 15 10 L * ?

每月最后一天10:15触发

0 15 10 L-2 * ?

每月倒数第210:15触发

0 15 10 ? * 6L

每月最后一个周五10:15触发

0 15 10 ? * 6L 2002-2005

2002年至2005年每月最后一个周五10:15触发

0 15 10 ? * 6#3

每月第3个周五10:15触发

0 0 12 1/5 * ?

每月的第一天开始,每个第512:00触发

0 11 11 11 11 ?

每年111111:11触发

注意”?””*”在每周第几天和每月第几天字段上的影响。

注意

l  支持不需要完全指定一周中的第几天和一月中的第几天(你必须在这两个字段之一使用”?”号)。

l  当设置触发时间在凌晨时注意那些实行夏令时的地区(在美国,时间通常会提前或推后到凌晨2点——因为依赖于时间向前或向后改变会跳过或重复执行触发器。你可以从*查看你的使用环境:https://secure.wikimedia.org/wikipedia/en/wiki/Daylight_saving_time_around_the_world

创建CronTrigger

使用TriggerBuilder(创建trigger的主属性)和CronScheduleBuilder(创建CronTrigger特殊属性)创建CronTrigger实例。用DSL-style使用这些构造类,使用静态导入:

import static org.quartz.TriggerBuilder.*;

import static org.quartz.CronScheduleBuilder.*;

import static org.quartz.DateBuilder.*:

创建一个每天8:0017:00,每分钟执行一次的触发器

         trigger = new Trigger()

                   .withIdentity("trigger3", "group1")

                   .withSchedule(cronSchedule("0 0/2 8-17 * * ?"))

                   .forJob("myJob", "group1").build();

创建一个每天10:42触发的触发器

         trigger = new Trigger()

                   .withIdentity("trigger3", "group1")

                   .withSchedule(dailyAtHourAndMinute(10, 42))

              .forJob(myJobKey)

.build();

         trigger = new Trigger()

                   .withIdentity("trigger3", "group1")

                   .withSchedule(cronSchedule("0 42 10 * * ?"))

                   .forJob(myJobKey)

              .build();

创建一个触发器将在周三10:42触发,基于系统默认的时区

         trigger = new Trigger()

                   .withIdentity("trigger3", "group1")

                   .withSchedule(weeklyOnDayAndHourAndMinute(DateBuilder.WEDNESDAY, 10, 42))

                   .forJob(myJobKey)

                   .inTimeZone(TimeZone.getTimeZone("America/Los_Angeles"))

              .build();

         trigger = new Trigger()

                   .withIdentity("trigger3", "group1")

                   .withSchedule(cronSchedule("0 42 10 ? * WED"))

                   .inTimeZone(TimeZone.getTimeZone("America/Los_Angeles"))

                   .forJob(myJobKey)

              .build();

CronTrigger失败说明

下面的说明可以在CronTrigger失败时用来介绍Quartz信息。(更多关于trigger失败的情况介绍在教程中)。这些介绍是CronTrigger自己定义的常量(包括Javadoc描述的行为)。包括:

MISFIRE_INSTRUCTION_IGNORE_MISFIRE_POLICY

MISFIRE_INSTRUCTION_DO_NOTHING

MISFIRE_INSTRUCTION_FIRE_NOW

所有的trigger都有MISFIRE_INSTRUCTION_SMART_POLICY说明可供使用,这个说明也是所有trigger类型默认的。智能策略CronTrigger解读为“MISFIRE_INSTRUCTION_FIRE_NOWCronTrigger.updateAfterMisfire()方法的Javadoc解析了这些行为的细节。

在构建CronTrigger时,你可以(通过CronSchedulerBuilder)指定简单schedule的失败说明。

         trigger = new Trigger()

                   .withIdentity("trigger3", "group1")

                   .withSchedule(cronSchedule("0 0/2 8-17 * * ?")

                   .withMisfireHandlingInstructionFireAndProceed())

                   .forJob("myJob", "group1")

              .build();


 

使用TriggerListenerJobListener

TriggerListenerJobListener

监听器是你基于scheduler中事件的活动创建的对象。就像它们名字所示,TriggerListener接收与trigger有关的事件,JobListener接收与Job有关的事件。

trigger有关的事件包括trigger触发,trigger触发失败(在第10页“使用trigger”中讨论),trigger执行完成(trigger完成job执行完毕)。

org.quartz.TriggerListener接口

publicinterface TriggerListener {

     public String getName();

 

     publicvoid triggerFired(Trigger trigger, JobExecutionContext context);

 

     publicboolean vetoJobExecution(Trigger trigger, JobExecutionContext context);

 

     publicvoid triggerMisfired(Trigger trigger);

 

     publicvoid triggerComplete(Trigger trigger, JobExecutionContext context, inttriggerInstructionCode);

}

job有关的时间包括:job即将进行的通知,和job已经完成的通知。

org.quartz.JobListener接口

publicinterface JobListener {

     public String getName();

 

     publicvoid jobToBeExecuted(JobExecutionContext context);

 

     publicvoid jobExecutionVetoed(JobExecutionContext context);

 

     publicvoid jobWasExecuted(JobExecutionContext context, JobExecutionException jobException);

}

创建你自己的监听器

要创建一个监听器,需要简单创建一个实现org.quartz.TriggerListener接口或/org.quartz.JobListener接口的对象。

然后在运行时监听器被注册到scheduler中,并且必须给定一个name(或者确切的说,它们必须能够通过它们的getName()方法给出它们的名字)。

为了你的方便,而不需要实现这些接口,你的类还可以继承JobListenerSupportTriggerListenerSupport并简单的重写你感兴趣的方法。

监听器被schedulerListenerManager注册与Matcher一起描述Job/Trigger的监听器想要接受的事件。

注意:监听器在运行时被注册到scheduler,而不是一直随jobtrigger存储在JobStore中。这是因为监听器通常作为你的应用程序的一个集成点。因此,你的应用每次运行,监听器都需要重新注册进scheduler

添加监听器的代码示例

下面的示例演示了将感兴趣的JobListener添加进不同类型的job中。以同样的方式添加可用的TriggerListener

添加一个感兴趣的JobListener到特定的job

scheduler.getListenerManager().addJobListener(myJobListener,KeyMatcher.jobKeyEquals(new JobKey("myJobName", "myJobGroup")));

你可能想使用静态导入导入matcherkey类,这将使你清晰的匹配matcher

import static org.quartz.JobKey.*;

import static org.quartz.impl.matchers.KeyMatcher.*;

import static org.quartz.impl.matchers.GroupMatcher.*;

import static org.quartz.impl.matchers.AndMatcher.*;

import static org.quartz.impl.matchers.OrMatcher.*;

import static org.quartz.impl.matchers.EverythingMatcher.*;

...etc.

上面的例子将变成:

scheduler.getListenerManager().addJobListener(myJobListener,jobKeyEquals(jobKey("myJobName", "myJobGroup")));

添加一个感兴趣的JobListener到一个指定group的所有job

scheduler.getListenerManager().addJobListener(myJobListener, jobGroupEquals("myJobGroup"));

添加一个感兴趣的JobListener到两个指定的group的所有job

scheduler.getListenerManager().addJobListener(myJobListener, or(jobGroupEquals("myJobGroup"), jobGroupEquals("yourGroup")));

添加一个感兴趣的JobListener到所有job

scheduler.getListenerManager().addJobListener(myJobListener, allJobs());


 

使用SchedulerListener

SchedulerListener

SchedulerListenerTriggerListenerJobListener很像,除了其接收Scheduler自身事件的通知,而不必与特定的triggerjob相关联。

在大量的其他事件中,Scheduler关联的事件包括:

l  添加一个jobtrigger

l  移除一个triggerjob

l  Schduler中的一系列错误

l  Schduler的关闭

SchedulerListenerschedulerListenerManager注册。SchdulerListner几乎可以是任何实现org.quartz.SchedulerListener接口的对象。

org.quartz.SchedulerListener接口

publicinterface SchedulerListener {

     publicvoid jobScheduled(Trigger trigger);

 

     publicvoid jobUnscheduled(String triggerName, String triggerGroup);

 

     publicvoid triggerFinalized(Trigger trigger);

 

     publicvoid triggersPaused(String triggerName, String triggerGroup);

 

     publicvoid triggersResumed(String triggerName, String triggerGroup);

 

     publicvoid jobsPaused(String jobName, String jobGroup);

 

     publicvoid jobsResumed(String jobName, String jobGroup);

 

     publicvoid schedulerError(String msg, SchedulerException cause);

 

     publicvoid schedulerStarted();

 

     publicvoid schedulerInStandbyMode();

 

     publicvoid schedulerShutdown();

 

     publicvoid schedulingDataCleared();

}

添加一个SchedulerListener

scheduler.getListenerManager().addSchedulerListener(mySchedListener);

移除一个SchedulerListener

scheduler.getListenerManager().removeSchedulerListener(mySchedListener);


 

使用JobStore

关于JobStores

JobStore负责保存你给定的schduler所有的数据:jobtriggercalendar等等。

为你的Quartz scheduler实例在一些重要的步骤选择合适的JobStore。一旦你搞清楚它们之间的不同是很容易的。你声明哪种JobStore根据你的scheduler应该使用属性文件中你提供给你用来生成你的scheduler实例的SchedulerFactory

你在属性文件(或对象)中声明你的scheduler应该使用哪种JobStore (和其配置设置),你将其提供给你用来生成scheduler实例的SchedulerFactory

重点:不要再代码中直接使用你的JobStore实例。JobStoreQuartz自己后台用的。你必须让Quartz(通过配置)知道使用哪种JobStore。之后,你只需在你的代码中使用Scheduler实例。

RAMJobStore

RAMJobStore是使用JobStore最简单的方式。它也提供了最好的性能(在CPU时间上)。

RAMJobStore就如它的名字所示,将它的数据保存在RAM中。这也是为什么它快速以及容易配置的原因。

使用RAMJobStore的缺点是,当你的应用程序结束(或者崩溃)后,Scheduler的所有信息都会丢失。因此,RAMJobStore不能担任jobtrigger持久化设置。对于某些应用来说,这是可以接受的,甚至是所需要的行为,但是对于另一些应用,可能就是灾难性的。

使用RAMJobStore(假如你使用StdSchedulerFactory)简单的设置org.quartz.jobStore.class属性到org.quartz.simpl.RAMJobStore如下所示:

org.quartz.jobStore.class = org.quartz.simpl.RAMJobStore

没有你需要关心的其他设置。

JDBCJobStore

JDBCJobStore通过JDBC将所有的数据保存到数据库中,因为它使用数据库,它比RAMJobStore配置更复杂,而且不是那么快。然后,性能的缺点并不是很糟,特别是你建立了数据表上的主键之后。现代的机器配置在相当好的局域网中(在Schedulerdatabase之间)接收和更新一个trigger通常小于10毫秒。

JDBCJobStore适用于几乎任何数据库,它已经广泛应用于oraclePostgreSQLMySQLMS SQL ServeHSQLDBDB2

使用JDBCJobStore,你必须首先创建一个Quartz使用的数据表。你可以在Quartz的发布包的“docs/dbTables”目录下找到创建表的SQL脚本。如果没有你的数据库的脚本,找一个已经存在的修改成你的数据库需要的形式。

注意,在脚本中所有的表都以前缀” QRTZ_ “开头(例如”QRTZ_TRIGGERS”, “QRTZ_JOB_DETAIL”)。这个前缀可以是你想要的任何方式(在你的Quartz属性文件中)。创建不同的前缀可能用于在同一个数据库创建多个scheduler实例,创建多个表。

一旦你创建了表,你需要决定你的应用需要哪种类型的事务。如果你不需要把你的调度命令(如添加和删除trigger)连接到其它的事务上,你可以使用JobStoreTX作为你的JobStoreQuartz管理这些事务(这是最常见的选择)。

如果你需要Quartz和其它事务一起工作(例如,使用J2EE应用服务),你应该使用JobStoreCMT,这种情况下Quartz会让应用服务器管理事务。

最后,你必须设置一个数据源将JDBCJobStore连接到你的数据库。数据源可以在你的Quartz属性文件中使用多种方式之一设置。一种方法就是将数据库的所有连接信息提供给QuartzQuartz自己创建管理数据源。另一种就是Quartz使用Quartz运行时的应用服务器管理的数据源。你可以通过JNDI的名称提供数据源。关于属性更详细的信息,请参考“docs/config”目录下的配置文件。

使用JDBCJobStore(假设你使用StdSchedulerFactory)首先需要设置Quartz配置的JobStore类属性如下列之一:

l   org.quartz.impl.jdbcjobstore.JobStoreTx

l  org.quartz.impl.jdbcjobstore.JobStoreCMT

你的选择基于上面一段的解释。

下面的例子展示了如何配置JobStoreTx:

org.quartz.jobStore.class = org.quartz.impl.jdbcjobstore.JobStoreTX

接下来,你需要选择一个DriverDelegateJobStore使用。驱动代理也许需要为你的特定的数据库负责做任何JDBC的工作。

StdJDBCDelegate是一个使用” vanilla”JDBC代码(和SQL语句)来完成工作的代理。如果没有一个特定于你的数据库的代理,就是用这个代理。Quartz为那些使用StdJDBCDelegate不能够操作很好的数据库提供了一些特定的代理。那些代理可以在org.quartz.impl.jdbcjobstore包或其子包下找到。这些代理包括DB2v6Delegate(为了DB26版或更早的版本),HSQLDBDelegate(为了HSQLDB),MSSQLDelegate(为了微软SQLServer),PostgreSQLDelegate(为了PostgreSQL),WeblogicDelegate(为了使用Weblogic创建的JDBC驱动),OracleDelegate(为了使用Oracle),等等。

一旦你选择了你的代理,设置它的类名作为代理供JDBCJobStore使用。

下面的实例展示了如何配置JDBCJobStore去使用DriverDelegate:

org.quartz.jobStore.driverDelegateClass = org.quartz.impl.jdbcjobstore.StdJDBCDelegate

接下来,你需要通知JobStore你使用的前缀(如上所示)。

下面的例子展示了如何配置JDBCJobStore的表前缀:

org.quartz.jobStore.tablePrefix = QRTZ_

最后,你需要设置JobStore使用哪种数据源。已命名的数据源也要在你得Quartz属性中定义。这种情况下,我们指定Quartz应该使用的数据源名为“myDS”(即在配置属性中定义)。

org.quartz.jobStore.dataSource = myDS

提示:如果你的scheduler很繁忙,意味着其总是执行与线程池大小一样的job数,那么你应该将数据源的连接数设置为线程池的大小+2

提示:org.quartz.jobStore.useProperties的属性可以设置为true(默认为false),通知JDBCJobStoreJobDataMaps中的所有的值转成字符串,因此能够存成键值对的形式,而不是将更复杂的对象以序列化的形式存储在BLOB列中。长期来看这安全多了,因为你避免了从非字符串对象类序列化到BLOB的类版本问题。

TerracottaJobStore

TerracottaJobStore为无需使用数据库进行扩展和鲁棒性提供了手段。这意味着你的数据库可以与Quartz保持*的加载,反而可以将它的所有资源保存为你的应用的一部分。

TerracottaJobStore能够在集群或者非集群上运行,这两种情况下为你的job数据持久化在应用重启时提供了存储介质,因为数据存储在Terracotta server上。它的性能比通过JDBCJobStore使用一个数据库要慢(大概好一个数量级),但是比RAMJobStore要慢。

在你的Quartz配置中简单的设置org.quartz.jobStore.class属性为org.terracotta.quartz.TerracottaJobStore就可以使用TerracottaJobStore,还需要添加一个额外的属性到Terracotta server上:

org.quartz.jobStore.class = org.terracotta.quartz.TerracottaJobStore

org.quartz.jobStore.tcConfigUrl = localhost:9510

关于TerracottaJobStore的更多信息,参见Terracotta Quartz用户手册。


 

配置,Scheduler Factory和日志

配置组件

Quartz的体系结构是模块化的,因此想运行它需要把几个组建结合在一起。幸运的是,有很多已存在的助手完成这件事。

Quartz能工作之前的主要需要配置的组件是:

l  ThreadPool

l  JobStore

l  数据源 (如果必须的话)

l  Scheduler

ThreadPoolQuartz执行job提供了一组线程。线程池中的线程越多,可以同时执行的job就越多。然而,太多的线程将会拖慢你的系统。大多数Quartz使用者发现大约5个线程就足够了。因为他们做任何时间给定的job数都少于100job通常不会同时执行,而且job运行时间很短(完成很快)。

其他用户发现他们需要1550或者100个线程,因为他们各种各样的schduler有成千上万的trigger,最终在任何时刻平均有10100job在执行。

找到正确的scheduler池的大小完全依赖于你使用scheduler做什么。没有真正的规则可循,除了尽可能小的保持线程数(参考你的机器资源)。不过,你要确保你要确保你的job能够准时触发。注意,如果一个trigger时间到了,但是没有足够的可用线程,Quartz将会冻结(暂停)直到有一个可用的线程,那么job将会比它应该执行的时间晚一些。如果在scheduler配置了“失败阀值”期间没有可用线程,这甚至会导致线程失败。

ThreadPool接口的定义在org.quartz.spi包中,你可以使用你喜欢的任何方式创建ThreadPoolQuartz附带了一个简单的ThreadPoolorg.quartz.simpl.SimpleThreadPool。这个org.quartz.simpl.SimpleThreadPool.简单的维护一组固定的线程池,不会增加也不会减少。但是它十分健壮和有很好的测试。几乎每个使用Quartz的用户都是用它。

JobStoresDataSources的讨论在第23使用JobStores”。值得注意的是,所有的JobStores都实现了org.quartz.spi.JobStore接口,如果内置的JobStores不符合你得需求,你可以创建自己的。

最后,你需要创建你自己的scheduler实例。Scheduler实例需要给定一个名字,通知RMI设置,传入一个JobStore的实例和ThreadPoolRMI设置包括scheduler是否应该被创建成一个RMI的服务器对象(是其可用于远程连接),使用什么样的地址和端口等等。StdSchedulerFactory(下面讨论)也可以远程创建一个scheduler实例,实际上是一个代理(RMI stubs)。更多关于StdSchedulerFactory的信息,参见第26页的"Scheduler工厂"

Scheduler工厂

StdSchedulerFactoryorg.quartz.SchedulerFactory接口的一个实现。它使用一组属性(java.util.Properties)来创建Quartz Scheduler实例。这些属性通常从一个文件存储和加载,也可以由你的程序直接传给工厂。简单的调用工厂的getScheduler()将产生一个Scheduler,对其初始化(ThreadPool, JobStore和数据源)并返回它的公共接口的句柄。

有一些简单的配置示例(包括属性说明)在Quartz发布包的“docs/config”目录下。你可以在Quartz的示例程序和示例代码中找到完整的文档。

DirectSchedulerFactory

DirectSchedulerFactory是另一个SchedulerFactory实现。如果你想用更程序化的方法创建你自己的Scheduler实例,它会有帮助。基于下面两个原因一般不鼓励使用它:(1)它需要深入理解Scheduler2)它不允许使用配置(意味着你必须硬编码Scheduler的配置)。

日志

Quartz使用SLF4J框架满足日志需求。为了优化框架设置(例如输出数量,输出的地方),你需要理解SLF4J框架,这超出了本文范围。

如果你想获得trigger触发和job执行的详细信息,你可能对org.quartz.plugins.history.LoggingJobHistoryPlugin /org.quartz.plugins.history.LoggingTriggerHistoryPlugin感兴趣。


 

Quartz调度器的其他特性

插件

Quartz提供org.quartz.spi.SchedulerPlugin接口为插件提供附加功能。

org.quartz.plugins包中提供了Quartz附带插件各种实用功能的描述。

插件提供的功能,如scheduler启动后自动安排计划,记录jobtrigger事件的历史记录,确保在JVM关闭时scheduler关闭干净。

JobFactory

当触发器触发时,在scheduler中相关的job通过JobFactory配置被实例化。Job类上的JobFactory默认调用newInstance()。你也许想创建你自己的JobFactory实例完成一些事诸如在你的IoCDI容器中产生/初始化job实例。

观察org.quartz.spi.JobFactory接口,和相关的Scheduler.setJobFactory(fact)方法。

Factory自带Job

Quartz提供了大量实例的job,你可以在你的应用中实现诸如发送短信执行EJB之类的事。

你可以在org.quartz.jobs包中找到它们的文档

高级功能

集群

集群当前可以使用JDBC-Jobstore(JobStoreTXJobStoreCMT)TerracottaJobStore工作。包括负载平衡和故障转移功能(如果JobDetail请求复苏标志设置为true)。

使用JobStoreTXJobStoreCMT集群

通过设置org.quartz.jobStore.isClusteredtrue来使用集群。集群中的每个实例应该使用相同的quartz.properties文件,以下情况可以例外:线程池的大小不同,org.quartz.scheduler.instanceId的属性不同。集群中的每个节点必须有一个唯一的instanceId,通过设置“AUTO”作为属性值这很容易实现(不需要不同的属性文件)。

重点:不要在单独的机器上运行集群,除非它们非常定期的使用某种时间同步服务或守护进程同步它们的时钟(每个时钟相差在一秒内)。如果你不清楚怎么做,参见http://www.boulder.nist.gov/timefreq/service/its.htm

重点:不要在非集群实例上将多个运行的实例设置为相同的表设置。你可能得到损坏的数据,并得到不可预测的行为。

每次执行只有一个节点触发job。例如,如果job重复触发通知它每10秒触发一次,12:00:00有个节点会运行job12:00:10也会有一个节点将运行job。每次运行的节点不一定相同——会或多或少的随机选择运行的节点。负载均衡机制就是为繁忙的scheduler(很多trigger)接近随机调度,仅仅在scheduler不繁忙的时候(一两个trigger)容易使用同一个节点。

TerracottaJobStore集群

使用TerracottaJobStore简单的配置scheduler的描述在第25页“TerracottaJobStore”中,你得scheduler将被设置为集群。

你也要考虑你设置Terracotta server的影响,特别是那些功能选项,例如持久化,为HA运行的Terracotta server阵列。

TerracottaJobStore授权版提供了Quartz的高级特性,允许智能的为job目标提供合适的节点。

JTA事务

JobStoreCMT允许Quartz调度操作更大的JTA事务执行。

通过设置org.quartz.scheduler.wrapJobExecutionInUserTransactiontruejob也可以在JTA事务(用户事务)中执行。设置了这个选项,JTA事务将在job执行方法调用前执行begin(),在执行完成之后执行commit()。这适用于所有的job

如果你想标明每个job是否应该在JTA事务中执行,你应该在job类上使用@ExecuteInJTATransaction注解。

 

<END>

相关标签: Quartz 翻译