quartz入门

时间  2021-07-13

1. Quartz介绍:

      任务调度框架“Quartz”是OpenSymphony开源组织在Job scheduling领域又一个开源项目，是完全由java开发的一个开源的任务日程管理系统，

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

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

2.Quartz的三个核心类：

       调度器：Scheduler          触发器：Trigger       作业类：JobDetail

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

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

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

4. 存储方式

      

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

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

5. 核心类和核心类之间关系
  5.1 QuartzSchedulerThread 
      负责执行向QuartzScheduler注册的触发Trigger的工作的线程。
 
  5.2 
ThreadPool
      Scheduler使用一个线程池作为任务运行的基础设施，任务通过共享线程池中的线程提供运行效率。

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

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

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

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

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

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

  5.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的中文是：“调度程序，日程安排程序” 

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

7. 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

quartz相关表达式

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

小李飞刀_quartz

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

所需pom依赖

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

具体类：

package com.spring.quartz.quartz;

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

/**
 * @author cst
 * @site www.xiaomage.com
 * @company xxx公司
 * @create 2019-02-23 15:30
 */
public class RamJob implements Job {


    @Override
    public void execute(JobExecutionContext jobExecutionContext) throws JobExecutionException {
        System.out.println("启动定时任务----");
        JobDataMap jobDataMap = jobExecutionContext.getJobDetail().getJobDataMap();
        System.out.println(jobDataMap.get("lenven")+""+jobDataMap.get("job"));
    }
}

执行作业类逻辑

package com.spring.quartz;

import com.spring.quartz.quartz.RamJob;
import org.quartz.*;
import org.quartz.impl.StdSchedulerFactory;

import static org.quartz.JobBuilder.newJob;

/**
 * @author cst
 * @site www.xiaomage.com
 * @company xxx公司
 * @create 2019-02-23 15:32
 */

//  quartz的定时任务
public class QuartzTest {
    public static void main(String[] args) throws SchedulerException {
//        创建调度器
//        将具体的作业类（RamJob）绑定到调度任务详情中
//        创建触发器

        Scheduler scheduler = new StdSchedulerFactory().getScheduler();
        JobDetail jobDetail = newJob(RamJob.class)
                .withDescription("this is a job")
                .withIdentity("job1","group1")
                .usingJobData("lenven","老师")
                .build();

//        usingJobData 传值的第一种方法
//        传值的第二种方法
        JobDataMap jobDataMap = jobDetail.getJobDataMap();
        jobDataMap.put("job","教授学院");

        Trigger trigger = TriggerBuilder.newTrigger()
                .withDescription("this is a trigger")
//                .withSchedule(SimpleScheduleBuilder.repeatSecondlyForTotalCount(3,10))
                .withSchedule(CronScheduleBuilder.cronSchedule("1-2 0 1/1 * * ? *"))
                .withIdentity("trigger1","group1")
                .build();

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

//        启动调度器
        scheduler.start();
    }
}
联系我们 沪ICP备13005482号-10