Quartz Scheduler 示例3：CronTrigger 定时任务详解

概述

Quartz Scheduler 是一个功能强大的开源作业调度库，本示例将重点介绍如何使用 CronTrigger 来实现基于日历的复杂调度需求。CronTrigger 是 Quartz 中最灵活的触发器类型之一，它使用类似于 Unix cron 表达式的语法来定义调度规则。

CronTrigger 基础

CronTrigger 允许开发者使用 cron 表达式来定义作业的执行时间表。cron 表达式由6-7个字段组成，分别表示：

1. 秒（0-59）
2. 分钟（0-59）
3. 小时（0-23）
4. 月份中的日期（1-31）
5. 月份（1-12或JAN-DEC）
6. 星期中的日期（1-7或SUN-SAT）
7. 年份（可选）

示例代码解析

1. 创建调度器实例

首先需要获取调度器实例，这是所有 Quartz 作业调度的起点：

SchedulerFactory sf = new StdSchedulerFactory();
Scheduler sched = sf.getScheduler();

2. 定义简单作业

示例中使用了一个简单的作业类 SimpleJob，它会在执行时打印日志信息：

public void execute(JobExecutionContext context) throws JobExecutionException {
    JobKey jobKey = context.getJobDetail().getKey();
    _log.info("SimpleJob says: " + jobKey + " executing at " + new Date());
}

3. 多种 CronTrigger 配置示例

示例中展示了7种不同的 CronTrigger 配置方式，涵盖了常见的调度需求：

示例1：每20秒执行一次

.withSchedule(cronSchedule("0/20 * * * * ?"))

示例2：每隔2分钟，在每分钟的第15秒执行

.withSchedule(cronSchedule("15 0/2 * * * ?"))

示例3：每天8点到17点之间，每隔2分钟执行

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

示例4：每天17点到23点之间，每隔3分钟执行

.withSchedule(cronSchedule("0 0/3 17-23 * * ?"))

示例5：每月1号和15号的10点执行

.withSchedule(cronSchedule("0 0 10am 1,15 * ?"))

示例6：工作日（周一到周五）每30秒执行

.withSchedule(cronSchedule("0,30 * * ? * MON-FRI"))

示例7：周末（周六和周日）每30秒执行

.withSchedule(cronSchedule("0,30 * * ? * SAT,SUN"))

4. 启动和关闭调度器

配置完所有作业后，启动调度器并让程序运行一段时间：

sched.start();
Thread.sleep(300L * 1000L); // 等待5分钟
sched.shutdown(true); // 优雅关闭

实际应用建议

1. 表达式调试：在正式环境使用前，建议先在测试环境验证 cron 表达式是否符合预期。

2. 时区考虑：CronTrigger 默认使用调度器的时区，如有跨时区需求需要特别注意。

3. 异常处理：作业执行时应妥善处理异常，避免影响后续调度。

4. 集群环境：在集群环境中，Quartz 能确保同一作业不会被多个节点重复执行。

5. 性能考量：对于高频任务（如每秒执行），应考虑作业本身的执行时间是否会影响调度精度。

常见问题

1. 为什么我的作业没有按预期执行？

   • 检查 cron 表达式是否正确
   • 确认调度器是否已启动
   • 检查是否有其他触发器覆盖了当前设置

2. 如何实现更复杂的调度逻辑？

   • 可以结合多个触发器
   • 在作业执行时添加业务逻辑判断
   • 考虑使用 Calendar 来排除特定日期

3. 作业执行时间过长会影响下次触发吗？

   • 默认情况下会，可以通过配置 misfire 策略来处理这种情况

通过本示例，开发者可以掌握 Quartz 中 CronTrigger 的基本用法，并能够根据实际业务需求设计复杂的调度方案。