调度任务框架Quart的使用

Cron表达式Quartz使用类似于Linux下的Cron表达式定义时间规则，Cron表达式由6或7个由空格分隔的时间字段组成，如表1所示：表1Cron表达式时间字段位置时间域名允许值允许的特殊字符1秒0-59，-*/2分钟0-59，-*/3小时0-23，-*/4日期1-31，-*?/LWC5月份1-12，-*/6星期1-7，-*?/LC#7年(可选)空值1970-2099，-*/Cron表达式的时间字段除允许设置数值外，还可使用一些特殊的字符，提供列表、范围、通配符等功能,细说如下：•星号(*)：可用在所有字段中，表示对应时间域的每一个时刻，例如，*在分钟字段时，表示''每分钟”；•问号(？)：该字符只在日期和星期字段中使用，它通常指定为''无意义的值”，相当于点位符；•减号(-)：表达一个范围，如在小时字段中使用“10-12”，则表示从10到12点，即10,11,12；•逗号(,)：表达一个列表值，如在星期字段中使用“MON,WED,FRI”，则表示星期一，星期三和星期五；•斜杠(/)：x/y表达一个等步长序列，x为起始值，y为增量步长值。如在分钟字段中使用0/15,贝俵示为0,15,30和45秒，而5/15在分钟字段中表示5,20,35,50,你也可以使用*/y，它等同于0/y；•L：该字符只在日期和星期字段中使用，代表“Last”的意思，但它在两个字段中意思不同。L在日期字段中,表示这个月份的最后一天，如一月的31号,非闰年二月的28号;如果L用在星期中，则表示星期六,等同于7。但是，如果L出现在星期字段里，而且在前面有一个数值X,则表示''这个月的最后X天”，例如，6L表示该月的最后星期五；•W：该字符只能出现在日期字段里，是对前导日期的修饰，表示离该日期最近的工作日。例如15W表示离该月15号最近的工作日，如果该月15号是星期六，则匹配14号星期五；如果15日是星期日，则匹配16号星期一；如果15号是星期二，那结果就是15号星期二。但必须注意关联的匹配日期不能够跨月，如你指定1W,如果1号是星期六，结果匹配的是3号星期一，而非上个月最后的那天。W字符串只能指定单一日期，而不能指定日期范围；LW组合：在日期字段可以组合使用LW,它的意思是当月的最后一个工作日；•井号(#)：该字符只能在星期字段中使用，表示当月某个工作日。如6#3表示当月的第三个星期五(6表示星期五，#3表示当前的第三个)，而4#5表示当月的第五个星期三，假设当月没有第五个星期三，忽略不触发；C：该字符只在日期和星期字段中使用，代表“Calendar”的意思。它的意思是计划所关联的日期，如果日期没有被关联，则相当于日历中所有日期。例如5C在日期字段中就相当于日历5日以后的第一天。1C在星期字段中相当于星期日后的第一天。Cron表达式对特殊字符的大小写不敏感，对代表星期的缩写英文大小写也不敏感。表2下面给出一些完整的Cron表示式的实例：表2Cron表示式示例表示式说明"0012**?"每天12点运行"01510?**"每天10:15运行"01510**?"每天10:15运行"01510**?*"每天10:15运行"01510**?2008"在2008年的每天10：15运行"0*14**?"每天14点到15点之间每分钟运行一次，开始于14:00，结束于14:59。"00/514**?"每天14点到15点每5分钟运行一次，开始于14:00，结束于14:55。"00/514,18**?"每天14点到15点每5分钟运行一次，此外每天18点到19点每5钟也运行一次。"00-514**?"每天14:00点到14:05，每分钟运行一次。"010,4414?3WED"3月每周三的14:10分到14:44，每分钟运行一次。"01510?*MON-FRI"每周一，二，三，四，五的10:15分运行。"0151015*?"每月15日10:15分运行。"01510L*?"每月最后一天10:15分运行。"01510?*6L"每月最后一个星期五10:15分运行。"01510?*6L2007-2009"在2007,2008,2009年每个月的最后一个星期五的10:15分运行。"01510?*6#3"每月第三个星期五的10:15分运行。1.新建任务接口JobpublicinterfaceJob{publicvoidexecute(JobExecutionContextcontext)throwsJobExecutionException;}2•创建接口Job的实现类publicclassSimpleJobimplementsJob{publicvoidexecute(JobExecutionContextargO)throwsJobExecutionException{System.out.println("SimpleJob");〃执行内容}}调度任务执行建立要素.新建调度工厂SchedulerFactory对象sfSchedulerFactorysf=newStdSchedulerFactory();.获取调度任务对象Schedulersched=sf.getScheduler();•几种触发开始时间设置Date startTime=org.quartz.DateBuilder.dateOf(int hour,intminute,intsecond,intdayOfMonth,intmonth,intyear)DatestartTime=org.quartz.DateBuilder.dateOf(inthour,intminute,intsecond)DatestartTime=newDate(System.currentTimeMillis()+60000L))/指定60秒钟以后开始。DatestartTime=DateBuilder.nextGivenSecondDate(null,15);/每分钟以15秒为单位，当前时间下个15秒开始DatestartTime=DateBuilder.nextGivenSecondDate(null,5);//每分钟以5秒为单位，当前时间下个5秒开始DatestartTime=evenMinuteDate(newDate());〃当前时间下一分钟开始DatestartTime=futureDate(5,IntervalUnit.SECOND);//当前时间加5秒开始DatestartTime=futureDate(5,IntervalUnit.MINUTE);//当前时间加5分钟开始//IntervalUnit的属性有(SECOND,MINUTE，HOUR，DAYWEEK,MONTH,YEAR)(4).新建任务job并设置一执行对象SimpleJob.class中execute()方法JobDetailjob=newJob(SimpleJob.class).withIdentity("job1","group1").build();新建触发器并设置〃1.触发一次atstartTimeSimpleTriggertrigger=(SimpleTrigger)newTrigger().withIdentity("trigger1","tgroup1")〃设置触发器(名称，组名)―全名.startAt(startTime)//设置开始时间.build();ft=sched.scheduleJob(job,trigger);〃2.先触发1次atstartTime,再重复触发10次,1次/10秒。如果10次内调度schedule关闭，也将提前终止。job=newJob(SimpleJob.class).withIdentity("job2","group1").build();trigger=newTrigger().withIdentity("trigger2","tgroup1").startAt(startTime).withSchedule(simpleSchedule().withIntervalInSeconds(10)〃一次/10s.withRepeatCount(10))〃重复触发共10次.build();ft=sched.scheduleJob(job,trigger);〃3.先触发1次atstartTime,再重复一直触发直到调度schedule关闭,1次/30秒。job=newJob(SimpleJob.class).withIdentity("job3","group1").build();trigger=newTrigger().withIdentity("trigger3","tgroup1").startAt(startTime).withSchedule(simpleSchedule().withIntervalInSeconds(30).repeatForever())〃一直重复触发.build();ft=sched.scheduleJob(job,trigger);〃4.先触发1次atstartTime,再重复触发20次,1次/5分钟。job=newJob(SimpleJob.class).withIdentity("job4","group1").build();trigger=newTrigger().withIdentity("trigger4","tgroup1").startAt(startTime).withSchedule(simpleSchedule().withIntervalInMinutes(5).withRepeatCount(20)).build();ft=sched.scheduleJob(job,trigger);〃5.先触发1次atstartTime,再重复触发5次,1次/2小时。job=newJob(SimpleJob.class).withIdentity("job5","group1").build();trigger=newTrigger().withIdentity("trigger5","tgroup1").startAt(startTime).withSchedule(simpleSchedule().withIntervalInHours(2).withRepeatCount(5)).build();ft=sched.scheduleJob(job,trigger);〃6•与上相同任务job5，创建另外触发器trigger=newTrigger().withIdentity("trigger5","tgroup2").startAt(startTime).withSchedule(simpleSchedule().withIntervalInSeconds(10).withRepeatCount(2)).forJob(job).build();ft=sched.scheduleJob(trigger);向调度中增加一对任务和触发器返回调度触发时间Dateft=sched.scheduleJob(job,trigger);调度开始启动sched.start();设置调度关闭等待时间Thread.sleep(60L*1000L);//等待60秒，才进行下步。调度关闭，所有调度任务终止sched.shutdown(true);3•其他触发器设置方法(计划任务工具)〃触发器1次/20秒CronTriggertrigger=newTrigger().withIdentity("trigger1","group1").withSchedule(cronSchedule("0/20****?")).build();〃触发器1次/2分钟，并在分钟的第15秒开始trigger=newTrigger().withIdentity("trigger2","group1").withSchedule(cronSchedule("150/2***?")).build();〃触发器1次/2分钟，并在上午8点到下午5点之间开始trigger=newTrigger().withIdentity("trigger3","group1").withSchedule(cronSchedule("O0/28-17**?")).build();〃触发器1次/3分钟，并在下午5点到晚上11点之间开始trigger=newTrigger().withIdentity("trigger4","group1").withSchedule(cronSchedule("O0/317-23**?")).build();〃触发器在每月1日到15日之间的10:00开始trigger=newTrigger().withIdentity("trigger5","group1").withSchedule(cronSchedule("O010am1,15*?")).build();〃触发器1次/30秒，在Monday到Friday之间开始trigger=newTrigger().withIdentity("trigger6","group1").withSchedule(cronSchedule("0,30**?*MON-FRI")).build();〃触发器1次/30秒，在Saturday,Sunday开始trigger=newTrigger().withIdentity("trigger7","groupl").withSchedule(cronSchedule("0,30**?*SAT,SUN")).build();其他方法介绍(l)JobExecutionContextcontext方法JobKeyjobKey=context.getJobDetail().getKey();JobDataMapdata=context.getJobDetail().getJobDataMap();⑵Job方法JobKeyjobkey=job.getKey();JobDataMapmap=job.getJobDataMap();Scheduler方法scheduler.clear()〃提供方便用于清除所有任务、触发器和日程的方法scheduler.scheduleJobs(MapvJobDetail,ListvTrigger>>triggersAndJobs,booleanreplace)//方法可批量增加任务和触发器scheduler.unscheduleJobs(ListvTriggerKey>triggerKeys)//方法提供批量取消任务的scheduler.deleteJobs(ListvJobKey>jobKeys)/批量删除任务的scheduler.deleteJob(JobKeyjobKey)//删除单个任务的scheduler.checkExists(JobKeyjobKey)和Scheduler.heckExists(TriggerKeytriggerKey)//提供用于检测任务关键字的唯一性触发器SimpleTrigge属性设置方法SimpleTriggesimpleTrigge=(SimpleTrigger)newTrigger().withIdentity("trigger1","groupl")//设置触发器(名称，组名)-全名.startAt(startTime)//设置开始时间.EndAt(endTime)//设置结束时间.withRepeatCount()〃获取触发器重复次数.withRepeatInterval()//1000获取触发器重复触发间隔时间秒.repeatForever()〃永久重复触发.build();(5)触发器CronTrigger属性设置方法CronTriggertrigger=newTrigger().withIdentity("trigger1","groupl").withSchedule(cronSchedule("0/20****?"))//触发器1次/20秒.build();(6)其他方法Thread.sleep(30L*1000L);/等待30秒，才进行下步。5•调度与任务之间传递参数--例如(1)任务job--ColorJob代码；publicclassColorJobimplementsJob{publicstaticfinalStringFA/ORITE_COLOR="favoritecolor";publicstaticfinalStringEXECUTION_COUNT="count";publicstaticint_counter=1;publicvoidexecute(JobExecutionContextcontext)throwsJobExecutionException{JobKeyjobKey=context.getJobDetail().getKey();JobDataMapdata=context.getJobDetail().getJobDataMap();StringfavoriteColor=data.getString(FA/ORITE_COLOR);intcount=data.getInt(EXECUTION_COUNT);("ColorJob:"+jobKey+"executingat"+newDate()+"\n"+"favoritecoloris"+favoriteColor+"\n"+"executioncount(fromjobmap)is"+count+"\n"+"executioncount(fromjobmembervariable)is"+_counter++);count++;data.put(EXECUTION_COUNT,count);}}(2)调度中相应设置部分代码DatestartTime=nextGivenSecondDate(null,10);//job1willonlyrun5times(atstarttime,plus4repeats),every10secondsJobDetailjob1=newJob(ColorJob.class).withIdentity("jobl","groupl").build();SimpleTriggertriggerl=newTrigger().withIdentity("triggerl","group1").startAt(startTime).withSchedule(simpleSchedule().withIntervalInSeconds(10).withRepeatCount(4)).build();//passinitializationparametersintothejob--对任务的参数初始化job1.getJobDataMap().put(ColorJob.FA/ORITE_COLOR,"Green");job1.getJobDataMap().put(ColorJob.EXECUTION_COUNT,1);//schedulethejobtorunDatescheduleTime1=sched.scheduleJob(job1,trigger1);6.触发器中日历Calendar使用〃法定节日是以每年为周期的，所以使用AnnualCalendar//AddtheholidaycalendartothescheduleAnnualCalendarholidays=newAnnualCalendar();//fourthofJuly(July4)CalendarfourthOfJuly=newGregorianCalendar(2012,6,4);holidays.setDayExcluded(fourthOfJuly,true);//true排除的日期，如果设置为false则为包含//halloween(Oct31)Calendarhalloween=newGregorianCalendar(2012,9,31);holidays.setDayExcluded(halloween,true);//christmas(Dec25)Calendarchristmas=newGregorianCalendar(2012,10,24);holidays.setDayExcluded(christmas,true);//tellthescheduleaboutourholidaycalendarsched.addCalendar("holidays",holidays,false,false);//向Scheduler注册日历//scheduleajobtorunhourly,startingonhalloween//at10am//DaterunDate=DateBuilder.dateOf(11,46,10);DaterunDate=DateBuilder.nextGivenSecondDate(null,10);JobDetailjob=newJob(SimpleJob.class).withIdentity("job1","group1").build();SimpleTriggertrigger=newTrigger().withIdentity("trigger1","group1").startAt(runDate).withSchedule(simpleSchedule().withIntervalInHours(1).repeatForever()).modifiedByCalendar("holidays").build();//schedulethejobandprintthefirstrundateDatefirstRunTime=sched.scheduleJob(job,trigger);7•监听器的使用(1)新建SimpleJob1代码如下importjava.util.Date;importorg.quartz.Job;importorg.quartz.JobExecutionContext;importorg.quartz.JobExecutionException;importorg.quartz.JobKey;importorg.slf4j.Logger;importorg.slf4j.LoggerFactory;publicclassSimpleJoblimplementsJob{privatestaticLogger_log=LoggerFactory.getLogger(SimpleJob1.class);/***Emptyconstructorforjobinitilization*/publicSimpleJob1(){}publicvoidexecute(JobExecutionContextcontext)throwsJobExecutionException{//Thisjobsimplyprintsoutitsjobnameandthe//dateandtimethatitisrunningJobKeyjobKey=context.getJobDetail().getKey();("SimpleJob1says:"+jobKey+"executingat"+newDate());}}(2)新建SimpleJob2代码如下importjava.util.Date;importorg.quartz.Job;importorg.quartz.JobExecutionContext;importorg.quartz.JobExecutionException;importorg.quartz.JobKey;importorg.slf4j.Logger;importorg.slf4j.LoggerFactory;publicclassSimpleJob2implementsJob{privatestaticLogger_log=LoggerFactory.getLogger(SimpleJob2.class);/***Emptyconstructorforjobinitilization*/publicSimpleJob2(){}publicvoidexecute(JobExecutionContextcontext)throwsJobExecutionException{//Thisjobsimplyprintsoutitsjobnameandthe//dateandtimethatitisrunningJobKeyjobKey=context.getJobDetail().getKey();("SimpleJob2says:"+jobKey+"executingat"+newDate());}}(3)创建监听器接口JobListener的实现类JoblListener，当调度触发任务SimpleJobl时,执行此监听器并把SimpleJob2注册到调度中。importstaticorg.quartz.JobBuilder.newJob;importstaticorg.quartz.TriggerBuilder.newTrigger;importorg.quartz.JobDetail;importorg.quartz.JobExecutionContext;importorg.quartz.JobExecutionException;importorg.quartz.JobListener;importorg.quartz.SchedulerException;importorg.quartz.SimpleTrigger;importorg.quartz.Trigger;importorg.slf4j.Logger;importorg.slf4j.LoggerFactory;publicclassJob1ListenerimplementsJobListener{privatestaticLogger_log=LoggerFactory.getLogger(Job1Listener.class);publicStringgetName(){return"job1_to_job2";}publicvoidjobToBeExecuted(JobExecutionContextinContext){("Job1Listenersays:JobIsabouttobeexecuted.");}publicvoidjobExecutionVetoed(JobExecutionContextinContext){("JoblListenersays:JobExecutionwasvetoed.");}publicvoidjobWasExecuted(JobExecutionContextinContext,JobExecutionExceptioninException){("Job1Listenersays:Jobwasexecuted.");//Simplejob#2JobDetailjob2=newJob(SimpleJob2.class).withIdentity("job2").build();Triggertrigger=(SimpleTrigger)newTrigger().withIdentity("job2Trigger").startNow().build();try{//schedulethejobtorun!inContext.getScheduler().scheduleJob(job2,trigger);}catch(SchedulerExceptione){」og.warn("Unabletoschedulejob2!");e.printStackTrace();}}}(4)创建调度程序，把监听器Job1Listener绑定到任务SimpleJob1的触发事件中。importstaticorg.quartz.JobBuilder.newJob;importstaticorg.quartz.SimpleScheduleBuilder.simpleSchedule;importstaticorg.quartz.TriggerBuilder.newTrigger;importjava.util.Date;importorg.quartz.JobDetail;importorg.quartz.JobKey;importorg.quartz.JobListener;importorg.quartz.ListenerManager;importorg.quartz.Matcher;importorg.quartz.Scheduler;importorg.quartz.SchedulerFactory;importorg.quartz.SchedulerMetaData;importorg.quartz.SimpleTrigger;importorg.quartz.Trigger;importorg.quartz.impl.StdSchedulerFactory;importorg.quartz.impl.matchers.KeyMatcher;importorg.slf4j.Logger;importorg.slf4j.LoggerFactory;/**Demonstratesthebehaviorofvcode>JobListenerv/code>s.Inparticular,thisexamplewilluseajoblistenertotriggeranotherjobafteronejobsuccesfullyexecutes.**/publicclass