【任务调度】：Quartz也有“春天”

　　之前，简单地浏览过Quartz的API（http://www.quartz-scheduler.org/documentation/quartz-2.2.x/quick-start.html），它告诉我们如何配置和使用Quartz。但是，在实际开发中我们的项目大多使用了Spring。那么这二者能否很好的结合呢？实际上，Spring框架已经对Quartz提供了很好的支持。这篇文章，我们将以实际的Demo来总结如何在Spring的上下文中使用Quartz。

回顾

Quartz中的几个重要概念

Scheduler

用于与调度程序交互的主程序接口。（也就是得通过它把调度程序启动起来）

Job

让scheduler执行的任务的接口。

JobDetail

具体任务实现。

Trigger

定义任务什么时候，什么条件执行。

Spring框架中的包

　　在maven的中央仓库https://mvnrepository.com/search?q=org.springframework&p=1中，搜“org.springframework”,可以搜到1538个结果，这么多，没有必要都了解，less is more。这里我们只需清楚几个重要的，以及spring结合quartz时需要的包就可以了。

spring-core

spring框架的核心工具类。必须引入。

spring-bean

与在配置文件中配置bean，创建初始化bean都有关，即与IoC相关。

spring-context

为spring核心提供了大量的扩展，（“是spring-core的升华”？，O(∩_∩)O哈哈！），所以项目中也要引入。

spring-context-support（之前叫spring-support）

这个jar文件包含支持缓存Cache，邮件，任务计划Scheduling（Timer、Quartz）等方面的类。

实战一下

demo环境

IDE：IntelliJ IDEA 2016

JDK：1.8.0_102

Spring：4.1.5.RELEASE

demo步骤

New Project

Add dependencies in pom.xml

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> <modelVersion>4.0.0</modelVersion>
<groupId>com.xcy</groupId>
<artifactId>quartz</artifactId>
<packaging>war</packaging>
<version>1.0-SNAPSHOT</version>
<name>quartz Maven Webapp</name>
<url>http://maven.apache.org</url>
<dependencies>
<!-- spring -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-core</artifactId>
<version>4.1.5.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-beans</artifactId>
<version>4.1.5.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>4.1.5.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context-support</artifactId>
<version>4.1.5.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-tx</artifactId>
<version>4.1.5.RELEASE</version>
</dependency>

<!-- https://mvnrepository.com/artifact/org.quartz-scheduler/quartz -->
<dependency>
<groupId>org.quartz-scheduler</groupId>
<artifactId>quartz</artifactId>
<version>2.2.1</version>
</dependency>

<!--slf4j-->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>1.7.13</version>
</dependency>

<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<finalName>quartz</finalName>
</build>
</project>

备注：spring-tx也得引入，否则会报错，后面会提到。

JobDetail & Trigger

使用MethodInvokingJobDetailFactoryBean配置JobDetail

<bean id="jobDetail" class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">
<property name="targetObject" ref="exampleBusinessObject" />
<property name="targetMethod" value="doIt" />
<!--<property name="concurrent" value="false" />-->
</bean>
<bean id="exampleBusinessObject" class="com.xcy.service.ExampleBusinessObject"/>

public class ExampleBusinessObject {
// properties and collaborators
public void doIt() {
// do the actual work
System.out.print("do actual work");
}
}

使用SimpleTriggerFactoryBean配置Trigger，对于复杂的如某年某月某日执行，可使用CronTriggerFactoryBean。

<bean id="simpleTrigger" class="org.springframework.scheduling.quartz.SimpleTriggerFactoryBean">
<!-- see the example of method invoking job above -->
<property name="jobDetail" ref="jobDetail" />
<!-- 10 seconds -->
<property name="startDelay" value="10000" />
<!-- repeat every 50 seconds -->
<property name="repeatInterval" value="50000" />
</bean>

使用SchedulerFactoryBean充当Scheduler

<bean class="org.springframework.scheduling.quartz.SchedulerFactoryBean" lazy-init="false" autowire="no">
<property name="triggers">
<list>
<ref bean="simpleTrigger" />
</list>
</property>
</bean>

测试

public class ExampleBusinessTestCase {

protected static ApplicationContext applicationContext;

public static void main(String[] args){
applicationContext = new ClassPathXmlApplicationContext("spring/applicationContext.xml");
}

}

在控制台打印出do actual work

总结

Spring中的与Quartz相关的几个类。

MethodInvokingJobDetailFactoryBean

这个类的targetObject，targetMethod两个属性描述了JobDetail，即任务执行时，是调用哪个目标对象的哪个方法。

SimpleTriggerFactoryBean Or CronTriggerFactoryBean

这个类定义了任务执行的条件，前一种适用于多少时间之后（delay），每隔多长时间执行一次（rate）的任务，后一种适用于在每周的某个时间，或者未来的某个日期会执行的任务

SchedulerFactoryBean

通过triggers属性关联Trigger，用来启动它们。

参考文档：http://docs.spring.io/spring/docs/3.2.x/spring-framework-reference/html/scheduling.html#scheduling-quartz

遇到的问题

没有配置spring-tx包，产生异常

Caused by: org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'org.springframework.scheduling.quartz.SchedulerFactoryBean#0' defined in class path resource [spring/applicationContext.xml]: Instantiation of bean failed; nested exception is java.lang.NoClassDefFoundError: org/springframework/transaction/TransactionException

可能的问题：

当项目中存在datasource的配置时，需要屏蔽掉SchedulerFactoryBean的自动装配。具体原因大概是因为SchedulerFactoryBean有个datasource属性，如果按默认自动装配的话，装配项目中的datasource，此时quartz就会去数据库中找任务，但是没有数据库中无对应的表，导致SchedulerFactoryBean初始化失败。所以在实际项目中一定要给SchedulerFactoryBean配置上autowire=”false”属性。