trigger:Trigger相关组件

提示:本文中部分内容图片节选自互联网,无意冒犯。如有侵权请私信联系作者即刻删除、更改。


文章目录

  • Trigger触发器
  • SimpleTrigger
  • CronTrigger
    • 1.Cron表达式
    • 2.简单的CronTrigger示例


Trigger触发器

Trigger对象是用来触发执行Job的条件触发器对象。当调度一个Job任务时,需要实例化一个Trigger对象与之关联,表明任务在什么条件下会执行。
Trigger的创建需要借助于TriggerBuilder。如下图Trigger接口的常用实现类有四个,常用的Trigger为SimpleTrigger和ConTrigger。


需要注意不管哪种触发器都需要有如下三个标识:jobKey、startTime、endTime,它们代表的含义如下:

  • jobKey
    标识与之绑定的Job实例,包含job的任务名称、任务组名称,Class等信息
  • startTime
    标识任务被触发的第一次时间,类型为Date
  • endTime
    标识触发器的终止时间,如果时间到达,触发器将被终止。

另外需要注意Trigger自身也可以拥有一个JobDataMap,其关联的Job可以通过JobExecutionContext#getTrigger().getJobDataMap()获取Trigger中的JobDataMap。不管是有状态还是无状态的任务,在任务执行期间对Trigger的JobDataMap所做的更改都不会进行持久,即不会对下次的执行产生影响。

SimpleTrigger

SimpleTrigger是设置和使用最为简单的Trigger。它一般用于定时启动或者在一定时间间隔中重复执行的job。如下为获取一个SimpleTrigger

SimpleTrigger trigger = TriggerBuilder.newTrigger() .withIdentity("trigger1", "group1") .withSchedule(SimpleScheduleBuilder.simpleSchedule().repeatForever().withIntervalInSeconds(2)) .startNow() .build();

SimpleTrigger的注意点如下:

  • SimpleTrigger的属性包括:开始时间、结束时间、重复次数和重复时间间隔。
  • 重复次数可以是0、正整数或常量值SimpleTrigger.REPEAT_INDEFINITELY。
  • 时间间隔属性必须大于零且为长整型的正整数,以毫秒为单位。请注意,重复间隔为0将于Trigger同时触发执行(一起启动)。
  • 如果指定结束时间的属性值,则结束时间为主。如果同时指定了执行次数将被忽略。

CronTrigger

CronTrigger是基于日历的作业调度,它可以指定周、月、年、时等特定的时间进行任务调度。CronTrigger是以cron的表达式作为配置进行复杂的时间调度工作的。

1.Cron表达式

cron的表达式是字符串表达式,实际上是由七子表达式,描述不同域的时间表。这些子表达式以空格为分割,表示各时间域部分的时间单位。如下为一个cron表达式的格式:

Seconds Minutes Hours Day-of-Month Month Day-of-Week Year (可选字段)

其中Year是可选字段,所以可能会经常看到有6个子表达式的cron表达式。当然cron表达式作为了解即可,网上有很多在线生成cron表达式的工具。很多时候,对于cron表达式的生成并不需要自己动手。以下为7个子表达式中的取值列表:


单个子表达式可以包含范围或者列表。例如在周中的天的域中可以是WED也可以被替换为一个区间MON-FRI表示周一到周五(-表示区间),或者使用枚举MON,WED,FRI表表示周一,周三,周五三天(,表示分割)。月份、星期都可以使用应为代替。

2.简单的CronTrigger示例

如下例为一个简单的2秒执行一次的定时任务

public static void main(String[] args) throws SchedulerException { final JobDetail detail = JobBuilder.newJob(HelloJob.class) .withIdentity("job1", "group1") .usingJobData("cout",0) .usingJobData("couter",0) .build(); final CronTrigger trigger = TriggerBuilder.newTrigger() .withIdentity("trigger1", "group1") .withSchedule(CronScheduleBuilder.cronSchedule("*/2 * * * * ? *")) .startNow() .build(); final Scheduler scheduler = StdSchedulerFactory.getDefaultScheduler(); scheduler.scheduleJob(detail,trigger); scheduler.start();}

相关推荐

相关文章