Quartz 2.2.1 学习笔记(三) Trigger

原创
2015/07/24 18:01
阅读数 233

Job与JobDetail是Quartz用来定义具体任务的,而Trigger则是用来定义任务如何执行的。Quartz提供了Trigger接口来定义公共属性,使用TriggerBuilder可以创建具体类型的Trigger;最常见的两种Trigger分别是SimpleTrigger、CronTrigger。

Trigger的公共属性:

  • key,该属性是为了标识Trigger的。
  • startTime,Trigger第一次被Scheduler触发的时间;该属性的值是指定某个时间点的java.util.Date对象。
  • endTime,Trigger不再被执行的时间。
  • priority,优先级;通过设置优先级属性可以控制Trigger被执行的顺序,该属性默认值是5,可以为正整数也可以为负整数。需要注意的是,只有在触发时间相同时,优先级属性才会有效;比如10:59执行的任务总是会在11:00执行的任务之前执行;另外,如果Trigger是可恢复的,那么恢复后,优先级是不会改变的。
  • misfire,如果因为某些原因,错过触发时间,就需要使用该属性来调整。不同类型的Trigger拥有不同的misfire,但是默认的是smart policy,这种情况下会根据Trigger的类型与配置来动态的调整行为。
  • Calendars,该属性并不是java.util.Calendar类型,它的作用是排除某些时间,比如在周末不执行任务。Quratz的Calendar对象是一个实现了Calendar接口的序列化对象,Calendars接口如下:
package org.quartz;    
public interface Calendar {    
  public boolean isTimeIncluded(long timeStamp);    
  public long getNextIncludedTime(long timeStamp);    
}

这两个方法都是精确到毫秒的;如果只是排除以天为单位的时间,可以使用HolidayCalendar。
Calendars必须实例化,然后通过Scheduler的addCalendar()方法注册。Calendars可以重复使用,如下代码:

Trigger trigger1 = TriggerBuilder.newTrigger()
                .withIdentity("trigger1", "test")
                .startAt(DateBuilder.futureDate(3, IntervalUnit.SECOND))
                .withSchedule(SimpleScheduleBuilder.simpleSchedule()
                        .withIntervalInMilliseconds(5000)
                        .withIntervalInSeconds(5)
                        .withRepeatCount(5))
                .modifiedByCalendar("holidayCalendar")
                .build();

        Trigger trigger2 = TriggerBuilder.newTrigger()
                .withIdentity("trigger2", "test")
                .startAt(DateBuilder.futureDate(3, IntervalUnit.SECOND))
                .withSchedule(SimpleScheduleBuilder.simpleSchedule()
                        .withIntervalInMilliseconds(5000)
                        .withIntervalInSeconds(5)
                        .withRepeatCount(5))
                .modifiedByCalendar("holidayCalendar")
                .build();

SimpleTrigger

下面来看SimpleTrigger。通过之前的例子可以看到如何创建Trigger,首先通过TriggerBuilder.newTrigger()方法建立一个TriggerBuilder对象,然后通过withSchedule()方法指定了SimpleScheduleBuilder,最后build()方法构建出了SimpleTrigger对象。
SimpleTrigger很简单,之前例子中创建的都是SimpleTrigger,任务启动后每隔5s运行一次,总共运行5次。Quartz提供了DateBuilder工具类来方便设置时间,里面提供了很多方法,如上面Trigger2设置的启动时间就是3秒后启动任务。

CronTrigger

CronTrigger使用cron表达式来设置触发时间。CronTrigger创建方式:

Trigger trigger3 = TriggerBuilder.newTrigger()
                .withIdentity("cron trigger", "test")
                .withSchedule(
                    //每5秒执行一次                       
                    CronScheduleBuilder.cronSchedule("0/5 * * ? * *")
                ).build();

cron表达式

cron表达式的格式为:秒 分 时 日 周 年;其中年是可选的,其它为必填。
每个属性允许的值:

  • 秒, 0-59;
  • 分,0-59;
  • 时,0-23;
  • 日,1-31;
  • 周 ,1-7;
  • 年,可选,1970-2099

下面是cron表达式使用的一些符号:

  1. “/”:指定增加值;比如上面的”0/5”,意思就是从第0秒开始,然后每隔5秒执行一次。
  2. *”:表示所有值;比如”5 * ? * *”,意思就是每一分钟的第5秒执行一次。
  3. “?”:没有指定具体值,表示某月的某一天或者每周的某一天;只能在”日”和”周”上使用”?”,而且必须使用”?”;比如”5 * * ? * “或”5 * * * ?”都是正确的且效果一样,而”5 * * * * *”则是错误的。
  4. “,”:表示多选;比如”1,2,3,5 * * ? * *”,意思就是每分钟的第1、2、3、5秒执行一次任务。
  5. “-“:表示范围;比如”1-5 * * ? * *”,意思就是每分钟的第1到5秒执行一次任务。
  6. “L”:只允许在”日”和”周”上使用,分别有不同的作用;如果在”日”上使用,则表示该月的最后一天,如:1月31日;如果在”周”上使用,则意味着7或者SAT;另外,如果数字和L在”周”上组合使用则有其它含义,如:”6L”,则代表当前月的最后一个星期五。L用在”日”上还可以指定偏移,如”L-3”,表示该月的第3天到最后一天。
  7. “W”:表示给定日期最近的工作日,只能用在”日”上面;例如:”15W”,表示每月15号最近的一个工作日,如果15号是周六,则在14号周五执行;如果15号是周日,则在16号周一执行。需要注意的是结合W使用时,不能使用范围,只能使用单个值。另外W也能和L联合使用,表示当月的最后一个工作日。
  8. “#”:表示当月第几个周X,只能在”周”上使用;如:”1#3”,表示当月的第3个星期一。

    下图为每个属性允许使用的符号:
    这里写图片描述

版权声明:本文为博主原创文章,未经博主允许不得转载。

展开阅读全文
加载中
点击引领话题📣 发布并加入讨论🔥
打赏
0 评论
0 收藏
0
分享
返回顶部
顶部