Quartz入门

Quartz简介及应用场景

1. Quartz介绍

任务调度框架“Quartz”是OpenSymphony开源组织在Job scheduling领域又一个开源项目，是完全由java开发的一个开源的任务日程管理系统
“任务进度管理器”就是一个在预先确定（被纳入日程）的时间到达时，负责执行（或者通知）其他软件组件的系统。

简单来说就是实现“计划(或定时)任务”的系统
例如：订单下单后未付款，15分钟后自动撤消订单，并自动解锁锁定的商品

2. Quartz的触发器

触发器用来告诉调度程序作业什么时候触发。框架提供了5种触发器类型，但两个最常用的
SimpleTrigger和CronTrigger

五种类型的Trigger(定时器)
SimpleTrigger，CronTirgger，DateIntervalTrigger，NthIncludedDayTrigger和Calendar类（ org.quartz.Calendar）

场景：
SimpleTrigger：执行N次，重复N次
CronTrigger：几秒 几分 几时 哪日 哪月 哪周 哪年，执行

3. 存储方式

RAMJobStore(内存作业存储类型)和JDBCJobStore(数据库作业存储类型)

两种方式对比如下：

            优点                                                     缺点
RAMJobStore  不要外部数据库，配置容易，运行速度快       因为调度程序信息是存储在被分配给JVM的内存里面，
                                                  所以，当应用程序停止运行时，所有调度信息将被丢失。
                                                  另外因为存储到JVM内存里面，所以可以存储多少个Job和Trigger将会受到限制

JDBCJobStor  支持集群，因为所有的任务信息都会保存       运行速度的快慢取决与连接数据库的快慢
             到数据库中，可以控制事物，还有就是如
             果应用服务器关闭或者重启，任务信息都
             不会丢失，并且可以恢复因服务器关闭或
             者重启而导致执行失败的任务  

4. 核心类和核心类之间关系

4.1 QuartzSchedulerThread
负责执行向QuartzScheduler注册的触发Trigger的工作的线程

4.2 ThreadPool
Scheduler使用一个线程池作为任务运行的基础设施，任务通过共享线程池中的线程提供运行效率

4.3 QuartzSchedulerResources
包含创建QuartzScheduler实例所需的所有资源（JobStore，ThreadPool等

4.4 SchedulerFactory
提供用于获取调度程序实例的客户端可用句柄的机制

4.5 JobStore
通过类实现的接口，这些类要为org.quartz.core.QuartzScheduler的使用提供一个org.quartz.Job和org.quartz.Trigger存储机制
作业和触发器的存储应该以其名称和组的组合为唯一性

4.6 QuartzScheduler
这是Quartz的核心，它是org.quartz.Scheduler接口的间接实现，包含调度org.quartz.Jobs，注册org.quartz.JobListener实例等的方法

4.7 Scheduler
这是Quartz Scheduler的主要接口，代表一个独立运行容器。调度程序维护JobDetails和触发器的注册表。
一旦注册，调度程序负责执行作业，当他们的相关联的触发器触发（当他们的预定时间到达时）。

4.8 Trigger
具有所有触发器通用属性的基本接口，描述了job执行的时间出发规则。 - 使用TriggerBuilder实例化实际触发器。

4.9 JobDetail
传递给定作业实例的详细信息属性。 JobDetails将使用JobBuilder创建/定义。

  1.jobname+jobgroup=primary key identity
  2.jobdetail每执行一次都会新建一个job实例

   XxxJob/XxxTask

4.10 Job：
要由表示要执行的“作业”的类实现的接口。只有一个方法

   void execute(jobExecutionContext context) 
   (jobExecutionContext 提供调度上下文各种信息 运行时数据保存在jobDataMap中) 

   Job有个子接口StatefulJob 代表有状态任务

有状态任务不可并发，前次任务没有执行完，后面任务处于阻塞等待

 jobName+groupName=primary key

例如：将任务纳入日程或者从日程中取消，开始/停止/暂停日程进度

翻译：Scheduler的中文是：“调度程序，日程安排程序”

图解quartz工作流程

创建工程

导入pom依赖

package com.lzy.quartz1.demo;

import com.lzy.quartz1.job.RamJob;
import org.quartz.*;
import org.quartz.impl.StdSchedulerFactory;

import static org.quartz.JobBuilder.newJob;

/**
 *  Quartz的入门级案例
 *  讲解Quartz定时任务调用过程
 */
public class Demo1 {
    public static void main(String[] args) throws Exception {
        // scheduler工厂
        SchedulerFactory schedulerFactory=new StdSchedulerFactory();
       // 获得调动器
        Scheduler scheduler=schedulerFactory.getScheduler();
        // 具体定时任务需要执行的代码
        JobDetail jobDetail=newJob(RamJob.class)
                            .withIdentity("job1","group1")
                            .withDescription("第一个定时任务案例")
                            .build();
        //构建触发器（存放定时任务执行规则）
        Trigger trigger=(Trigger) TriggerBuilder.newTrigger()
                        // 定时任务每五秒执行一次 一个执行三次
                        .withSchedule(SimpleScheduleBuilder.repeatSecondlyForTotalCount(3,5))
                        //  触发器标识
                        .withIdentity("trigger1","group1")
                        .withDescription("第一个触发器")
                        .build();
        //  调度工厂绑定作业类及触发器
        scheduler.scheduleJob(jobDetail,trigger);
        // 启动定时任务
        scheduler.start();

    }
}

Quartz表达式触发器CronTirgger介绍

Demo2.java

package com.lzy.quartz1.demo;

import com.lzy.quartz1.job.RamJob;
import org.quartz.*;
import org.quartz.impl.StdSchedulerFactory;

import static org.quartz.JobBuilder.newJob;

/**
 *  Quartz的表达式触发器
 */
public class Demo2 {
    public static void main(String[] args) throws Exception {
        // scheduler工厂
        SchedulerFactory schedulerFactory=new StdSchedulerFactory();
       // 获得调动器
        Scheduler scheduler=schedulerFactory.getScheduler();
        // 具体定时任务需要执行的代码
        JobDetail jobDetail=newJob(RamJob.class)
                            .withIdentity("job1","group1")
                            .withDescription("第一个定时任务案例")
                            .build();
        //构建触发器（存放定时任务执行规则）
        Trigger trigger=(Trigger) TriggerBuilder.newTrigger()
                        // 指定表达触发器规则
                        // ("1/3 * * * * ?") 从第一秒开始每三秒执行一次  无上限
                        // .withSchedule(CronScheduleBuilder.cronSchedule("1/3 * * * * ?"))
                        // 在21：07执行一次 "0/10 * * * * ?"
                        .withSchedule(CronScheduleBuilder.cronSchedule("0 07 21 * * ?"))
                        //  触发器标识
                        .withIdentity("trigger1","group1")
                        .withDescription("第一个触发器")
                        .build();
        //  调度工厂绑定作业类及触发器
        scheduler.scheduleJob(jobDetail,trigger);
        // 启动定时任务
        scheduler.start();

    }
}

Spring task Vs Quartz

Spring task

优点：无需整合spring，作业类中就可以调用业务service
缺点：单线程；不能做数据存储型的定时任务

Quartz

优点：多线程；可以做数据存储型的定时任务，维护性高；
缺点：需要整合spring，不能直接调用业务层service；

线程论证代码

Spring task代码

SpringTask.java
单线程 不能做数据存储型的定时任务

package com.lzy.quartz1.demo;

import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Service;

import java.text.SimpleDateFormat;
import java.util.Date;

@Service
public class SpringTask {
    @Scheduled(cron = "0/10 * * * * ?")
    public void task(){
        SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        System.err.println(format.format(new Date())+" : spring task...");

        try {
            Thread.sleep(20*1000);
            System.out.println("模拟正在处理大数据");
        } catch (InterruptedException e) {
            e.printStackTrace();
        }
    }
}

在Quartz1Application加上注解

运行如下

Quartz代码

RamJob.java
多线程 可以做数据存储型的定时任务 维护性高

package com.lzy.quartz1.job;

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

import java.text.SimpleDateFormat;
import java.util.Date;

public class RamJob implements Job {
    @Override
    public void execute(JobExecutionContext jobExecutionContext) throws JobExecutionException {
        //System.err.println("定时任务启动所会执行的代码块");
        SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        System.err.println(format.format(new Date())+" : Quartz task...");

        try {
            Thread.sleep(20*1000);
            System.out.println("模拟正在处理大数据");
        } catch (InterruptedException e) {
            e.printStackTrace();
        }
    }

}