Quartz入门

时间  2021-07-13

重点：

    1. Quartz介绍
    1. Quartz的触发器
    1. 存储方式
    1. 核心类和核心类之间关系
    1. 配置文件quartz.properties
    1. JDBC插入表顺序
    1. Quartz简单入门Demo(RAM方式)，版本quartz.2.2.1
  • 8.、代码演示

重点解析：

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

quartz相关表达式：

在线生成表达式网址：http://cron.qqe2.com/

在这里插入图片描述
在这里插入图片描述

  1. 核心类和核心类之间关系
    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

5.10
Job：
要由表示要执行的“作业”的类实现的接口。只有一个方法
void execute(jobExecutionContext context)
(jobExecutionContext 提供调度上下文各种信息，运行时数据保存在jobDataMap中)

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

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

jobName+groupName=primary key

注1：这里面最最重要的接口是Scheduler接口。它提供了简单的操作，例如：将任务纳入日程或者从日程中取消，开始/停止/暂停日程进度。
翻译：Scheduler的中文是：“调度程序，日程安排程序”

  1. 配置文件quartz.properties
    内容分如下几个部分
    Quartz Schedular主配置、ThreadPool设置、JobStore配置、DataSources、JDBC-JobStore群集

  2. JDBC插入表顺序
    Simple_trigger ：插入顺序
    qrtz_job_details —> qrtz_triggers —> qrtz_simple_triggers
    qrtz_fired_triggers

    Cron_Trigger：插入顺序
    qrtz_job_details —> qrtz_triggers —> qrtz_cron_triggers
    qrtz_fired_triggers

  3. Quartz简单入门Demo(RAM方式)，版本quartz.2.2.1
    7.1 导入依赖

    org.quartz-scheduler
    quartz
    2.2.1


    org.quartz-scheduler
    quartz-jobs
    2.2.1

7.2 创建自定义RamJob
必须实现org.quartz.Job接口
RamJob

关键代码：
  public class RamJob implements Job{
  @Override
	  public void execute(JobExecutionContext jobExecutionContext) throws JobExecutionException{
      ...
      }
  }

7.3 启动quartz

关键代码：
 SchedulerFactory sc=new StdScheduleFactory();
 Scheduler scheduler=sc.getScheduler();

 JobDetail jobDetail=newJob(Job接口类)
        .withIdentity(name,group)  //组成唯一标识
        .build();

 //向任务中传递数据
 JobDataMap jobDataMap=jobDetail.getJobDataMap();
 ....

 Trigger trigger=TriggerBuilder.newTrigger()
         .withIdentity(name,group)   //组成唯一标识
         .startAt(time);             //开始时间
         .withSchedule(SimpleScheduleBuilder.simpleSchedule().withIntervalInSeconds(2).withRepeatCount(3))

 scheduler.scheduleJob(jobDetail,trigger);

 scheduler.start();

8.、代码演示（包含简单调度器以及表达式触发器两类）

所需pom依赖：

<dependency>
       <groupId>org.quartz-scheduler</groupId>
       <artifactId>quartz-jobs</artifactId>
       <version>2.2.1</version>
  </dependency>

具体作业类代码：

package com.zking.job;
 
import org.quartz.*;
 
/**
 * @author cjl
 * @site www.cjl.com
 * @Date 2019年02月23日
 * @Time 19:20
 */
public class RamJob implements Job {
 
    public void execute(JobExecutionContext jobExecutionContext) throws JobExecutionException {
        System.out.println("定时任务启动。。。。");
        JobDetail jobDetail = jobExecutionContext.getJobDetail();
        JobDataMap jobDataMap = jobDetail.getJobDataMap();
        System.out.println("定时任务参数：level-》" + jobDataMap.get("level") + ",name-》"
        + jobDataMap.get("name") + ",sex-》" + jobDataMap.get("sex"));
    }
}

执行作业类逻辑：

public static void main(String[] args) throws SchedulerException {
            //创建调度工厂类实例StdSchedulerFactory
            StdSchedulerFactory sc = new StdSchedulerFactory();
            //创建调度器实例Scheduler
            Scheduler scheduler = sc.getScheduler();
            //创建任务详情JobDetail
            JobDetail jobDetail = newJob(RamJob.class)
                    .withIdentity("detail1","group1")//组成唯一标识
                    .withDescription("this is a jobDetail")
                    //向具体执行的作业类传值方式一
                    .usingJobData("level","admin")
                    .build();
     
            //向具体执行的作业类传值方式二
            JobDataMap jobDataMap = jobDetail.getJobDataMap();
            jobDataMap.put("name","zs");
            jobDataMap.put("sex","man");
     
            Trigger trigger = TriggerBuilder.newTrigger()
                    .withIdentity("trigger1","group1")
                    .withDescription("this is a trigger")
                    //简单调度器：每四秒执行一次，共执行三次
                    .withSchedule(SimpleScheduleBuilder.repeatSecondlyForTotalCount(3,4))
                    //表达式调度器：每五秒执行一次
    //                .withSchedule(CronScheduleBuilder.cronSchedule("*/5 * * * * ?"))
                    .build();
     
            //注入作业类以及触发器到调度器中
            scheduler.scheduleJob(jobDetail,trigger);
            //启动调度器
            scheduler.start();
        }

运行效果：
在这里插入图片描述

这个例子很好的覆盖了Quartz最重要的3个基本要素：

Scheduler：调度器。所有的调度都是由它控制。
Trigger： 定义触发的条件。
JobDetail & Job： JobDetail 定义的是任务数据，而真正的执行逻辑是在Job中，例子中是RamJob。 为什么设计成JobDetail + Job，不直接使用Job？这是因为任务是有可能并发执行，如果Scheduler直接使用Job，就会存在对同一个Job实例并发访问的问题。而JobDetail & Job 方式，sheduler每次执行，都会根据JobDetail创建一个新的Job实例，这样就可以规避并发访问的问题。
5、spring自带的定时任务

缺点：单线程执行

package com.zking.job;
 
import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Service;
 
/**
 * @author cjl
 * @site www.cjl.com
 * @Date 2019年02月23日
 * @Time 20:19
 */
@Service
public class SpringTask {
 
    @Scheduled(cron = "0/5 * * * * ?")
    public void test(){
        System.out.println("测试spring自带的定时任务。。。。");
        try {
            Thread.sleep(10*1000);
        } catch (InterruptedException e) {
            e.printStackTrace();
        }
        System.out.println("定时任务结束。。。。");
    }
}

package com.zking; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.scheduling.annotation.EnableScheduling; @EnableScheduling @SpringBootApplication public class Quartz01Application { public static void main(String[] args) { SpringApplication.run(Quartz01Application.class, args); } }

联系我们 沪ICP备13005482号-10