Quartz Scheduler,定时任务
Quartz是一个作业调度系统(a job scheduling system),负责在约定的时间到达时执行(或通知)其他软件控制。是一个Java的定时任务框架,使用它可以方便的实现计划任务,即在某个时间或每隔一定时间运行一个任务。Quartz的核心是Job/JobDetail,Trigger和Scheduler。
1.Job/JobDetail
Job/JobDetail=既要执行的任务,可以通过实现Job(interface)中的excute方法来指定任务的具体操作。 他描述了一个任务具体的信息,比如名称,组名等等。JobDetail对象是在Quartz的客户端(我们的程序)在Job被关联加入到Scheduler时创建的,JobDetail包含了Job的各种属性值和 JobDataMap,JobDataMap中存放了与之相关的Job类实例的状态信息。
2.Trigger
用于控制一组Job的触发,包裹SimmperTrigger和CronTrigger,后者支持一种描述触发事件和间隔的表达式语言。Quartz有个很好的想法就是分离了任务和任务执行的条件。Trigger就是控制任务执行条件的类,当Trigger认为执行条件满足的时刻,Trigger会通知相关的Job去执行。分离的好处是:
1).你可以为某个Job关联多个Trigger,其中任何一个条件满足都可以触发job执行,这样可以完成一些组合的高级触发条件
2).当Trigger失效后(比如:一个永远都不能满足的条件),你不必去声明一个新的job,代替的是你可以为job关联一个新的Trigger让job可以继续执行。
3.Scheduler是控制和管理触发器的启动和终止。
Quartz是一个作业调度系统(a job scheduling system),负责在约定的时间到达时执行(或通知)其他软件控制。是一个Java的定时任务框架,使用它可以方便的实现计划任务,即在某个时间或每隔一定时间运行一个任务。Quartz的核心是Job/JobDetail,Trigger和Scheduler。
1.Job/JobDetail
Job/JobDetail=既要执行的任务,可以通过实现Job(interface)中的excute方法来指定任务的具体操作。 他描述了一个任务具体的信息,比如名称,组名等等。JobDetail对象是在Quartz的客户端(我们的程序)在Job被关联加入到Scheduler时创建的,JobDetail包含了Job的各种属性值和 JobDataMap,JobDataMap中存放了与之相关的Job类实例的状态信息。
2.Trigger
用于控制一组Job的触发,包裹SimmperTrigger和CronTrigger,后者支持一种描述触发事件和间隔的表达式语言。Quartz有个很好的想法就是分离了任务和任务执行的条件。Trigger就是控制任务执行条件的类,当Trigger认为执行条件满足的时刻,Trigger会通知相关的Job去执行。分离的好处是:
1).你可以为某个Job关联多个Trigger,其中任何一个条件满足都可以触发job执行,这样可以完成一些组合的高级触发条件
2).当Trigger失效后(比如:一个永远都不能满足的条件),你不必去声明一个新的job,代替的是你可以为job关联一个新的Trigger让job可以继续执行。
3.Scheduler是控制和管理触发器的启动和终止。
使用Scheduler前必须实例化Scheduler,需要由SchedulerFactory类来创建Scheduler,Factory的实例可以通过在JNDI存储中的Factory的序列化的方式获取,实例化Factory后直接使用该实例很容易。
任务调度在目前的JAVA应用程序中运用的十分普遍,故掌握QUARTZ是必备的技能
闲话少说,上官网:http://www.quartz-scheduler.org/ 下载最新1.80资源包
commons-logging log4j sff4j 等jar包要添加进去,quartz的jar包则肯定必须
首先写一个类实现Job接口
- public class QuartzDemo implements Job{
- @Override
- public void execute(JobExecutionContext arg0) throws JobExecutionException {
- System.out.println("执行我.......");
- }
- }
然后写上各种测试实例
- public class Test {
- private static final SimpleTrigger CronTrigger = null;
- public static void main(String[] args){
- }
- public void test1(){
- //通过SchedulerFactory来获取一个调度器
- SchedulerFactory schedulerFactory = new StdSchedulerFactory();
- Scheduler scheduler;
- try {
- scheduler = schedulerFactory.getScheduler();
- //引进作业程序
- JobDetail jobDetail =
- new JobDetail("jobDetail-s1", "jobDetailGroup-s1", QuartzDemo.class);
- //new一个触发器
- SimpleTrigger simpleTrigger =
- new SimpleTrigger("simpleTrigger", "triggerGroup-s1");
- //设置作业启动时间
- long ctime = System.currentTimeMillis();
- simpleTrigger.setStartTime(new Date(ctime));
- //设置作业执行间隔
- simpleTrigger.setRepeatInterval(1000);
- //设置作业执行次数
- simpleTrigger.setRepeatCount(10);
- //设置作业执行优先级默认为5
- //simpleTrigger.setPriority(10);
- //作业和触发器设置到调度器中
- scheduler.scheduleJob(jobDetail, simpleTrigger);
- //启动调度器
- scheduler.start();
- } catch (SchedulerException e) {
- // TODO Auto-generated catch block
- e.printStackTrace();
- }
- }
- public void test2(){
- try {
- SchedulerFactory schedFact = new org.quartz.impl.StdSchedulerFactory();
- Scheduler sched = schedFact.getScheduler();
- sched.start();
- JobDetail jobDetail = new JobDetail( " Income Report " ,
- " Report Generation " , QuartzDemo.class );
- jobDetail.getJobDataMap().put( " type " , " FULL " );
- CronTrigger trigger = new CronTrigger( " Income Report " ,
- " Report Generation " );
- /**/ /* 每1分钟执行一次 */
- trigger.setCronExpression( "0 33 16 * * ?" );
- sched.scheduleJob(jobDetail, trigger);
- } catch (Exception e) {
- e.printStackTrace();
- }
- }
- public void test3(){
- //通过SchedulerFactory来获取一个调度器
- SchedulerFactory schedulerFactory = new StdSchedulerFactory();
- Scheduler scheduler;
- try {
- scheduler = schedulerFactory.getScheduler();
- //引进作业程序
- JobDetail jobDetail =
- new JobDetail("jobDetail-s1", "jobDetailGroup-s1", QuartzDemo.class);
- //new一个触发器
- CronTrigger simpleTrigger =
- new CronTrigger("trigger", "group", "job", "group", "16 26/1 8-17 * * ?");
- // new SimpleTrigger("simpleTrigger", "triggerGroup-s1");
- //设置作业启动时间
- //Calendar excelCal = Calendar.getInstance();
- //excelCal.add(Calendar.DAY_OF_MONTH, 1);
- ///excelCal.set(Calendar.HOUR_OF_DAY, 16);
- //excelCal.set(Calendar.SECOND, 0);
- //excelCal.add(Calendar.MINUTE, 9);
- // long ctime = System.currentTimeMillis();
- // simpleTrigger.setStartTime(excelCal.getTime());
- //设置作业执行间隔
- // simpleTrigger.setRepeatInterval(1000);
- //设置作业执行次数
- // simpleTrigger.setRepeatCount(10);
- //设置作业执行优先级默认为5
- //simpleTrigger.setPriority(10);
- //作业和触发器设置到调度器中
- scheduler.scheduleJob(jobDetail, simpleTrigger);
- //启动调度器
- scheduler.start();
- } catch (SchedulerException e) {
- // TODO Auto-generated catch block
- e.printStackTrace();
- } catch (ParseException e) {
- // TODO Auto-generated catch block
- e.printStackTrace();
- }
- }
- }
需要注意的几点是经常会出现org.quartz.core.ErrorLogger : An error occured instantiating job to be executed.....这种异常,解决办法是
- 1)Job类必须有默认的无参构造方法,当然不覆盖的话类本身就是无参的构造方法
- 2)Job的scope必须是Public类型的,因为quartz根据反射机制实例化类,如果不是public的,无法对其暴露
- 3) Job类不能是内部类,原因同上,所以最好单独建类
后附加上我网上搜集的
- Quartz的配置文件:quartz.properties
- # Configure Main Scheduler Properties
- org.quartz.scheduler.instanceName = TestScheduler
- org.quartz.scheduler.instanceId = one
- # Configure ThreadPool
- org.quartz.threadPool.class = org.quartz.simpl.SimpleThreadPool
- org.quartz.threadPool.threadCount = 5
- org.quartz.threadPool.threadPriority = 4
- # Configure JobStore
- org.quartz.jobStore.misfireThreshold = 5000
- org.quartz.jobStore.class = org.quartz.simpl.RAMJobStore
- 附: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的第一天