Quartz笔记

Quartz笔记

---

misfire策略

下面这些原因可能造成 misfired job:
1、系统因为某些原因被重启。在系统关闭到重新启动之间的一段时间里，可能有些任务会被 misfire；
2、Trigger 被暂停（suspend）的一段时间里，有些任务可能会被 misfire；
3、线程池中所有线程都被占用，导致任务无法被触发执行，造成 misfire；
4、有状态任务在下次触发时间到达时，上次执行还没有结束；

比如：
到了该触发执行时上一个执行还未完成，且线程池中没有空闲线程可以使用（或有空闲线程可以使用但job设置为@DisallowConcurrentExecution）且过期时间已经超过misfireThreshold就认为是misfire了。

比如：13:07:24开始执行，5秒执行一次，开始执行时，quartz已经计算好每次调度的时间刻，分别如下：
03:33:36，03:33:39，03:33:42，03:33:45，03:33:48，03:33:51
如果第一次执行时间为11s，到03:33:47结束，03:33:47减去03:33:39的时间间隔是8s，如果misfireThreshold设置的时间小于等于8s间隔，则认为是misfire了，如果大于8s间隔，则认为没有misfire。

CronTrigger的misfire策略

CronScheduleBuilder csb = CronScheduleBuilder.cronSchedule("0/5 * * * * ?");

csb.withMisfireHandlingInstructionDoNothing();
csb.withMisfireHandlingInstructionFireAndProceed(); //(默认)
csb.withMisfireHandlingInstructionIgnoreMisfires();

withMisfireHandlingInstructionDoNothing

不触发立即执行
等待下次Cron触发频率到达时刻开始按照Cron频率依次执行

所有的misfire不管，执行下一个周期的任务

withMisfireHandlingInstructionIgnoreMisfires

以错过的第一个频率时间立刻开始执行
重做错过的所有频率周期后
当下一次触发频率发生时间大于当前时间后，再按照正常的Cron频率依次执行

所有misfire的任务会马上执行
打个比方，如果9点misfire了，在10：15系统恢复之后，9点，10点的misfire会马上执行

withMisfireHandlingInstructionFireAndProceed（默认）

以当前时间为触发频率立刻触发一次执行
然后按照Cron频率依次执行

合并部分的misfire,正常执行下一个周期的任务
假设9，10的任务都misfire了，系统在10：15分起来了。只会执行一次misfire，下次正点执行。

---

SimpleTrigger的misfire策略

SimpleScheduleBuilder ssb = SimpleScheduleBuilder.simpleSchedule();

ssb.withMisfireHandlingInstructionFireNow();
ssb.withMisfireHandlingInstructionIgnoreMisfires();
ssb.withMisfireHandlingInstructionNextWithExistingCount();
ssb.withMisfireHandlingInstructionNextWithRemainingCount();
ssb.withMisfireHandlingInstructionNowWithExistingCount();　　//（默认）
ssb.withMisfireHandlingInstructionNowWithRemainingCount();

quartz-misfire 错失、补偿执行
https://www.cnblogs.com/skyLogin/p/6927629.html

任务框架quartz的misfire的理解
https://www.jianshu.com/p/634d2a6fae7b

quartz - misfire错过触发时机的处理
https://my.oschina.net/thinwonton/blog/857682

---

cron表达式

在线Cron表达式生成器

http://cron.qqe2.com/

格式
秒 分 时 日 月 周 年(可选)
Seconds Minutes Hours DayofMonth Month DayofWeek [Year]

各个域的取值范围

Seconds(秒): 可出现 , - * / 四个字符，有效范围为0-59的整数
Minutes(分): 可出现 , - * / 四个字符，有效范围为0-59的整数
Hours(时): 可出现 , - * / 四个字符，有效范围为0-23的整数
DayofMonth(日): 可出现 , - * / ? L W C 八个字符，有效范围为0-31的整数
Month(月)：可出现 , - * / 四个字符，有效范围为1-12的整数或 JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC
DayofWeek(周): 可出现 , - * / ? L C # 四个字符，有效范围为1-7的整数或 SUN, MON, TUE, WED, THU, FRI, SAT 两个范围。1表示星期日，2表示星期一， 依次类推
Year(年): 可出现 , - * / 四个字符，有效范围为1970-2099年

通配符说明

*，表示所有值, 表示匹配该域的任意值。 例如在分的字段上设置,表示每一分钟都会触发。
?，表示不指定值。只能用在 DayofMonth 和 DayofWeek 两个域。使用的场景为不需要关心当前设置这个字段的值。例如想在每月的 20 日触发调度，不管 20 日到底是星期几，则只能使用如下写法： 0 0 0 20 * ? , 其中最后一位只能用 ?, 而不能使用 * ，如果使用 * 表示不管星期几都会触发，实际上并不是这样。
-，表示区间。例如 在小时上设置 “10-12”,表示 10,11,12点都会触发。
,，表示列出枚举值值。表示指定多个值，例如在周字段上设置 “MON,WED,FRI” 表示周一，周三和周五触发, “MON-WED,SAT”表示周一到周三及周六触发
/，表示起始时间开始触发，然后每隔固定时间触发一次。用于递增触发。如在秒上面设置”5/15” 表示从5秒开始，每增15秒触发(5,20,35,50)。 在月字段上设置’1/3’所示每月1号开始，每隔三天触发一次。
L，表示最后的意思。只能出现在DayofWeek和DayofMonth域，如果在DayofWeek域使用5L,意味着在最后的一个星期四触发。在日字段设置上，表示当月的最后一天(依据当前月份，如果是二月还会依据是否是润年[leap]), 在周字段上表示星期六，相当于”7”或”SAT”。如果在”L”前加上数字，则表示该数据的最后一个。例如在周字段上设置”6L”这样的格式,则表示“本 月最后一个星期五”。
W，表示离指定日期的最近那个工作日(周一至周五)。只能出现在DayofMonth域。例如在日字段上设置”15W”，表示离每月15号最近的那个工作日触发。如果15号正好是周六，则找最近的周五(14号)触发, 如果15号是周未，则找最近的下周一(16号)触发.如果15号正好在工作日(周一至周五)，则就在该天触发。另外一点，W的最近寻找不会跨过月份。如果指定格式为 “1W”,它则表示每月1号往后最近的工作日触发。如果1号正是周六，则将在3号下周一触发。(注，”W”前只能设置具体的数字,不允许区间”-“)。
LW, 这两个字符可以连用，表示在某个月最后一个工作日，即最后一个星期五。
#, 用于确定每个月第几个星期几，只能出现在DayofWeek域。例如在 4#2，表示某月的第二个星期三。

Cron表达式范例

*/5 * * * * ?, 每隔5秒执行一次
0 */1 * * * ?, 每隔1分钟执行一次
0 0 23 * * ?, 每天23点执行一次
0 0 1 * * ?, 每天凌晨1点执行一次
0 0 1 1 * ?, 每月1号凌晨1点执行一次
0 0 23 L * ?, 每月最后一天23点执行一次
0 0 1 ? * L, 每周星期天凌晨1点实行一次
0 26,29,33 * * * ?, 在每个小时的26分、29分、33分执行一次
0 0 0,13,18,21 * * ?, 每天的0点、13点、18点、21点都执行一次

0 0 2 1 * ? *, 表示在每月的1日的凌晨2点调度任务
0 15 10 ? * MON-FRI, 表示周一到周五每天上午10：15执行作业
0 15 10 ? 6L 2002-2006, 表示2002-2006年的每个月的最后一个星期五上午10:15执行作

0 0 10,14,16 * * ?, 每天上午10点，下午2点，4点
0 0/30 9-17 * * ?, 朝九晚五工作时间内每半小时
0 0 12 ? * WED, 表示每个星期三中午12点
0 0 12 * * ?, 每天中午12点触发
0 15 10 ? * *, 每天上午10:15触发
0 15 10 * * ?, 每天上午10:15触发
0 15 10 * * ? *, 每天上午10:15触发
0 15 10 * * ? 2005, 2005年的每天上午10:15触发
0 * 14 * * ?, 在每天下午2点到下午2:59期间的每1分钟触发
0 0/5 14 * * ?, 在每天下午2点到下午2:55期间的每5分钟触发
0 0/5 14,18 * * ?, 在每天下午2点到2:55期间和下午6点到6:55期间的每5分钟触发
0 0-5 14 * * ?, 在每天下午2点到下午2:05期间的每1分钟触发
0 10,44 14 ? 3 WED, 每年三月的星期三的下午2:10和2:44触发
0 15 10 ? * MON-FRI, 周一至周五的上午10:15触发
0 15 10 15 * ?, 每月15日上午10:15触发
0 15 10 L * ?, 每月最后一日的上午10:15触发
0 15 10 ? * 6L, 每月的最后一个星期五上午10:15触发
0 15 10 ? * 6L 2002-2005, 2002年至2005年的每月的最后一个星期五上午10:15触发
0 15 10 ? * 6#3, 每月的第三个星期五上午10:15触发

cron表达式详解
https://www.cnblogs.com/linjiqin/p/3178452.html

QuartZ Cron表达式
https://www.cnblogs.com/sunjie9606/archive/2012/03/15/2397626.html

---

quartz-monitor

Quartz的监控和管理工具：quartz-monitor
https://github.com/xishuixixia/quartz-monitor

quartz-monitor 是一个基于DWZ的Quartz管理工具，可以实时动态的管理Job和trigger，具体功能主要包括：

1. 配置管理 针对不同环境的Quartz，需要有一个统一的入口去管理这些配置，来满足对不同环境的任务的管理。
2. Job管理 提供对Job的管理和维护功能。Monitor提供对Job的基本管理，包括对其状态、执行时间、基本信息的管理以及提供基于Job的基本操作。
3. Trigger管理 提供对trigger的管理和维护功能。可以查看某个job的trigger信息，并添加和修改trigger。
4. Cron Expression校验 Cron Expression虽然简单却非常容易写错，所以我们提供了对其的校验功能。

配置方法：
1）配置quartz支持JMX
在需要管理的应用的quartz.properties中加入配置：
org.quartz.scheduler.jmx.export = true

2）配置应用容器支持JMX
如果之前已配置过用于VisualVM连接的JMX端口，则说明已支持JMX，直接启动quartz-monitor连接即可。
否则，增加如下JVM启动参数，设定端口为2911
比如我使用的是TOMCAT，并且在Linux上，在tomcat的bin目录下，catalina.sh文件中加入如下JVM配置：
JAVA_OPTS='$JAVA_OPTS -Dcom.sun.management.jmxremote=true -Dcom.sun.management.jmxremote.port=2911 -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.authenticate=false -Dorg.quartz.scheduler.jmx.export=true'
如果使用jboss，在run.conf中增加上述配置

3）启动Quartz-Monitor
将quartz-monitor放入tomcat，启动tomcat，http://localhost:8080/quartz-monitor 地址访问管理页面，在“我的主页”中添加远程服务器quartz监控，输入服务器IP和jmx端口，即可在“任务列表”中看到quartz任务。

---

quartz

Quartz是一个开源的作业调度框架，它完全由Java写成，并设计用于J2SE和J2EE应用中。

定时器(Quartz)快速入门
http://my.oschina.net/Barudisshu/blog/294272

Quartz学习
http://blog.csdn.net/bubei/article/details/2108778

触发器

Quartz中提供了两种触发器，分别是CronTrigger和SimpleTrigger
（1）SimpleTrigger 总是每隔若干秒触发，而同夏令时没有关系。
（2）CronTrigger 总是在给定的时间出发然后计算它下次触发的时间。如果在给定的日期内没有该时间，则触发器将会被忽略，如果在给定的日期内该时间发生了两次，它只触发一次。因为是在第一次触发发生后计算当天下次触发的时间。

quartz.properties文件

文件quartz.properties定义了 Quartz 应用运行时行为，还包含了许多能控制 Quartz 运转的属性。

---