Quartz是个任务调度框架:
一、基本概念Job: 任务,必须implements Job这个借口,在execute方法中写具体要做得事。Trigger: 触发器,执行任务的规则,比如定时、每天小时、每天等等。分为SimpleTrigger和CronTrigger,SimpleTrigger用于执行例如立即执行、每隔多长时间做任务等,而CronTrigger用于例如每天什么时间、每月第一天执行等等。Scheduler: 任务调度,将Job和Trigger注册到Scheduler里,即可根据设定执行任务。二、代码
首先上官网下载相应的jar包,或在pom.xml里设定Maven的dependency, 以下以我当前版本2.2.1为例。Job类
public class MyJob implements Job { @Override public void execute(JobExecutionContext context) throws JobExecutionException { System.out.println("Hello"); System.out.println(new Date()); }}
Scheduler测试,包含了简单的定时,有规则的定时以及根据timezone定时等
public class MyScheduler { public static void main(String[] args) throws SchedulerException { JobDetail job = JobBuilder.newJob(MyJob.class).build(); // 简单任务 Trigger t1 = TriggerBuilder.newTrigger().withIdentity("mySimpleTrigger").startNow().build(); // 每天12:47分执行 Trigger t2 = TriggerBuilder.newTrigger().withIdentity("myCronTrigger").withSchedule(CronScheduleBuilder.cronSchedule("0 47 12 1/1 * ? *")).build(); // 每隔5秒执行 Trigger t3 = TriggerBuilder.newTrigger().withIdentity("myCronTrigger"). withSchedule(SimpleScheduleBuilder.simpleSchedule().withIntervalInSeconds(5).repeatForever()).build(); // 每天12:47(GMT+8)执行, 注意使用了inTimeZone。如果schedule是根据客户时区安排的,就非常有用,顺带解决了DSTSaving的问题 Trigger t4 = TriggerBuilder.newTrigger().withIdentity("myCronTrigger").withSchedule(CronScheduleBuilder.cronSchedule("0 47 12 1/1 * ? *").inTimeZone(TimeZone.getTimeZone("GMT+8"))).build(); // 通过schedulerFactory获取一个调度器 Scheduler sc = StdSchedulerFactory.getDefaultScheduler(); // 把作业和触发器注册到任务调度中 sc.scheduleJob(job, t3); sc.start(); }}
当需要修改job,重新reschedule
public void execute(JobExecutionContext context) throws JobExecutionException { Trigger newTrigger = what_ever_you_want; Trigger oldTrigger = context.getTrigger(); Scheduler scheduler = StdSchedulerFactory.getDefaultScheduler(); scheduler.rescheduleJob(oldTrigger.getKey(), newTrigger);}
对于CronExpression可以参考 来给出表达式,详解如下:
字段 允许值 允许的特殊字符 秒 0-59 , - * / 分 0-59 , - * / 小时 0-23 , - * / 日期 1-31 , - * ? / L W C 月份 1-12 或者 JAN-DEC , - * / 星期 1-7 或者 SUN-SAT , - * ? / L C # 年(可选) 留空, 1970-2099 , - * /表达式 意义
"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触发特殊字符 意义
* 表示所有值; ? 表示未说明的值,即不关心它为何值; - 表示一个指定的范围; , 表示附加一个可能值; / 符号前表示开始时间,符号后表示每次递增的值; L("last") ("last") "L" 用在day-of-month字段意思是 "这个月最后一天";用在 day-of-week字段, 它简单意思是 "7" or "SAT"。 如果在day-of-week字段里和数字联合使用,它的意思就是 "这个月的最后一个星期几" – 例如: "6L" means "这个月的最后一个星期五". 当我们用“L”时,不指明一个列表值或者范围是很重要的,不然的话,我们会得到一些意想不到的结果。 W("weekday") 只能用在day-of-month字段。用来描叙最接近指定天的工作日(周一到周五)。例如:在day-of-month字段用“15W”指“最接近这个月第15天的工作日”,即如果这个月第15天是周六,那么触发器将会在这个月第14天即周五触发;如果这个月第15天是周日,那么触发器将会在这个月第16天即周一触发;如果这个月第15天是周二,那么就在触发器这天触发。注意一点:这个用法只会在当前月计算值,不会越过当前月。“W”字符仅能在day-of-month指明一天,不能是一个范围或列表。也可以用“LW”来指定这个月的最后一个工作日。 # 只能用在day-of-week字段。用来指定这个月的第几个周几。例:在day-of-week字段用"6#3"指这个月第3个周五(6指周五,3指第3个)。如果指定的日期不存在,触发器就不会触发。 C 指和calendar联系后计算过的值。例:在day-of-month 字段用“5C”指在这个月第5天或之后包括calendar的第一天;在day-of-week字段用“1C”指在这周日或之后包括calendar的第一天