SimpleTrigger
如果您需要在特定的时间内精确地执行一次任务，或者在特定的时间间隔内重复执行某个特定的时间间隔，那么SimpleTrigger应该满足您的调度需求。
举个例子，如果你想在2015年1月13日上午11:23:54的时候触发，或者你想在那个时候触发，然后再触发5次(间隔 10S)。
有了这个描述，您可能不会惊讶地发现一个简单触发器的属性包括:开始时间、结束时间、重复计数和重复间隔。
重复计数可以是零，一个正整数，或者常量值 SimpleTrigger.REPEAT_INDEFINITELY。
重复的间隔属性必须为零，或正长的值，并表示若干毫秒。注意，重复的零间隔将导致触发器的“重复计数”触发同时发生(或者与调度程序可以同时执行的情况类似)。
- DateBuilder
DateBuilder 类，有助于计算触发器的触发时间，这取决于您试图创建的startTime(或endTime)。
- endTime
endTime属性(如果指定的话)会覆盖重复计数属性。
这可能是有用的,如果您希望创建一个触发器每10秒触发一次,直到一个给定的时刻,而不是计算的次数,将重复启动时间和结束时间,您可以简单地指定的 endTime, 然后使用重复计数REPEAT_INDEFINITELY(你甚至可以指定一些大量的重复计算,保证 endTime 先结束即可)。
TriggerBuilder
SimpleTrigger 实例是使用 TriggerBuilder (用于触发器的主要属性)和 SimpleScheduleBuilder (针对SimpleTrigger特定属性)构建的。
要在dsl风格中使用这些构建器，请使用静态导入:
import static org.quartz.TriggerBuilder.*;
import static org.quartz.SimpleScheduleBuilder.*;
import static org.quartz.DateBuilder.*:
各种触发器的定义
- 在特定的时间内建立一个触发点，不要重复:
SimpleTrigger trigger = (SimpleTrigger) newTrigger()
.withIdentity("trigger1", "group1")
.startAt(myStartTime) // some Date
.forJob("job1", "group1") // identify job with name, group strings
.build();
- 在特定的时间内建立一个触发点，然后每10秒重复10次:
SimpleTrigger trigger = newTrigger()
.withIdentity("trigger3", "group1")
.startAt(myTimeToStartFiring) // if a start time is not given (if this line were omitted), "now" is implied
.withSchedule(simpleSchedule()
.withIntervalInSeconds(10)
.withRepeatCount(10)) // note that 10 repeats will give a total of 11 firings
.forJob(myJob) // identify job with handle to its JobDetail itself
.build();
- 5分钟后执行一次
trigger = (SimpleTrigger) newTrigger()
.withIdentity("trigger5", "group1")
.startAt(futureDate(5, IntervalUnit.MINUTE)) // use DateBuilder to create a date in the future
.forJob(myJobKey) // identify job with its JobKey
.build();
- 立刻执行。并且 5min 重复一次，直到 22:00
trigger = newTrigger()
.withIdentity("trigger7", "group1")
.withSchedule(simpleSchedule()
.withIntervalInMinutes(5)
.repeatForever())
.endAt(dateOf(22, 0, 0))
.build();
- 下个小时的（00:00）开始触发，每2小时触发一次，一直下去
trigger = newTrigger()
.withIdentity("trigger8") // because group is not specified, "trigger8" will be in the default group
.startAt(evenHourDate(null)) // get the next even-hour (minutes and seconds zero ("00:00"))
.withSchedule(simpleSchedule()
.withIntervalInHours(2)
.repeatForever())
// note that in this example, 'forJob(..)' is not called
// - which is valid if the trigger is passed to the scheduler along with the job
.build();
scheduler.scheduleJob(trigger, job);
SimpleTrigger 失败说明
SimpleTrigger有几个指令，可以用来告诉 Quartz 在发生错误时应该做什么。(MisFire 情况在“第4课:更多关于触发器”中介绍)。 这些指令被定义为简单触发器本身的常量(包括描述其行为的JavaDoc)。包括:
Misfire Instruction Constants of SimpleTrigger
MISFIRE_INSTRUCTION_IGNORE_MISFIRE_POLICY
MISFIRE_INSTRUCTION_FIRE_NOW
MISFIRE_INSTRUCTION_RESCHEDULE_NOW_WITH_EXISTING_REPEAT_COUNT
MISFIRE_INSTRUCTION_RESCHEDULE_NOW_WITH_REMAINING_REPEAT_COUNT
MISFIRE_INSTRUCTION_RESCHEDULE_NEXT_WITH_REMAINING_COUNT
MISFIRE_INSTRUCTION_RESCHEDULE_NEXT_WITH_EXISTING_COUNT
你应该回忆起早期的教训，所有的触发器都有触发器。MISFIRE_INSTRUCTION_SMART_POLICY指令可用，此指令也是所有触发器类型的默认指令。
如果使用“智能策略”(‘smart policy)指令，基于给定的SimpleTrigger实例的配置和状态，SimpleTrigger会在其各种错误指令之间进行动态选择。的 JavaDoc SimpleTrigger.updateAfterMisfire() 方法解释了这种动态行为的具体细节。
在构建 SimpleTrigger 时，您可以将misfire指令指定为简单调度的一部分(通过SimpleSchedulerBuilder):
trigger = newTrigger()
.withIdentity("trigger7", "group1")
.withSchedule(simpleSchedule()
.withIntervalInMinutes(5)
.repeatForever()
.withMisfireHandlingInstructionNextWithExistingCount())
.build();
