詳解Spring整合Quartz實現(xiàn)動態(tài)定時任務(wù)

更新時間：2017年03月03日 11:48:31 作者：-糖先生

本篇文章主要介紹了詳解Spring整合Quartz實現(xiàn)動態(tài)定時任務(wù)，具有一定的參考價值，感興趣的小伙伴們可以參考一下。

最近項目中需要用到定時任務(wù)的功能，雖然spring 也自帶了一個輕量級的定時任務(wù)實現(xiàn)，但感覺不夠靈活，功能也不夠強(qiáng)大。在考慮之后，決定整合更為專業(yè)的Quartz來實現(xiàn)定時任務(wù)功能。

普通定時任務(wù)

首先，當(dāng)然是添加依賴的jar文件，我的項目是maven管理的，以下的我項目的依賴：

<dependencies>
  <dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-core</artifactId>
    <version>${spring.version}</version>
  </dependency>
  <dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-context</artifactId>
    <version>${spring.version}</version>
  </dependency>
  <dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-web</artifactId>
    <version>${spring.version}</version>
  </dependency>
  <dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-tx</artifactId>
    <version>${spring.version}</version>
  </dependency>
  <dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-jdbc</artifactId>
    <version>${spring.version}</version>
  </dependency>
  <dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>${mybatis.version}</version>
  </dependency>
  <dependency>
    <groupId>org.aspectj</groupId>
    <artifactId>aspectjweaver</artifactId>
    <version>1.7.4</version>
  </dependency>
  <dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis-spring</artifactId>
    <version>${mybatis.spring.version}</version>
  </dependency>
  <dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-log4j12</artifactId>
    <version>${slf4j.version}</version>
  </dependency>
  <dependency>
    <groupId>commons-lang</groupId>
    <artifactId>commons-lang</artifactId>
    <version>${commons.lang.version}</version>
  </dependency>
  <dependency>
    <groupId>commons-dbcp</groupId>
    <artifactId>commons-dbcp</artifactId>
    <version>${commons.dbcp.version}</version>
  </dependency>
  <dependency>
    <groupId>com.oracle</groupId>
    <artifactId>ojdbc14</artifactId>
    <version>${ojdbc.version}</version>
  </dependency>
  <dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-context-support</artifactId>
    <version>${spring.version}</version>
  </dependency>
  <dependency>
    <groupId>org.quartz-scheduler</groupId>
    <artifactId>quartz</artifactId>
    <version>${quartz.version}</version>
  </dependency>
</dependencies>

或許你應(yīng)該看出來了，我的項目是spring整合了mybatis，目前spring的最新版本已經(jīng)到了4.x系列，但是最新版的mybatis-spring的整合插件所依賴推薦的依然是spring 3.1.3.RELEASE，所以這里沒有用spring的最新版而是用了推薦的3.1.3.RELEASE，畢竟最新版本的功能一般情況下也用不到。

至于quartz，則是用了目前的最新版2.2.1

之所以在這里特別對版本作一下說明，是因為spring和quartz的整合對版本是有要求的。

spring3.1以下的版本必須使用quartz1.x系列，3.1以上的版本才支持quartz 2.x，不然會出錯。

至于原因，則是spring對于quartz的支持實現(xiàn)，org.springframework.scheduling.quartz.CronTriggerBean繼承了org.quartz.CronTrigger，在quartz1.x系列中org.quartz.CronTrigger是個類，而在quartz2.x系列中org.quartz.CronTrigger變成了接口，從而造成無法用spring的方式配置quartz的觸發(fā)器（trigger）。

在Spring中使用Quartz有兩種方式實現(xiàn)：第一種是任務(wù)類繼承QuartzJobBean，第二種則是在配置文件里定義任務(wù)類和要執(zhí)行的方法，類和方法可以是普通類。很顯然，第二種方式遠(yuǎn)比第一種方式來的靈活。

這里采用的就是第二種方式。

spring配置文件：

<!-- 使用MethodInvokingJobDetailFactoryBean，任務(wù)類可以不實現(xiàn)Job接口，通過targetMethod指定調(diào)用方法-->
<bean id="taskJob" class="com.tyyd.dw.task.DataConversionTask"/>
<bean id="jobDetail" class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">
  <property name="group" value="job_work"/>
  <property name="name" value="job_work_name"/>
  <!--false表示等上一個任務(wù)執(zhí)行完后再開啟新的任務(wù)-->
  <property name="concurrent" value="false"/>
  <property name="targetObject">
    <ref bean="taskJob"/>
  </property>
  <property name="targetMethod">
    <value>run</value>
  </property>
</bean>

<!-- 調(diào)度觸發(fā)器 -->
<bean id="myTrigger"
   class="org.springframework.scheduling.quartz.CronTriggerFactoryBean">
  <property name="name" value="work_default_name"/>
  <property name="group" value="work_default"/>
  <property name="jobDetail">
    <ref bean="jobDetail" />
  </property>
  <property name="cronExpression">
    <value>0/5 * * * * ?</value>
  </property>
</bean>

<!-- 調(diào)度工廠 -->
<bean id="scheduler" class="org.springframework.scheduling.quartz.SchedulerFactoryBean">
  <property name="triggers">
    <list>
      <ref bean="myTrigger"/>
    </list>
  </property>
</bean>

Task類則是一個普通的Java類，沒有繼承任何類和實現(xiàn)任何接口(當(dāng)然可以用注解方式來聲明bean)：

//@Component
public class DataConversionTask{

  /** 日志對象 */
  private static final Logger LOG = LoggerFactory.getLogger(DataConversionTask.class);

  public void run() {

    if (LOG.isInfoEnabled()) {
      LOG.info("數(shù)據(jù)轉(zhuǎn)換任務(wù)線程開始執(zhí)行");
    }
  }
}

至此，簡單的整合大功告成，run方法將每隔5秒執(zhí)行一次，因為配置了concurrent等于false，所以假如run方法的執(zhí)行時間超過5秒，在執(zhí)行完之前即使時間已經(jīng)超過了5秒下一個定時計劃執(zhí)行任務(wù)仍不會被開啟，如果是true，則不管是否執(zhí)行完，時間到了都將開啟。

接下去，將實現(xiàn)如何動態(tài)的修改定時執(zhí)行的時間，以及如何停止正在執(zhí)行的任務(wù)。

順便貼一下cronExpression表達(dá)式備忘：

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

秒 0-59 , – * /
分 0-59 , – * /
小時 0-23 , – * /
日期 1-31 , – * ? / L W C
月份 1-12 或者 JAN-DEC , – * /
星期 1-7 或者 SUN-SAT , – * ? / L C #
年（可選）留空, 1970-2099 , – * /

表達(dá)式意義

"0 0 12 * * ?"       每天中午12點觸發(fā)
"0 15 10 ? * *"       每天上午10:15觸發(fā)
"0 15 10 * * ?"       每天上午10:15觸發(fā)
"0 15 10 * * ? *"      每天上午10:15觸發(fā)
"0 15 10 * * ? 2005"    2005年的每天上午10:15觸發(fā)
"0 * 14 * * ?"       在每天下午2點到下午2:59期間的每1分鐘觸發(fā)
"0 0/5 14 * * ?"      在每天下午2點到下午2:55期間的每5分鐘觸發(fā)
"0 0/5 14,18 * * ?"     在每天下午2點到2:55期間和下午6點到6:55期間的每5分鐘觸發(fā)
"0 0-5 14 * * ?"      在每天下午2點到下午2:05期間的每1分鐘觸發(fā)
"0 10,44 14 ? 3 WED"    每年三月的星期三的下午2:10和2:44觸發(fā)
"0 15 10 ? * MON-FRI"    周一至周五的上午10:15觸發(fā)
"0 15 10 15 * ?"      每月15日上午10:15觸發(fā)
"0 15 10 L * ?"       每月最后一日的上午10:15觸發(fā)
"0 15 10 ? * 6L"      每月的最后一個星期五上午10:15觸發(fā)
"0 15 10 ? * 6L 2002-2005" 2002年至2005年的每月的最后一個星期五上午10:15觸發(fā)
"0 15 10 ? * 6#3"      每月的第三個星期五上午10:15觸發(fā)
0 6 * * *          每天早上6點
0 */2 * * *         每兩個小時
0 23-7/2，8 * * *      晚上11點到早上8點之間每兩個小時，早上八點
0 11 4 * 1-3        每個月的4號和每個禮拜的禮拜一到禮拜三的早上11點
0 4 1 1 *          1月1日早上4點

動態(tài)添加定時任務(wù)

前面，我們已經(jīng)對Spring和Quartz用配置文件的方式進(jìn)行了整合，如果需求比較簡單的話應(yīng)該已經(jīng)可以滿足了。但是很多時候，我們常常會遇到需要動態(tài)的添加或修改任務(wù)，而spring中所提供的定時任務(wù)組件卻只能夠通過修改xml中trigger的配置才能控制定時任務(wù)的時間以及任務(wù)的啟用或停止，這在帶給我們方便的同時也失去了動態(tài)配置任務(wù)的靈活性。我搜索了一些網(wǎng)上的解決方法，都沒有很好的解決這個問題，而且大多數(shù)提到的解決方案都停留在Quartz 1.x系列版本上，所用到的代碼和API已經(jīng)不能適用于新版本的Spring和Quartz。沒辦法只能靠自己了，花了點時間好好研究了一下Spring和Quartz中相關(guān)的代碼。

首先我們來回顧一下spring中使用quartz的配置代碼：

<!-- 使用MethodInvokingJobDetailFactoryBean，任務(wù)類可以不實現(xiàn)Job接口，通過targetMethod指定調(diào)用方法-->
<bean id="taskJob" class="com.tyyd.dw.task.DataConversionTask"/>
<bean id="jobDetail" class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">
  <property name="group" value="job_work"/>
  <property name="name" value="job_work_name"/>
  <!--false表示等上一個任務(wù)執(zhí)行完后再開啟新的任務(wù)-->
  <property name="concurrent" value="false"/>
  <property name="targetObject">
    <ref bean="taskJob"/>
  </property>
  <property name="targetMethod">
    <value>execute</value>
  </property>
</bean>

<!-- 調(diào)度觸發(fā)器 -->
<bean id="myTrigger"
   class="org.springframework.scheduling.quartz.CronTriggerFactoryBean">
  <property name="name" value="work_default_name"/>
  <property name="group" value="work_default"/>
  <property name="jobDetail">
    <ref bean="jobDetail" />
  </property>
  <property name="cronExpression">
    <value>0/5 * * * * ?</value>
  </property>
</bean>

<!-- 調(diào)度工廠 -->
<bean id="scheduler" class="org.springframework.scheduling.quartz.SchedulerFactoryBean">
  <property name="triggers">
    <list>
      <ref bean="myTrigger"/>
    </list>
  </property>
</bean>

所有的配置都在xml中完成，包括cronExpression表達(dá)式，十分的方便。但是如果我的任務(wù)信息是保存在數(shù)據(jù)庫的，想要動態(tài)的初始化，而且任務(wù)較多的時候不是得有一大堆的xml配置？或者說我要修改一下trigger的表達(dá)式，使原來5秒運行一次的任務(wù)變成10秒運行一次，這時問題就來了，試過在配置文件中不傳入cronExpression等參數(shù)，但是啟動時就報錯了，難道我每次都修改xml文件然后重啟應(yīng)用嗎，這顯然不合適的。最理想的是在與spring整合的同時又能實現(xiàn)動態(tài)任務(wù)的添加、刪除及修改配置。

我們來看一下spring實現(xiàn)quartz的方式，先看一下上面配置文件中定義的jobDetail。其實上面生成的jobDetail并不是我們定義的Bean，因為在Quartz 2.x版本中JobDetail已經(jīng)是一個接口（當(dāng)然以前的版本也并非直接生成JobDetail）：

public interface JobDetail extends Serializable, Cloneable {…｝

Spring是通過將其轉(zhuǎn)換為MethodInvokingJob或StatefulMethodInvokingJob類型來實現(xiàn)的，這兩個都是靜態(tài)的內(nèi)部類，MethodInvokingJob類繼承于QuartzJobBean，而StatefulMethodInvokingJob則直接繼承于MethodInvokingJob。這兩個類的實現(xiàn)區(qū)別在于有狀態(tài)和無狀態(tài)，對應(yīng)于quartz的Job和StatefulJob，具體可以查看quartz文檔，這里不再贅述。先來看一下它們實現(xiàn)的QuartzJobBean的主要代碼：

/**
 * This implementation applies the passed-in job data map as bean property
 * values, and delegates to <code>executeInternal</code> afterwards.
 * @see #executeInternal
 */
public final void execute(JobExecutionContext context) throws JobExecutionException {
  try {
    // Reflectively adapting to differences between Quartz 1.x and Quartz 2.0...
    Scheduler scheduler = (Scheduler) ReflectionUtils.invokeMethod(getSchedulerMethod, context);
    Map mergedJobDataMap = (Map) ReflectionUtils.invokeMethod(getMergedJobDataMapMethod, context);

    BeanWrapper bw = PropertyAccessorFactory.forBeanPropertyAccess(this);
    MutablePropertyValues pvs = new MutablePropertyValues();
    pvs.addPropertyValues(scheduler.getContext());
    pvs.addPropertyValues(mergedJobDataMap);
    bw.setPropertyValues(pvs, true);
  }
  catch (SchedulerException ex) {
    throw new JobExecutionException(ex);
  }
  executeInternal(context);
}

/**
 * Execute the actual job. The job data map will already have been
 * applied as bean property values by execute. The contract is
 * exactly the same as for the standard Quartz execute method.
 * @see #execute
 */
protected abstract void executeInternal(JobExecutionContext context) throws JobExecutionException;
//還有MethodInvokingJobDetailFactoryBean中的代碼：

public void afterPropertiesSet() throws ClassNotFoundException, NoSuchMethodException {
  prepare();

  // Use specific name if given, else fall back to bean name.
  String name = (this.name != null ? this.name : this.beanName);

  // Consider the concurrent flag to choose between stateful and stateless job.
  Class jobClass = (this.concurrent ? MethodInvokingJob.class : StatefulMethodInvokingJob.class);

  // Build JobDetail instance.
  if (jobDetailImplClass != null) {
    // Using Quartz 2.0 JobDetailImpl class...
    this.jobDetail = (JobDetail) BeanUtils.instantiate(jobDetailImplClass);
    BeanWrapper bw = PropertyAccessorFactory.forBeanPropertyAccess(this.jobDetail);
    bw.setPropertyValue("name", name);
    bw.setPropertyValue("group", this.group);
    bw.setPropertyValue("jobClass", jobClass);
    bw.setPropertyValue("durability", true);
    ((JobDataMap) bw.getPropertyValue("jobDataMap")).put("methodInvoker", this);
  }
  else {
    // Using Quartz 1.x JobDetail class...
    this.jobDetail = new JobDetail(name, this.group, jobClass);
    this.jobDetail.setVolatility(true);
    this.jobDetail.setDurability(true);
    this.jobDetail.getJobDataMap().put("methodInvoker", this);
  }

  // Register job listener names.
  if (this.jobListenerNames != null) {
    for (String jobListenerName : this.jobListenerNames) {
      if (jobDetailImplClass != null) {
        throw new IllegalStateException("Non-global JobListeners not supported on Quartz 2 - " +
            "manually register a Matcher against the Quartz ListenerManager instead");
      }
      this.jobDetail.addJobListener(jobListenerName);
    }
  }

  postProcessJobDetail(this.jobDetail);
}

上面主要看我們目前用的Quartz 2.0版本的實現(xiàn)部分，到這里或許你已經(jīng)明白Spring對Quartz的封裝原理了。Spring就是通過這種方式在最后Job真正執(zhí)行時反調(diào)用到我們所注入的類和方法。

現(xiàn)在，理解了Spring的實現(xiàn)原理后，我們就可以來設(shè)計我們自己的了。在設(shè)計時我想到以下幾點：

1、減少spring的配置文件，為了實現(xiàn)一個定時任務(wù)，spring的配置代碼太多了。

2、用戶可以通過頁面等方式添加、啟用、禁用某個任務(wù)。

3、用戶可以修改某個已經(jīng)在運行任務(wù)的運行時間表達(dá)式，CronExpression。

4、為方便維護(hù)，簡化任務(wù)的運行調(diào)用處理，任務(wù)的運行入口即Job實現(xiàn)類最好只有一個，該Job運行類相當(dāng)于工廠類，在實際調(diào)用時把任務(wù)的相關(guān)信息通過參數(shù)方式傳入，由該工廠類根據(jù)任務(wù)信息來具體執(zhí)行需要的操作。

在上面的思路下來進(jìn)行我們的開發(fā)吧。

一、spring配置文件

通過研究，發(fā)現(xiàn)要實現(xiàn)我們的功能，只需要以下配置：

二、任務(wù)運行入口，即Job實現(xiàn)類，在這里我把它看作工廠類：

/**
 * 定時任務(wù)運行工廠類
 * 
 * @author tq
 * @date 2016/5/1
 */
public class QuartzJobFactory implements Job {

  @Override
  public void execute(JobExecutionContext context) throws JobExecutionException {
    System.out.println("任務(wù)成功運行");
    ScheduleJob scheduleJob = (ScheduleJob)context.getMergedJobDataMap().get("scheduleJob");
    System.out.println("任務(wù)名稱 = [" + scheduleJob.getJobName() + "]");
  }
}

這里我們實現(xiàn)的是無狀態(tài)的Job，如果要實現(xiàn)有狀態(tài)的Job在以前是實現(xiàn)StatefulJob接口，在我使用的quartz 2.2.1中，StatefulJob接口已經(jīng)不推薦使用了，換成了注解的方式，只需要給你實現(xiàn)的Job類加上注解@DisallowConcurrentExecution即可實現(xiàn)有狀態(tài)：

/**
* 定時任務(wù)運行工廠類
 * @author tq
 * @date 2016/5/1
*/
@DisallowConcurrentExecution
public class QuartzJobFactory implements Job {...}

三、創(chuàng)建任務(wù)

既然要動態(tài)的創(chuàng)建任務(wù)，我們的任務(wù)信息當(dāng)然要保存在某個地方了，這里我們新建一個保存任務(wù)信息對應(yīng)的實體類：

/**
 * 計劃任務(wù)信息
 * 
 * @author tq
 * @date 2016/5/1
 */
public class ScheduleJob {
  /** 任務(wù)id */
  private String jobId;
  /** 任務(wù)名稱 */
  private String jobName;
  /** 任務(wù)分組 */
  private String jobGroup;
  /** 任務(wù)狀態(tài) 0禁用 1啟用 2刪除*/
  private String jobStatus;
  /** 任務(wù)運行時間表達(dá)式 */
  private String cronExpression;
  /** 任務(wù)描述 */
  private String desc;
  getter and setter ....
}

接下來我們創(chuàng)建測試數(shù)據(jù)，實際應(yīng)用中該數(shù)據(jù)可以保存在數(shù)據(jù)庫等地方，我們把任務(wù)的分組名+任務(wù)名作為任務(wù)的唯一key，和quartz中的實現(xiàn)方式一致：

/** 計劃任務(wù)map */
private static Map<String, ScheduleJob> jobMap = new HashMap<String, ScheduleJob>();

static {
  for (int i = 0; i < 5; i++) {
    ScheduleJob job = new ScheduleJob();
    job.setJobId("10001" + i);
    job.setJobName("data_import" + i);
    job.setJobGroup("dataWork");
    job.setJobStatus("1");
    job.setCronExpression("0/5 * * * * ?");
    job.setDesc("數(shù)據(jù)導(dǎo)入任務(wù)");
    addJob(job);
  }
}

/**
 * 添加任務(wù)
 * @param scheduleJob
 */
public static void addJob(ScheduleJob scheduleJob) {
  jobMap.put(scheduleJob.getJobGroup() + "_" + scheduleJob.getJobName(), scheduleJob);
}

有了調(diào)度工廠，有了任務(wù)運行入口實現(xiàn)類，有了任務(wù)信息，接下來就是創(chuàng)建我們的定時任務(wù)了，在這里我把它設(shè)計成一個Job對應(yīng)一個trigger，兩者的分組及名稱相同，方便管理，條理也比較清晰，在創(chuàng)建任務(wù)時如果不存在新建一個，如果已經(jīng)存在則更新任務(wù)，主要代碼如下：

//schedulerFactoryBean 由spring創(chuàng)建注入
Scheduler scheduler = schedulerFactoryBean.getScheduler();

//這里獲取任務(wù)信息數(shù)據(jù)
List<ScheduleJob> jobList = DataWorkContext.getAllJob();

for (ScheduleJob job : jobList) {

  TriggerKey triggerKey = TriggerKey.triggerKey(job.getJobName(), job.getJobGroup());

  //獲取trigger，即在spring配置文件中定義的 bean id="myTrigger"
  CronTrigger trigger = (CronTrigger) scheduler.getTrigger(triggerKey);

  //不存在，創(chuàng)建一個
  if (null == trigger) {
    JobDetail jobDetail = JobBuilder.newJob(QuartzJobFactory.class)
      .withIdentity(job.getJobName(), job.getJobGroup()).build();
    jobDetail.getJobDataMap().put("scheduleJob", job);

    //表達(dá)式調(diào)度構(gòu)建器
    CronScheduleBuilder scheduleBuilder = CronScheduleBuilder.cronSchedule(job
      .getCronExpression());

    //按新的cronExpression表達(dá)式構(gòu)建一個新的trigger
    trigger = TriggerBuilder.newTrigger().withIdentity(job.getJobName(), job.getJobGroup()).withSchedule(scheduleBuilder).build();

    scheduler.scheduleJob(jobDetail, trigger);
  } else {
    // Trigger已存在，那么更新相應(yīng)的定時設(shè)置
    //表達(dá)式調(diào)度構(gòu)建器
    CronScheduleBuilder scheduleBuilder = CronScheduleBuilder.cronSchedule(job
      .getCronExpression());

    //按新的cronExpression表達(dá)式重新構(gòu)建trigger
    trigger = trigger.getTriggerBuilder().withIdentity(triggerKey)
      .withSchedule(scheduleBuilder).build();

    //按新的trigger重新設(shè)置job執(zhí)行
    scheduler.rescheduleJob(triggerKey, trigger);
  }
}

如此，可以說已經(jīng)完成了我們的動態(tài)任務(wù)創(chuàng)建，大功告成了。有了上面的代碼，添加和修改任務(wù)是不是也會了，順道解決了？

上面我們創(chuàng)建的5個測試任務(wù)，都是5秒執(zhí)行一次，都將調(diào)用QuartzJobFactory的execute方法，但是傳入的任務(wù)信息參數(shù)不同，execute方法中的如下代碼就是得到具體的任務(wù)信息，包括任務(wù)分組和任務(wù)名：

復(fù)制代碼代碼如下:

ScheduleJob scheduleJob = (ScheduleJob)context.getMergedJobDataMap().get(“scheduleJob”); 

有了任務(wù)分組和任務(wù)名即確定了該任務(wù)的唯一性，接下來需要什么操作實現(xiàn)起來是不是就很容易了？

以后需要添加新的定時任務(wù)只需要在任務(wù)信息列表中加入記錄即可，然后在execute方法中通過判斷任務(wù)分組和任務(wù)名來實現(xiàn)你具體的操作。

以上已經(jīng)初始實現(xiàn)了我們需要的功能，增加和修改也已經(jīng)可以通過源代碼舉一反三出來，但是我們在實際開發(fā)的時候需要進(jìn)行測試，如果一個任務(wù)是1個小時運行一次的，測試起來是不是很不方便？當(dāng)然你可以修改任務(wù)的運行時間表達(dá)式，但相信這不是最好的方法，接下來我們就要實現(xiàn)在不對當(dāng)前任務(wù)信息做任何修改的情況下觸發(fā)任務(wù)，并且該觸發(fā)只會運行一次作測試用。

動態(tài)暫停恢復(fù) 修改和刪除任務(wù)

前面我們已經(jīng)完成了spring 3和quartz 2的整合以及動態(tài)添加定時任務(wù)，我們接著來完善它，使之能支持更多的操作，例如暫停、恢復(fù)、修改等。

在動態(tài)添加定時任務(wù)中其實已經(jīng)涉及到了其中的一些代碼，這里我們再來細(xì)化的理一理。先來看一下我們初步要實現(xiàn)的目標(biāo)效果圖，這里我們只在內(nèi)存中操作，并沒有把quartz的任何信息保存到數(shù)據(jù)庫，即使用的是RAMJobStore，當(dāng)然如果你有需要，可以實現(xiàn)成JDBCJobStore，那樣任務(wù)信息將會更全面。

trigger各狀態(tài)說明：

None：Trigger已經(jīng)完成，且不會在執(zhí)行，或者找不到該觸發(fā)器，或者Trigger已經(jīng)被刪除
NORMAL:正常狀態(tài)
PAUSED：暫停狀態(tài)
COMPLETE：觸發(fā)器完成，但是任務(wù)可能還正在執(zhí)行中
BLOCKED：線程阻塞狀態(tài)
ERROR：出現(xiàn)錯誤

計劃中的任務(wù)

指那些已經(jīng)添加到quartz調(diào)度器的任務(wù)，因為quartz并沒有直接提供這樣的查詢接口，所以我們需要結(jié)合JobKey和Trigger來實現(xiàn)，核心代碼：

Scheduler scheduler = schedulerFactoryBean.getScheduler();
GroupMatcher<JobKey> matcher = GroupMatcher.anyJobGroup();
Set<JobKey> jobKeys = scheduler.getJobKeys(matcher);
List<ScheduleJob> jobList = new ArrayList<ScheduleJob>();
for (JobKey jobKey : jobKeys) {
  List<? extends Trigger> triggers = scheduler.getTriggersOfJob(jobKey);
  for (Trigger trigger : triggers) {
    ScheduleJob job = new ScheduleJob();
    job.setJobName(jobKey.getName());
    job.setJobGroup(jobKey.getGroup());
    job.setDesc("觸發(fā)器:" + trigger.getKey());
    Trigger.TriggerState triggerState = scheduler.getTriggerState(trigger.getKey());
    job.setJobStatus(triggerState.name());
    if (trigger instanceof CronTrigger) {
      CronTrigger cronTrigger = (CronTrigger) trigger;
      String cronExpression = cronTrigger.getCronExpression();
      job.setCronExpression(cronExpression);
    }
    jobList.add(job);
  }
}

上面代碼中的jobList就是我們需要的計劃中的任務(wù)列表，需要注意一個job可能會有多個trigger的情況，在下面講到的立即運行一次任務(wù)的時候，會生成一個臨時的trigger也會出現(xiàn)在這。這里把一個Job有多個trigger的情況看成是多個任務(wù)。我們前面包括在實際項目中一般用到的都是CronTrigger ，所以這里我們著重處理了下CronTrigger的情況。

運行中的任務(wù)

實現(xiàn)和計劃中的任務(wù)類似，核心代碼：

Scheduler scheduler = schedulerFactoryBean.getScheduler();
List<JobExecutionContext> executingJobs = scheduler.getCurrentlyExecutingJobs();
List<ScheduleJob> jobList = new ArrayList<ScheduleJob>(executingJobs.size());
for (JobExecutionContext executingJob : executingJobs) {
  ScheduleJob job = new ScheduleJob();
  JobDetail jobDetail = executingJob.getJobDetail();
  JobKey jobKey = jobDetail.getKey();
  Trigger trigger = executingJob.getTrigger();
  job.setJobName(jobKey.getName());
  job.setJobGroup(jobKey.getGroup());
  job.setDesc("觸發(fā)器:" + trigger.getKey());
  Trigger.TriggerState triggerState = scheduler.getTriggerState(trigger.getKey());
  job.setJobStatus(triggerState.name());
  if (trigger instanceof CronTrigger) {
    CronTrigger cronTrigger = (CronTrigger) trigger;
    String cronExpression = cronTrigger.getCronExpression();
    job.setCronExpression(cronExpression);
  }
  jobList.add(job);
}

暫停任務(wù)

這個比較簡單，核心代碼：

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

恢復(fù)任務(wù)

和暫停任務(wù)相對，核心代碼：

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

刪除任務(wù)

刪除任務(wù)后，所對應(yīng)的trigger也將被刪除

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

立即運行任務(wù)

這里的立即運行，只會運行一次，方便測試時用。quartz是通過臨時生成一個trigger的方式來實現(xiàn)的，這個trigger將在本次任務(wù)運行完成之后自動刪除。trigger的key是隨機(jī)生成的，例如：DEFAULT.MT_4k9fd10jcn9mg。在我的測試中，前面的DEFAULT.MT是固定的，后面部分才隨機(jī)生成。

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

更新任務(wù)的時間表達(dá)式

更新之后，任務(wù)將立即按新的時間表達(dá)式執(zhí)行：

Scheduler scheduler = schedulerFactoryBean.getScheduler();

TriggerKey triggerKey = TriggerKey.triggerKey(scheduleJob.getJobName(),
  scheduleJob.getJobGroup());

//獲取trigger，即在spring配置文件中定義的 bean id="myTrigger"
CronTrigger trigger = (CronTrigger) scheduler.getTrigger(triggerKey);

//表達(dá)式調(diào)度構(gòu)建器
CronScheduleBuilder scheduleBuilder = CronScheduleBuilder.cronSchedule(scheduleJob
  .getCronExpression());

//按新的cronExpression表達(dá)式重新構(gòu)建trigger
trigger = trigger.getTriggerBuilder().withIdentity(triggerKey)
  .withSchedule(scheduleBuilder).build();

//按新的trigger重新設(shè)置job執(zhí)行
scheduler.rescheduleJob(triggerKey, trigger);

以上就是本文的全部內(nèi)容，希望對大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

您可能感興趣的文章: