Quartz 触发器、过期触发策略、排它日历、数据持久化

最新推荐文章于 2025-09-09 08:45:00 发布

原创

最新推荐文章于 2025-09-09 08:45:00 发布 · 5.4k 阅读

10 ·

CC 4.0 BY-SA版权

本文深入解析Quartz定时任务框架，涵盖Trigger概述、常用触发器、优先级与过期策略、数据持久化等内容，助您掌握Quartz核心概念与高级特性。

Trigger 概述与常用触发器

Trigger 常用属性

Trigger 优先级 priority

过期触发策略(misfire Instructions)

org.quartz.Calendar 排除日历

SimpleTrigger 触发器

CronTrigger 触发器

Quartz 数据持久化

Trigger 概述与常用触发器

1、org.quartz.Trigger 是基接口，具有所有触发器通用的属性，使用 org.quartz.TriggerBuilder 类实例化实际触发器。

2、触发器有一个关联的 TriggerKey，它应该在单个 Scheduler 中唯一标识它们。

3、多个触发器可以指向同一个作业(Job)，但是一个触发器只能指向一个作业。

4、触发器可以通过 JobDataMap 放置属性将参数/数据传输到 Job 。《quartz-scheduler 核心 API》

//设置触发器的启动时间为 30 秒后，然后每10秒执行一次任务.
Trigger trigger = TriggerBuilder.newTrigger()
		.withIdentity(TriggerKey.triggerKey("myTrigger", "myTriggerGroup"))
		.withSchedule(SimpleScheduleBuilder.simpleSchedule()
				.withIntervalInSeconds(10)
				.repeatForever())
		.startAt(DateBuilder.futureDate(30, DateBuilder.IntervalUnit.SECOND))
		.build();

org.quartz.Trigger 触发器接口常用实现类
SimpleTrigger	简单触发器，在一个给定的时间时刻，并有选择地以指定的间隔重复。使用 SimpleScheduleBuilder 构建
DailyTimeIntervalTrigger	每日间隔时间触发器，根据每天的重复时间间隔触发。使用 DailyTimeIntervalScheduleBuilder 构建。
CalendarIntervalTrigger	日历触发器，以每 N 个日历时间单位触发一次。使用 CalendarIntervalScheduleBuilder 构建.
CronTrigger	cron 表达式触发器，灵活指定年月日时分秒星期。使用 CronScheduleBuilder 构建。

Trigger 常用属性

Trigger 常用属性
TriggerKey	标识 trigger 的身份。键由名称和组构成，且名称在组中必须唯一。TriggerKey(String name, String group)，name 不能为 null,否则抛异常，group 为 null 时，使用默认值 “DEFAULT”。
startTime	1）设置触发器开始的时刻，属性值是 java.util.Date 类型，默认值为 startTime = new Date(); 2）有些类型的 trigger，会在设置的 startTime 时刻立即触发，有些类型的 trigger，则会在 startTime 之后才开始生效。 3）如当前系统时间为1月3号，设置一个 trigger 在每个月的第5天执行任务，startTime 属性设置为 3 月 2 号，则该 trigger 第一次触发是在3月5号，然后是 4月5号，以此类推。
endTime	设置 trigger 失效的时刻。比如 ”每月第5天执行” 的 trigger，如果其 endTime 是 6 月30 号，则其最后一次执行时间是 6 月 5 号。

Trigger 的属性在构建 trigger 的时候可以通过 TriggerBuilder 设置，比如：

//设置触发器的启动时间为 startTime，失效时间为 endTime。
//一到启动时间 SimpleTrigger 就会第一次执行任务，然后间隔 withIntervalInSeconds 继续执行
//直到失效时间不再执行，触发器也会被卸载.
Trigger trigger = TriggerBuilder.newTrigger()
		.startAt(startTime)
		.endAt(endTime)
		.withIdentity(TriggerKey.triggerKey("myTrigger", "myTriggerGroup"))
		.withSchedule(SimpleScheduleBuilder.simpleSchedule()
				.withIntervalInSeconds(10)
				.repeatForever())
		.build();