Quartz Job Scheduling Framework[翻译]第五章. Cron 触发器及相关内容 (第三部分)

四. 为 CronTrigger 使用起迄日期

Cron 表达式是用来决定一个 Trigger 被触发执行一个 Job 的日期和次数。当你创建一个 CronTrigger 实例,假如没为它指定一个开始时间,这个 Trigger 当然就会假定是在依赖于 Cron 表达式尽早的被触发。例如,如果你用这个表达式

0 * 14-20 * * ?

这个 Trigger 会在每天的从下午 2 点到下午的 7:59 间的每分钟触发一次。一旦你运行了这个表达式的 CronTrigger,假如当前是下午 2 点后(不能超过 7:59 PM--译者注),它将会立即触发。它会在每天无限期的被触发。

另一方面,倘若你希望这个计划直到下一天才开始,并且只执行两天,你就可以用 CronTriggersetStartTime()setEndTime() 方法来形成一个 "定时箱" 来触发。代码 5.2 描述了限定 CronTrigger 仅触发两天的例子。

代码 5.2. 你可以对 CronTrigger 用 startTime 和 endTime

代码 5.2 中的例子使用了 java.util.Calendar 来为 Trigger 选择一个开始和结束时间周期。在上面例子中,Trigger 将会在 Scheduler 启动后的下一天开始触发,并只在开始触发后的两天内有效。

使用 CronTrigger 的 startTimeendTime 属性的效果有点像 SimpleTrigger

五. 为 CronTrigger 使用 TriggerUtils

在第四章,"安排 Job" 中介绍了 org.quartz 包中的 TriggerUtils 类,它简化了两种类型的 Trigger 的创建。只要可能的话,你应该尝试用 TriggerUtils 类的方法来创建你的 Trigger。

例如,假如你需要在每天的下午 5:30 执行一个 Job,你可以用下面的代码:

或者你能用上 TriggerUtils,如下:

TriggerUtils 使得我们更简单方便的使用 Trigger,而又未放弃太多的灵活性。

六. 在 JobInitializationPlugin 中使用 CronTrigger

尽管我们要到第八章,"使用 Quartz 插件" 才会讲到插件,但还是值得提前展现一下 CronTrigger 如何应用于  quartz_jobs.xml 文件中来指定 Job 信息的。JobInitialzationPlugin 可用来从 XML 文件中加载 Job 的信息。

正如 SimpleTrigger 一样,你可在 XML 文件中指定 CronTrigger 的表达式,并且 Quartz 的 Scheduler 将会利用这一信息来安排你的 Job。这对于你想在你的程序代码之外声明你的 Job 信息时特别方便。代码 5.3 显示了 quartz_jobs.xml 文件内容,它被 JobInitializationPlugin  用来加作 Job 信息。

代码 5.3. CronTrigger 可在 XML 文件中指定,并由 JobInitializationPlugin 加载

代码  5.3 中的 Cron 表达式与 代码 5.1 中。当 Quartz 加载这个 XML 后,就会安排 PrintInfoJob (也已在 XML  中列出) 在从星期一到星期五的早上 7:30 执行。关于 JobInitializationPlugin 更多的说明见第八章。

本文链接 https://yanbin.blog/quartz-job-scheduling-framework-5-3/, 来自 隔叶黄莺 Yanbin Blog

[版权声明] Creative Commons License 本文采用 署名-非商业性使用-相同方式共享 4.0 国际 (CC BY-NC-SA 4.0) 进行许可。

Subscribe
Notify of
guest

10 Comments
Inline Feedbacks
View all comments
nesta
nesta
15 years ago

谢谢你,上次帮我解决一个问题。
1、如果我是在spring里面配置使用quartz,那我该怎么设置setStartTime和endTime。
2、假如我只想在不是节假日的时间内触发,像4月4日是清明节,国家规定放假,不做触发。当然我有一个表专门保存节假日。像这些动态的时间(每年的节假日国家规定可能不一样)我怎么和spring配置在一起使用呢?

再次感谢你的好文章。

隔叶黄莺
15 years ago

@nesta 看 Quartz Job Scheduling Framework[翻译]第四章. 部署 Job (第四部分) http://www.blogjava.net/Unmi/archive/2008/01/08/173066.html Quartz 还提供了一个 org.quartz.Calender 接口,可以用它来排除某些节假日,如下面的代码可让 job 在 7 月 4 日 不执行,exclude // Create an instance of the Quartz AnnualCalendar AnnualCalendar cal = new AnnualCalendar(); // exclude July 4th Calendar gCal = GregorianCalendar.getInstance(); gCal.set(Calendar.MONTH, Calendar.JULY); gCal.set(Calendar.DATE, 4); cal.setDayExcluded(gCal, true); // Add to scheduler, replace existing, update triggers scheduler. addCalendar("bankHolidays", cal, true, true); /* * Set up a trigger to start firing now, repeat forever * and have (60000 ms) between each firing. */ Trigger trigger = TriggerUtils.makeImmediateTrigger("myTrigger", -1,60000); // Trigger will use Calendar to exclude firing times trigger.setCalendarName("bankHolidays"); 至于 spring 中如何配置,要看看… Read more »

nesta
nesta
15 years ago

谢谢,我研究一把

nesta
nesta
15 years ago

@叶黄莺:
最近又遇到一个问题,为什么运行了一段时间后,不能触发了。。大概会是什么原因引起的呢?程序中没有报错。

隔叶黄莺
15 years ago

quartz.properties 中关于工作线程数量的设置设大一些,默认为10个

nesta
nesta
15 years ago

我一共配置了三个触发的,一个是每隔10秒执行一次,一个是每隔10分钟执行,一个是每隔3小时执行一次。是不是因为线程数少的原因呢?
另外配置quartz.properties这个文件,是不是把quartz.jar包中的文件
org.quartz.threadPool.threadCount = 10
改为
org.quartz.threadPool.threadCount = 20
然后把这个文件放在WEB-INF\classes目录下就可以了???
quartz.jar会把这个文件替换他原来默认的quartz.properties ?

隔叶黄莺
15 years ago

是的,试一试看看吧。

zxming12345
zxming12345
15 years ago

隔叶黄莺您好!

感谢您的心情工作,给大家提供了这么多文档。

能不能吧这些文档的word半发给我一份吗? 十分感激!!

我的邮箱是 zhang.xiaoming@neusoft.com

james
james
15 years ago

不知能否把你已翻译的文档发份给我呢,万分感谢,我的邮箱是jamesyueyb@163.com

隔叶黄莺
15 years ago

初步的所有翻译文稿已汇集成一个 chm 文件,过几日我将发布在这里,提供 下载,与大家一同分享。