Quartz的配置与使用

Posted 2021-01-14 nnxud

什么是Quartz

Quartz是OpenSymphony开源组织在Job scheduling领域的开源项目,它可以与J2EE与J2SE应用程序相结合也可以单独使用。Quartz可以用来创建简单或为运行十个，百个，甚至是好几万个Jobs这样复杂的日程序表。Jobs可以做成标准的Java组件或 EJBs。
Quartz是一个任务日程管理系统，一个在预先确定（被纳入日程）的时间到达时，负责执行（或者通知）其他软件组件的系统。
Quartz用一个小Java库发布文件（.jar文件），这个库文件包含了所有Quartz核心功能。这些功能的主要接口(API)是Scheduler接口。它提供了简单的操作，例如：将任务纳入日程或者从日程中取消，开始/停止/暂停日程进度。

Quartz的框架结构

Quartz框架的核心对象

Scheduler – 核心调度器
Job – 任务
JobDetail – 任务描述
Trigger -- 触发器

对象之间的关系

使用方法

1、把quartz-2.2.2.jar这个包加到工程中去，若用maven管理，则依赖为：

<dependency>
    <groupId>org.quartz-scheduler</groupId>
    <artifactId>quartz</artifactId>
    <version>2.2.2</version>
</dependency>
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-context-support</artifactId>
    <version>4.1.3.RELEASE</version>
</dependency>

2、创建job类

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

/**
 * 
 */
package cn.xnn.login;

/**
 * 类(接口)描述:
 * @author xnn
 * 2018年10月20日下午2:00:52
 */
public class Schedul {
//具体的任务
    public void execute(){
        System.out.println("1325");
    }
}

3、配置Job到spring容器

就是把上面写的类配置到spring容器中，让spring管理

<bean id="Schedul" class="cn.xnn.login.Schedul"> </bean>

4、将Job类配置JobDetail

<bean id="SpringQtzJobMethod"
        class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">
        <!-- 注入要具体执行的任务的呢个bean -->
        <property name="targetObject">
            <ref bean="Schedul" />
        </property>
        <property name="targetMethod">  
        <!-- 要执行的方法名称 -->
            <value>execute</value>
        </property>
    </bean>

5、配置调度触发器

<!-- 配置调度触发器 -->
    <bean id="cronTriggerFactoryBean" class="org.springframework.scheduling.quartz.CronTriggerFactoryBean ">
        <!-- 此处的jobDetial正是上面所配的bean -->
        <property name="jobDetail" ref="SpringQtzJobMethod"></property>
        <!-- 0/5 * * * * ?：意即每隔5秒执行一次 -->
        <property name="cronExpression" value="0/5 * * * * ?"></property>
    </bean>

5、配置调度工厂

<!-- 配置调度工厂 -->
    <bean id="SpringJobSchedulerFactoryBean"
        class="org.springframework.scheduling.quartz.SchedulerFactoryBean">
        <!-- 这个 triggers正是上面所配置的调度触发器，是个list，可以写多个触发器-->
        <property name="triggers">
            <list>
                <ref bean="cronTriggerFactoryBean" />
            </list>
        </property>
    </bean>

配置完毕后，启动服务。可以看到：

附注（cron的表达式）：

cron的表达式被用来配置CronTrigger实例。 cron的表达式是字符串，实际上是由七子表达式，描述个别细节的时间表。这些子表达式是分开的空白，代表：
1.       Seconds
2.       Minutes
3.        Hours
4.        Day-of-Month
5.        Month

1.       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 * * ?