Quartz定时配置

àì夳堔傛蜴生んèń 2022-06-06 13:47 139阅读 0赞

# 1 **什么是Quartz** #

Quartz是OpenSymphony开源组织在Job scheduling领域的开源项目,它可以与J2EE与J2SE应用程序相结合也可以单独使用。Quartz可以用来创建简单或为运行十个，百个，甚至是好几万个Jobs这样复杂的日程序表。Jobs可以做成标准的Java组件或EJBs。

Quartz是一个任务日程管理系统，一个在预先确定（被纳入日程）的时间到达时，负责执行（或者通知）其他软件组件的系统。

Quartz用一个小Java库发布文件（.jar文件），这个库文件包含了所有Quartz核心功能。这些功能的主要接口(API)是Scheduler接口。它提供了简单的操作，例如：将任务纳入日程或者从日程中取消，开始/停止/暂停日程进度。

# 2 **Quartz的下载及安装** #

## 2.1 **下载** ##

官方网站：[http://quartz-scheduler.org/][http_quartz-scheduler.org]

可以从官方网站下载quartz的最新版本。

## 2.2 **Maven依赖** ##

一般使用Quartz是和spring框架整合使用的，所以加入以下依赖：

<table> 
 <tbody> 
 <tr> 
 <td> &lt;dependency&gt; &lt;groupId&gt;org.quartz-scheduler&lt;/groupId&gt; &lt;artifactId&gt;quartz&lt;/artifactId&gt; &lt;version&gt;2.2.2&lt;/version&gt; &lt;/dependency&gt; &lt;dependency&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;groupId&gt;org.springframework&lt;/groupId&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;artifactId&gt;spring-context-support&lt;/artifactId&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;version&gt;4.1.3.RELEASE&lt;/version&gt; &lt;/dependency&gt; </td> 
 </tr> 
 </tbody> 
</table>

# 3 **Quartz框架架构** #

## 3.1 **Quartz框架的核心对象** ##

lScheduler – 核心调度器

lJob – 任务

lJobDetail – 任务描述

lTrigger  -- 触发器

## 3.2 **对象之间的关系** ##

![Center][]

![Center 1][]

# 4  #

# 1 **使用方法** #

## 1.1 **第一步：创建Job类** ##

创建一个java类，创建一个普通方法，作为任务处理方法。

## 1.2 **第二步：配置Job到spring容器** ##

<table> 
 <tbody> 
 <tr> 
 <td> &lt;bean id="schedule1" class="com.taotao.order.schedule.Schedule1"&gt;&lt;/bean&gt; </td> 
 </tr> 
 </tbody> 
</table>

## 1.3 **第三步：将Job类配置JobDetail** ##

<table> 
 <tbody> 
 <tr> 
 <td> &lt;bean&nbsp;id="SpringQtzJobMethod" class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean"&gt; &lt;property&nbsp;name="targetObject"&gt; &lt;ref&nbsp;bean="schedule1"&nbsp;/&gt; &lt;/property&gt; &lt;property&nbsp;name="targetMethod"&gt;&nbsp;&nbsp;&lt;!-- 要执行的方法名称 --&gt; &lt;value&gt;execute&lt;/value&gt; &lt;/property&gt; &lt;/bean&gt; </td> 
 </tr> 
 </tbody> 
</table>

## 1.4 **第四步：配置调度触发器** ##

<table> 
 <tbody> 
 <tr> 
 <td> &lt;bean&nbsp;id="cronTriggerFactoryBean"&nbsp;class="org.springframework.scheduling.quartz.CronTriggerFactoryBean "&gt; &lt;property&nbsp;name="jobDetail"&nbsp;ref="SpringQtzJobMethod"&gt;&lt;/property&gt; &lt;property&nbsp;name="cronExpression"&nbsp;value="0/5 * * * * ?"&gt;&lt;/property&gt; &lt;/bean&gt; </td> 
 </tr> 
 </tbody> 
</table>

## 1.5 **第五步：配置调度工厂** ##

<table> 
 <tbody> 
 <tr> 
 <td> &lt;bean&nbsp;id="SpringJobSchedulerFactoryBean" class="org.springframework.scheduling.quartz.SchedulerFactoryBean"&gt; &lt;property&nbsp;name="triggers"&gt; &lt;list&gt; &lt;ref&nbsp;bean="cronTriggerFactoryBean"&nbsp;/&gt; &lt;/list&gt; &lt;/property&gt; &lt;/bean&gt; </td> 
 </tr> 
 </tbody> 
</table>

# 2 **Cron 表达式** #

cron的表达式被用来配置CronTrigger实例。 cron的表达式是字符串，实际上是由七子表达式，描述个别细节的时间表。这些子表达式是分开的空白，代表：

1. **       Seconds**

2. **       Minutes**

3. **        Hours**

4. **        Day-of-Month**

5. **        Month**

6. **       Day-of-Week**

7. **       Year (可选字段)**

例  "0 0 12 ? \* WED"  在每星期三下午12:00 执行,

个别子表达式可以包含范围,  例如，在前面的例子里("WED")可以替换成 "MON-FRI", "MON, WED, FRI"甚至"MON-WED,SAT".

“\*” 代表整个时间段.

每一个字段都有一套可以指定有效值，如

**Seconds** (秒)         ：可以用数字0－59 表示，

**Minutes(**分)           ：可以用数字0－59 表示，

**Hours(**时)              ：可以用数字0-23表示,

**Day-of-Month(**天)  ：可以用数字1-31 中的任一一个值，但要注意一些特别的月份

**Month(**月)             ：可以用0-11 或用字符串  “JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV and DEC” 表示

**Day-of-Week(每周)：**可以用数字1-7表示（1 ＝ 星期日）或用字符口串“SUN, MON, TUE, WED, THU, FRI and SAT”表示

“/”：为特别单位，表示为“每”如“0/15”表示每隔15分钟执行一次,“0”表示为从“0”分开始, “3/20”表示表示每隔20分钟执行一次，“3”表示从第3分钟开始执行

“?”：表示每月的某一天，或第周的某一天

“L”：用于每月，或每周，表示为每月的最后一天，或每个月的最后星期几如“6L”表示“每月的最后一个星期五”

“W”：表示为最近工作日，如“15W”放在每月（day-of-month）字段上表示为“到本月15日最近的工作日”

““\#”：是用来指定“的”每月第n个工作日,例 在每周（day-of-week）这个字段中内容为"6\#3" or "FRI\#3" 则表示“每月第三个星期五”

1）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      , - \* /

“?”字符：表示不确定的值

“,”字符：指定数个值

“-”字符：指定一个值的范围

“/”字符：指定一个值的增加幅度。n/m表示从n开始，每次增加m

“L”字符：用在日表示一个月中的最后一天，用在周表示该月最后一个星期X

“W”字符：指定离给定日期最近的工作日(周一到周五)

“\#”字符：表示该月第几个周X。6\#3表示该月第3个周五

2）Cron表达式范例：

每隔5秒执行一次：\*/5 \* \* \* \* ?

每隔1分钟执行一次：0 \*/1 \* \* \* ?

每天23点执行一次：0 0 23 \* \* ?

每天凌晨1点执行一次：0 0 1 \* \* ?

每月1号凌晨1点执行一次：0 0 1 1 \* ?

每月最后一天23点执行一次：0 0 23 L \* ?

每周星期天凌晨1点实行一次：0 0 1 ? \* L

在26分、29分、33分执行一次：0 26,29,33 \* \* \* ?

每天的0点、13点、18点、21点都执行一次：0 0 0,13,18,21 \* \* ?

[http_quartz-scheduler.org]: http://quartz-scheduler.org/
[Center]: /images/20220606/82bf433083fa422ba3e4cef5346746f8.png
[Center 1]: /images/20220606/fb0b4a68e2894fcdb67ea9c2e7b17491.png