Cron 触发器及相关内容 (第三部分)

四. 为 CronTrigger 使用起迄日期

Cron 表达式是用来决定一个 Trigger 被触发执行一个 Job 的日期和次数。当你创建一个 CronTrigger 实例，假如没为它指定一个开始时间，这个 Trigger 当然就会假定是在依赖于 Cron 表达式尽早的被触发。例如，如果你用这个表达式
0 * 14-20 * * ?
这个 Trigger 会在每天的从下午 2 点到下午的 7:59 间的每分钟触发一次。一旦你运行了这个表达式的 CronTrigger，假如当前是下午 2 点后(不能超过 7:59 PM--译者注)，它将会立即触发。它会在每天无限期的被触发。
另一方面，倘若你希望这个计划直到下一天才开始，并且只执行两天，你就可以用 CronTrigger 的 setStartTime() 和 setEndTime() 方法来形成一个 "定时箱" 来触发。代码 5.2 描述了限定 CronTrigger 仅触发两天的例子。
代码 5.2. 你可以对 CronTrigger 用 startTime 和 endTime

public class Listing_5_2 {
static Log logger = LogFactory.getLog(Listing_5_2.class);
public static void main(String[] args) {
Listing_5_2 example = new Listing_5_2();
example.runScheduler();
}
public void runScheduler() {
Scheduler scheduler = null;
try {
// Create a default instance of the Scheduler
scheduler = StdSchedulerFactory.getDefaultScheduler();
scheduler.start();
logger.info("Scheduler was started at " + new Date());
// Create the JobDetail
JobDetail jobDetail = new JobDetail("PrintInfoJob",
Scheduler.DEFAULT_GROUP,
PrintInfoJob.class);
// Create a CronTrigger
try {
// cron that fires every min from 2 8pm
CronTrigger trigger =
new CronTrigger("MyTrigger", null,
"0 * 14-20 * * ?");
Calendar cal = Calendar.getInstance();
// Set the date to 1 day from now
cal.add(Calendar.DATE, 1);
trigger.setStartTime(cal.getTime());
// Move ahead 2 days to set the end time
cal.add(Calendar.DATE, 2);
trigger.setEndTime(cal.getTime());
scheduler.scheduleJob(jobDetail, trigger);
} catch (ParseException ex) {
logger.error("Couldn't parse cron expr", ex);
}
} catch (SchedulerException ex) {
logger.error(ex);
}
}
}

public class Listing_5_2 { static Log logger = LogFactory.getLog(Listing_5_2.class); public static void main(String[] args) { Listing_5_2 example = new Listing_5_2(); example.runScheduler(); } public void runScheduler() { Scheduler scheduler = null; try { // Create a default instance of the Scheduler scheduler = StdSchedulerFactory.getDefaultScheduler(); scheduler.start(); logger.info("Scheduler was started at " + new Date()); // Create the JobDetail JobDetail jobDetail = new JobDetail("PrintInfoJob", Scheduler.DEFAULT_GROUP, PrintInfoJob.class); // Create a CronTrigger try { // cron that fires every min from 2 8pm CronTrigger trigger = new CronTrigger("MyTrigger", null, "0 * 14-20 * * ?"); Calendar cal = Calendar.getInstance(); // Set the date to 1 day from now cal.add(Calendar.DATE, 1); trigger.setStartTime(cal.getTime()); // Move ahead 2 days to set the end time cal.add(Calendar.DATE, 2); trigger.setEndTime(cal.getTime()); scheduler.scheduleJob(jobDetail, trigger); } catch (ParseException ex) { logger.error("Couldn't parse cron expr", ex); } } catch (SchedulerException ex) { logger.error(ex); } } }
代码 5.2 中的例子使用了 java.util.Calendar 来为 Trigger 选择一个开始和结束时间周期。在上面例子中，Trigger 将会在 Scheduler 启动后的下一天开始触发，并只在开始触发后的两天内有效。
使用 CronTrigger 的 startTime 和 endTime 属性的效果有点像 SimpleTrigger。
五. 为 CronTrigger 使用 TriggerUtils
在第四章，"安排 Job" 中介绍了 org.quartz 包中的 TriggerUtils 类，它简化了两种类型的 Trigger 的创建。只要可能的话，你应该尝试用 TriggerUtils 类的方法来创建你的 Trigger。
例如，假如你需要在每天的下午 5:30 执行一个 Job，你可以用下面的代码：

try {
// A CronTrigger that fires @ 5:30PM
CronTrigger trigger = new CronTrigger("CronTrigger", null, "0 30 17 ? * *");
} catch (ParseException ex) {
logger.error("Couldn't parse cron expression", ex);
}

try { // A CronTrigger that fires @ 5:30PM CronTrigger trigger = new CronTrigger("CronTrigger", null, "0 30 17 ? * *"); } catch (ParseException ex) { logger.error("Couldn't parse cron expression", ex); }
或者你能用上 TriggerUtils，如下：

// A CronTrigger that fires @ 5:30PM
Trigger trigger = TriggerUtils.makeDailyTrigger(17, 30);
trigger.setName("CronTrigger");

// A CronTrigger that fires @ 5:30PM Trigger trigger = TriggerUtils.makeDailyTrigger(17, 30); trigger.setName("CronTrigger");
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 加载

<?xml version='1.0' encoding='utf-8'?>
<quartz>
<job>
<job-detail>
<name>PrintInfoJob</name>
<group>DEFAULT</group>
<description>
A job that prints out some basic information.
</description>
<job-class>
org.cavaness.quartzbook.common.PrintInfoJob
</job-class>
</job-detail>
<trigger>
<cron>
<name>printJobInfoTrigger</name>
<group>DEFAULT</group>
<job-name>PrintInfoJob</job-name>
<job-group>DEFAULT</job-group>
<cron-expression>0 30 7 ? * MON-FRI</cron-expression>
</cron>
</trigger>
</job>
</quartz>

<?xml version='1.0' encoding='utf-8'?> <quartz> <job> <job-detail> <name>PrintInfoJob</name> <group>DEFAULT</group> <description> A job that prints out some basic information. </description> <job-class> org.cavaness.quartzbook.common.PrintInfoJob </job-class> </job-detail> <trigger> <cron> <name>printJobInfoTrigger</name> <group>DEFAULT</group> <job-name>PrintInfoJob</job-name> <job-group>DEFAULT</job-group>  <cron-expression>0 30 7 ? * MON-FRI</cron-expression> </cron> </trigger> </job> </quartz>
代码 5.3 中的 Cron 表达式与代码 5.1 中。当 Quartz 加载这个 XML 后，就会安排 PrintInfoJob (也已在 XML 中列出) 在从星期一到星期五的早上 7:30 执行。关于 JobInitializationPlugin 更多的说明见第八章。

Cron 触发器及相关内容 (第三部分)

猜你喜欢