quartz实现动态定时任务

一、 说明

     由于最近工作要实现定时任务的执行，而且要求定时周期是不固定的，所以就用到了quartz来实现这个功能；

     spring3.1以下的版本必须使用quartz1.x系列，3.1以上的版本才支持quartz 2.x，不然会出错。至于原因，则是spring对于quartz的支持实现，org.springframework.scheduling.quartz.CronTriggerBean继承了org.quartz.CronTrigger，在quartz1.x系列中org.quartz.CronTrigger是个类，而在quartz2.x系列中org.quartz.CronTrigger变成了接口，从而造成无法用spring的方式配置quartz的触发器（trigger）。

     我使用的quartz版本是2.2.1 。

     最终实现的功能：

      1） 项目启动时，可执行的定时任务启动，按时执行相应的逻辑 ；

     2）  可添加新任务，删除任务，更新任务，暂停任务，恢复任务 ；

二、 添加quartz包

    我使用Gradle构建项目，加包时只需下面一行即可：

   compile "org.quartz-scheduler:quartz:2.2.1"

三、 配置及使用

      1.  配置任务调度器 （对应的文件名为quartz-task.xml）  

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

<? xml  version = "1.0"  encoding = "UTF-8" ?> < beans  xmlns = "http://www.springframework.org/schema/beans"  xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"   xsi:schemaLocation = "http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd"   default-lazy-init = "false" >   <!-- 调度器 -->      < bean  name = "schedulerFactoryBean"  class = "org.springframework.scheduling.quartz.SchedulerFactoryBean" >          <!-- 通过applicationContextSchedulerContextKey属性配置spring上下文 -->              < property  name = "applicationContextSchedulerContextKey" >                  < value >applicationContext</ value >              </ property >         </ bean >        <!--加载可执行的任务-->      < bean  id = "loadTask"  class = "com.quartz.LoadTask"  init-method = "initTask"  />   </ beans >

    2. 服务器启动时加载，在web.xml文件里配置

?

1 2 3 4

< context-param >    < param-name >contextConfigLocation</ param-name >    < param-value >classpath:quartz-task.xml</ param-value >   </ context-param >

   3. 加载可执行任务的类LoadTask.java

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47

public  class  LoadTask {   public  void  initTask()  throws  Exception {    Scheduler scheduler = schedulerFactoryBean.getScheduler();    // 可执行的任务列表    Collection<Task> taskList = taskService.findTask();    for  (Task task : taskList) {     // 任务名称和任务组设置规则：     // 名称：task_1 ..     // 组 ：group_1 ..     TriggerKey triggerKey = TriggerKey.triggerKey(       "task_"  + task.getId(),  "group_"  + task.getId());     CronTrigger trigger = (CronTrigger) scheduler       .getTrigger(triggerKey);     // 不存在，创建一个     if  ( null  == trigger) {      JobDetail jobDetail = JobBuilder        .newJob(QuartzJobFactory. class )        .withIdentity( "task_"  + task.getId(),          "group_"  + task.getId()).build();      jobDetail.getJobDataMap().put( "scheduleJob" , task);      // 表达式调度构建器      CronScheduleBuilder scheduleBuilder = CronScheduleBuilder        .cronSchedule(getCronExpression());      // 按新的表达式构建一个新的trigger      trigger = TriggerBuilder        .newTrigger()        .withIdentity( "task_"  + task.getId(),          "group_"  + task.getId())        .withSchedule(scheduleBuilder).build();      scheduler.scheduleJob(jobDetail, trigger);     }  else  {      // trigger已存在，则更新相应的定时设置      CronScheduleBuilder scheduleBuilder = CronScheduleBuilder        .cronSchedule(taskService.getCronExpression());      // 按新的cronExpression表达式重新构建trigger      trigger = trigger.getTriggerBuilder().withIdentity(triggerKey)        .withSchedule(scheduleBuilder).build();      // 按新的trigger重新设置job执行      scheduler.rescheduleJob(triggerKey, trigger);     }    }   }   @Autowired   private  SchedulerFactoryBean schedulerFactoryBean;   @Autowired   private   TaskService taskService; }

   4. 调度任务的入口

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

public  class  QuartzTaskFactory  implements  Job {      @Override   public  void  execute(JobExecutionContext context)     throws  JobExecutionException {    // TODO Auto-generated method stub    try  {     System.out.println( "任务运行..." );     Task task = (Task) context.getMergedJobDataMap().get(       "scheduleJob" );     System.out.println( "任务名称: ["  + task.getTaskName() +  "]" );     //在这里执行你的任务...     }  catch  (Exception e) {     e.printStackTrace();    }   } }

   5. 暂停任务

?

1 2 3

Scheduler scheduler = schedulerFactoryBean.getScheduler(); JobKey jobKey = JobKey.jobKey(scheduleJob.getJobName(), scheduleJob.getJobGroup()); scheduler.pauseJob(jobKey);

   6. 恢复任务

?

1 2 3

Scheduler scheduler = schedulerFactoryBean.getScheduler(); JobKey jobKey = JobKey.jobKey(scheduleJob.getJobName(), scheduleJob.getJobGroup()); scheduler.resumeJob(jobKey);

  7. 删除任务

?

1 2 3

Scheduler scheduler = schedulerFactoryBean.getScheduler(); JobKey jobKey = JobKey.jobKey(scheduleJob.getJobName(), scheduleJob.getJobGroup()); scheduler.deleteJob(jobKey);

   8. 立即运行任务

?

1 2 3

Scheduler scheduler = schedulerFactoryBean.getScheduler(); JobKey jobKey = JobKey.jobKey(scheduleJob.getJobName(), scheduleJob.getJobGroup()); scheduler.triggerJob(jobKey);

   9. 更新任务（时间表达式）

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

Scheduler scheduler = schedulerFactoryBean.getScheduler();    TriggerKey triggerKey = TriggerKey.triggerKey(scheduleJob.getJobName(), scheduleJob.getJobGroup());    //获取trigger，即在spring配置文件中定义的 bean id="myTrigger" CronTrigger trigger = (CronTrigger) scheduler.getTrigger(triggerKey);    //表达式调度构建器 CronScheduleBuilder scheduleBuilder = CronScheduleBuilder.cronSchedule(scheduleJob .getCronExpression());    //按新的cronExpression表达式重新构建trigger trigger = trigger.getTriggerBuilder().withIdentity(triggerKey) .withSchedule(scheduleBuilder).build();    //按新的trigger重新设置job执行 scheduler.rescheduleJob(triggerKey, trigger);

四、时间表达式说明

  

字段 允许值 允许的特殊字符

秒 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触发

每天早上6点

0 6 * * *

每两个小时

0 */2 * * *

晚上11点到早上8点之间每两个小时，早上八点

0 23-7/2，8 * * *

每个月的4号和每个礼拜的礼拜一到礼拜三的早上11点

0 11 4 * 1-3

1月1日早上4点

0 4 1 1 *

ok，定时任务已经正确执行....