在spring-task出来之前,quartz基本是java实现定时任务的最好选择,因为功能强大,而且有非常便捷的cron表达式。现在由于开发都以spring为核心,spring自带的task实现起来又那么容易,所以quartz的使用越来越少。
quartz的目前版本是2.3,版本2.0和和之前的1.x版本还是差别挺大的。
这里以2.3做例子进行讲解。
添加依赖pom.xml
<dependency>
<groupId>org.quartz-scheduler</groupId>
<artifactId>quartz</artifactId>
<version>2.3.0</version>
</dependency>
定义job的具体执行HelloQuartzJob.java
public class HelloQuartzJob implements Job {
public void execute(JobExecutionContext context)
throws JobExecutionException {
System.out.println("Hello, Quartz! - executing its JOB at " + new Date());
}
}
启动定时任务HelloQuartzScheduling.java
public class HelloQuartzScheduling {
public static void main(String[] args) {
try {
//得到默认的调度器
Scheduler scheduler = StdSchedulerFactory.getDefaultScheduler();
//定义当前调度器的具体作业对象
JobDetail jobDetail = JobBuilder.
newJob(HelloQuartzJob.class).
withIdentity("cronTriggerDetail", "cronTriggerDetailGrounp").
build();
//定义当前具体作业对象的参数
JobDataMap jobDataMap = jobDetail.getJobDataMap();
jobDataMap.put("name", "cronTriggerMap");
jobDataMap.put("group", "cronTriggerGrounp");
//作业的触发器
CronTrigger cronTrigger = TriggerBuilder.//和之前的 SimpleTrigger 类似,现在的 CronTrigger 也是一个接口,通过 Tribuilder 的 build()方法来实例化
newTrigger().
withIdentity("cronTrigger", "cronTrigger").
withSchedule(CronScheduleBuilder.cronSchedule("0/5 * * * * ?")). //在任务调度器中,使用任务调度器的 CronScheduleBuilder 来生成一个具体的 CronTrigger 对象
build();
//注册作业和触发器
scheduler.scheduleJob(jobDetail, cronTrigger);
//开始调度任务
scheduler.start();
} catch (SchedulerException e) {
e.printStackTrace();
}
}
}
这一段的代码还是比较复杂的,首先是定义Scheduler
默认的任务调度器。
定义当前调度器的具体作业对象JobDetail
,并给这个任务命名,且分到一个group里
定义当前具体作业对象的参数,JobDataMap
定义作业的触发器CronTrigger
注册作业和触发器,在任务调度器里面
开始调度任务scheduler.start();
这里面的Cron表达式也是标准的。
对于CornExpress讲解如下:
字段 允许值 允许的特殊字符
秒 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的第一天
运行HelloQuartzScheduling
启动的代码也可以放到web的listener中,随web启动而启动。