Quartz调度框架快速入门

1.永远的HelloWorld

准备工作( Maven导入Jar包)

<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/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion>
<groupId>cn.zzu.wcj.quartz</groupId>
<artifactId>QuartzProject</artifactId>
<version>0.0.1-SNAPSHOT</version>
<!-- 对版本进行管理 -->
<properties>
<quartz.version>2.2.1</quartz.version>
<junit.version>4.12</junit.version>
<slf4j.version>1.7.12</slf4j.version>
</properties>

<dependencies>
<!-- 2.2.X的Quartz引入支持包更少 -->
<dependency>
<groupId>org.quartz-scheduler</groupId>
<artifactId>quartz</artifactId>
<version>${quartz.version}</version>
</dependency>
<dependency>
<groupId>org.quartz-scheduler</groupId>
<artifactId>quartz-jobs</artifactId>
<version>${quartz.version}</version>
</dependency>

<!-- JUnit测试包 -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>${junit.version}</version>
</dependency>

<!-- 日志管理包 -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>${slf4j.version}</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
<version>${slf4j.version}</version>
</dependency>

</dependencies>

</project>

编写DEMO

核心概念

Quartz核心的概念：scheduler任务调度、Job任务、Trigger触发器、JobDetail任务细节

Job任务：其实Job是接口，其中只有一个execute方法：

package org.quartz;

public abstract interface Job{

public abstract void execute(JobExecutionContext paramJobExecutionContext)

throws JobExecutionException;

}

我们开发者只要实现此接口，实现execute方法即可。把我们想做的事情，在execute中执行即可。

JobDetail：任务细节，Quartz执行Job时，需要新建个Job实例，但是不能直接操作Job类，所以通过JobDetail来获取Job的名称、描述信息。

Trigger触发器：执行任务的规则；比如每天，每小时等。

一般情况使用SimpleTrigger，和CronTrigger，这个触发器实现了Trigger接口。

对于复杂的时间表达式来说，比如每个月15日上午几点几分，使用CronTrigger。

对于简单的时间来说，比如每天执行几次，使用SimpleTrigger。

scheduler任务调度：是最核心的概念，需要把JobDetail和Trigger注册到scheduler中，才可以执行。

package cn.zzu.wcj.quartz.job;

import java.util.Date;

import org.quartz.Job;
import org.quartz.JobExecutionContext;
import org.quartz.JobExecutionException;

/**
*
* @author WangCengJian
* @Time 2016/12/09
* @Desc:需要执行的任务
*/
public class MyJob implements Job {

//在execute()方法中编写需要执行的任务
@Override
public void execute(JobExecutionContext context)
throws JobExecutionException {
System.out.println("正在进行任务调度.......["+new Date()+"]");
}

}

package cn.zzu.wcj.quartz.test;

import java.util.Date;

import org.junit.Test;
import org.quartz.Scheduler;
import org.quartz.SchedulerFactory;
import org.quartz.impl.JobDetailImpl;
import org.quartz.impl.StdSchedulerFactory;
import org.quartz.impl.triggers.SimpleTriggerImpl;

import cn.zzu.wcj.quartz.job.MyJob;

public class TriggerTest {

/**
* 一般情况使用SimpleTrigger或CronTrigger，这两个触发器实现了Trigger接口。
*   1)对于复杂的时间表达式来说,比如每个月15日上午几点几分,使用CronTrigger
* 2)对于简单的时间来说,比如每天执行几次,使用SimpleTrigger
* @throws Exception
*
*/

@Test
public void testSimpleTrigger() throws Exception {
SchedulerFactory schedulerFactory=new StdSchedulerFactory()  ;      //创建调度器工厂
Scheduler scheduler = schedulerFactory.getScheduler();      //通过SchedulerFactory获取一个调度器
//创建JobDetail,绑定任务,指明Job的名称和所在组
JobDetailImpl jobDetail=new JobDetailImpl()  ;
jobDetail.setName("MyJob") ;
jobDetail.setGroup("MyJobGroup") ;
jobDetail.setJobClass(MyJob.class)  ;

//定义调度触发规则,例如:每秒运行一次,总共执行8次
SimpleTriggerImpl trigger= new SimpleTriggerImpl()  ;
trigger.setName("MyTrigger")   ;
trigger.setGroup("MyTriggerGroup") ;
trigger.setStartTime(new Date()) ;   //设置任务开始时间为当前
trigger.setRepeatInterval(1000) ;   //每隔一秒执行一次
trigger.setRepeatCount(8) ;    //重复执行八次

//将任务和触发器绑定到调度器
scheduler.scheduleJob(jobDetail, trigger)  ;

scheduler.start();   //调度开始

Thread.sleep(1000*60);

}

}

注意:一定要使用线程休眠,不然你看不到测试结果;Quartz2.2.X创建实例的方法有所不同,但熟悉接口很简单

程序运行结果 :



再次”问候”Quartz他大爷:使用CornTrigger触发器完成更为复杂的定时任务,同时改良之前的JUnit单元测试

Cron表达式时间字段

Cron表达式的时间字段除允许设置数值外，还可使用一些特殊的字符，提供列表、范围、通配符等功能。

秒 0-59 , - * /

分 0-59 , - * /

小时 0-23 , - * /

日 1-31 , - * ? / L W C

月 1-12 or JAN-DEC , - * /

周几 1-7 or SUN-SAT , - * ? / L C #

年 (可选字段) empty, 1970-2099 , - * /

●星号()：可用在所有字段中，表示对应时间域的每一个时刻，例如，在分钟字段时，表示“每分钟”；

●问号（?）：该字符只在日期和星期字段中使用，它通常指定为“无意义的值”，相当于点位符；

●减号(-)：表达一个范围，如在小时字段中使用“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表达式对特殊字符的大小写不敏感，对代表星期的缩写英文大小写也不敏感。

其中每个元素可以是一个值(如6),一个连续区间(9-12),一个间隔时间(8-18/4)(/表示每隔4小时),一个列表(1,3,5),通配符。由于”月份中的日期”和”星期中的日期”这两个元素互斥的,必须要对其中一个设置?.

0 0 10,14,16 * * ? 每天上午10点，下午2点，4点

0 0/30 9-17 * * ? 朝九晚五工作时间内每半小时

0 0 12 ? * WED 表示每个星期三中午12点

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

“0 5 2 1 8 ? *” 每年的8月1号2:5触发

有些子表达式能包含一些范围或列表

例如：子表达式（天（星期））可以为 “MON-FRI”，“MON，WED，FRI”，“MON-WED,SAT”

“*”字符代表所有可能的值

因此，“”在子表达式（月）里表示每个月的含义，“”在子表达式（天（星期））表示星期的每一天

“/”字符用来指定数值的增量

例如：在子表达式（分钟）里的“0/15”表示从第0分钟开始，每15分钟

在子表达式（分钟）里的“3/20”表示从第3分钟开始，每20分钟（它和“3，23，43”）的含义一样

“？”字符仅被用于天（月）和天（星期）两个子表达式，表示不指定值

当2个子表达式其中之一被指定了值以后，为了避免冲突，需要将另一个子表达式的值设为“？”

“L” 字符仅被用于天（月）和天（星期）两个子表达式，它是单词“last”的缩写

但是它在两个子表达式里的含义是不同的。

在天（月）子表达式中，“L”表示一个月的最后一天

在天（星期）自表达式中，“L”表示一个星期的最后一天，也就是SAT

如果在“L”前有具体的内容，它就具有其他的含义了

例如：“6L”表示这个月的倒数第６天，“ＦＲＩＬ”表示这个月的最一个星期五

注意：在使用“L”参数时，不要指定列表或范围，因为这会导致问题

package cn.zzu.wcj.quartz.test;

import java.util.Date;

import org.junit.Before;
import org.junit.Test;
import org.quartz.CronScheduleBuilder;
import org.quartz.Scheduler;
import org.quartz.SchedulerFactory;
import org.quartz.Trigger;
import org.quartz.TriggerBuilder;
import org.quartz.impl.JobDetailImpl;
import org.quartz.impl.StdSchedulerFactory;
import org.quartz.impl.triggers.SimpleTriggerImpl;

import cn.zzu.wcj.quartz.job.MyJob;

public class TriggerTest {

/**
* 一般情况使用SimpleTrigger或CronTrigger，这两个触发器实现了Trigger接口。
*   1)对于复杂的时间表达式来说,比如每个月15日上午几点几分,使用CronTrigger
* 2)对于简单的时间来说,比如每天执行几次,使用SimpleTrigger
* @throws Exception
*
*/

private SchedulerFactory schedulerFactory=null ;   //调度器工厂
private Scheduler scheduler=null   ;   //调度器
private  JobDetailImpl jobDetail=null ;   //任务

@Before
public void init() throws Exception{
this.schedulerFactory=new StdSchedulerFactory()  ;      //创建调度器工厂
this. scheduler = schedulerFactory.getScheduler();      //通过SchedulerFactory获取一个调度器
//创建JobDetail,绑定任务,指明Job的名称和所在组
this. jobDetail=new JobDetailImpl()  ;
this.jobDetail.setName("MyJob") ;
this.jobDetail.setGroup("MyJobGroup") ;
this. jobDetail.setJobClass(MyJob.class)  ;
}

@Test
public void testSimpleTrigger() throws Exception {

//定义调度触发规则,例如:每秒运行一次,总共执行8次
SimpleTriggerImpl trigger= new SimpleTriggerImpl()  ;
trigger.setName("MyTrigger")   ;
trigger.setGroup("MyTriggerGroup") ;
trigger.setStartTime(new Date()) ;   //设置任务开始时间为当前
trigger.setRepeatInterval(1000) ;   //每隔一秒执行一次
trigger.setRepeatCount(8) ;    //重复执行八次

//将任务和触发器绑定到调度器
this.scheduler.scheduleJob( this.jobDetail, trigger)  ;

this.scheduler.start();   //调度开始

Thread.sleep(1000*60);

}

@Test
public void testCornTrigger()throws Exception{
//其实SimpleTrigger也可以通过这种方式创建
Trigger trigger=TriggerBuilder.newTrigger()
.withIdentity("CornTrigger", "CornTriggerGroup")
.withSchedule(CronScheduleBuilder.cronSchedule("0 50 10 * * ? *"))
.startNow()
.build()   ;
//将任务和触发器绑定到调度器
this.scheduler.scheduleJob( this.jobDetail, trigger)  ;

this.scheduler.start();   //调度开始

Thread.sleep(1000*60);
}

}

程序运行截图 :



问候Quartz的兄弟(Spring整合Quartz)

准备工作 : Maven导入Spring支持

<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/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion>
<groupId>cn.zzu.wcj.quartz</groupId>
<artifactId>QuartzProject</artifactId>
<version>0.0.1-SNAPSHOT</version>
<!-- 对版本进行管理 -->
<properties>
<quartz.version>2.2.1</quartz.version>
<junit.version>4.12</junit.version>
<slf4j.version>1.7.12</slf4j.version>
<spring.version>4.1.6.RELEASE</spring.version>
</properties>

<dependencies>
<!-- Spring框架 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-test</artifactId>
<version>${spring.version}</version>
</dependency>
<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-context-support</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-tx</artifactId>
<version>${spring.version}</version>
</dependency>

<!-- 2.2.X的Quartz引入支持包更少 -->
<dependency>
<groupId>org.quartz-scheduler</groupId>
<artifactId>quartz</artifactId>
<version>${quartz.version}</version>
</dependency>
<dependency>
<groupId>org.quartz-scheduler</groupId>
<artifactId>quartz-jobs</artifactId>
<version>${quartz.version}</version>
</dependency>

<!-- JUnit测试包 -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>${junit.version}</version>
</dependency>

<!-- 日志管理包 -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>${slf4j.version}</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
<version>${slf4j.version}</version>
</dependency>

</dependencies>

</project>

1)配置方式一 : 如果实现Job接口

MyJob.java

package cn.zzu.wcj.quartz.job;

import java.util.Date;

import org.quartz.Job;
import org.quartz.JobExecutionContext;
import org.quartz.JobExecutionException;

/**
*
* @author WangCengJian
* @Time 2016/12/09
* @Desc:需要执行的任务
*/
public class MyJob implements Job {

//在execute()方法中编写需要执行的任务
@Override
public void execute(JobExecutionContext context)
throws JobExecutionException {
System.out.println("正在进行任务调度.......["+new Date()+"]");
}
}

applicationContext-quartz.xml

<?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.xsd"> 
<!-- 配置任务 -->
<bean id="jobDetail" class="org.springframework.scheduling.quartz.JobDetailFactoryBean">
<!-- 配置任务Class -->
<property name="jobClass" value="cn.zzu.wcj.quartz.job.MyJob"></property>
</bean>

<!-- 配置触发器 -->
<bean id="trigger" class="org.springframework.scheduling.quartz.CronTriggerFactoryBean">
<!-- 配置任务 -->
<property name="jobDetail" ref="jobDetail"></property>
<!--配置调度时间  -->
<property name="cronExpression" value="0 32 12 * * ? *"></property>
</bean>

<!-- 配置调度器 -->
<bean id="schedulerFactory" class="org.springframework.scheduling.quartz.SchedulerFactoryBean">
<property name="triggers">
<ref bean="trigger"/>
</property>
</bean>

</beans>

单元测试代码

package cn.zzu.wcj.quartz.test;

import org.junit.Before;
import org.junit.Test;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;

public class SpringQuartzTest {

private ApplicationContext ctx=null ;

@Before
public void init(){
this.ctx=new ClassPathXmlApplicationContext("classpath:applicationContext-quartz.xml")  ;
}

@Test
public void test() throws Exception {
System.out.println(ctx);
Thread.sleep(1000*60);
}

}

程序运行截图 :



2)方式二 : 如果自定义Job(耦合度低)

ZZUJob.java

package cn.zzu.wcj.quartz.job;

import java.util.Date;

/**
*
* @author SoftwareCollege Of ZhengZhou University -ChengJian·Wang
* @Desc  这个任务没有实现Job接口,耦合度很低,Spring整合Quartz时需要使用特殊配置
*
*
*/
public class ZZUJob {

public void clear(){
System.out.println("定时清理任务正在执行................["+new Date()+"]");
}

}

applicationContext-quartz-2.xml

<?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.xsd"> 
<!-- 配置任务 -->
<bean id="ZZUJob" class="cn.zzu.wcj.quartz.job.ZZUJob"></bean>
<bean id="jobDetail" class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">
<!-- 调用目标任务 -->
<property name="targetObject" ref="ZZUJob"></property>
<!-- 调用目标方法 -->
<property name="targetMethod"  value="clear"></property>
</bean>

<!-- 配置触发器 -->
<bean id="trigger" class="org.springframework.scheduling.quartz.CronTriggerFactoryBean">
<!-- 配置任务细节 -->
<property name="jobDetail" ref="jobDetail"></property>
<!-- 配置调度时间表达式 -->
<property name="cronExpression" value="0/1 * * * * ? *"></property>
</bean>

<!-- 配置调度器 -->
<bean id="schedulerFactory" class="org.springframework.scheduling.quartz.SchedulerFactoryBean">
<property name="triggers">
<list>
<ref bean="trigger"/>
</list>
</property>
</bean>

</beans>

单元测试

package cn.zzu.wcj.quartz.test;

import org.junit.Before;
import org.junit.Test;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;

public class SpringQuartzTest {

private ApplicationContext ctx=null ;

@Before
public void init(){
this.ctx=new ClassPathXmlApplicationContext("classpath:applicationContext-quartz-2.xml")  ;
}

@Test
public void test() throws Exception {
System.out.println(ctx);
Thread.sleep(1000*20);
}

}

程序运行截图 :



总结:①.Quartz的时间表达式有7个参数(包含星期),按照上面API来组合表达式;②.Spring整合Quartz有两种方式,分别对应两种调度任务,区别在于任务类是否实现Job接口 ; ③我没有演示多任务调度,其实项目中如果出现,只要我们在applicationContext-quartz.xml文件中多写几个{jobDetail,trigger}组合即可,同时调度器属性triggers支持多任务啊！