Quartz使用教程（基础）

1.Quartz介绍

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

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

简单的来说：在某一个有规律的时间点干某件事。并且时间的触发的条件可以非常复杂（比如每月最后一个工作日的17:50），复杂到需要一个专门的框架来干这个事。 Quartz就是来干这样的事，你给它一个触发条件的定义，它负责到了时间点，触发相应的Job起来干活。

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

                                                       

图解quartz工作流程：      

               

               

               

         

quartz相关表达式cron：

Cron表达式是一个字符串，字符串以5或6个空格隔开，分为6或7个域，每一个域代表一个含义，Cron有如下两种语法格式：

　　（1） Seconds Minutes Hours DayofMonth Month DayofWeek Year

　　（2）Seconds Minutes Hours DayofMonth Month DayofWeek

　corn从左到右（用空格隔开）：秒 分 小时 月份中的日期 月份 星期中的日期 年份

各字段的含义:

字段	允许值	允许的特殊字符
秒（Seconds）	0~59的整数	, - * /    四个字符
分（Minutes）	0~59的整数	, - * /    四个字符
小时（Hours）	0~23的整数	, - * /    四个字符
日期（DayofMonth）	1~31的整数（但是你需要考虑你月的天数）	,- * ? / L W C     八个字符
月份（Month）	1~12的整数或者 JAN-DEC	, - * /    四个字符
星期（DayofWeek）	1~7的整数或者 SUN-SAT （1=SUN）	,- * ? / L W C     八个字符
年(可选，留空)（Year）	1970~2099	, - * /    四个字符

 

  （1）*：表示匹配该域的任意值。假如在Minutes域使用*, 即表示每分钟都会触发事件。

　　（2）?：只能用在DayofMonth和DayofWeek两个域。它也匹配域的任意值，但实际不会。因为DayofMonth和DayofWeek会相互影响。例如想在每月的20日触发调度，不管20日到底是星期几，则只能使用如下写法： 13 13 15 20 * ?, 其中最后一位只能用？，而不能使用*，如果使用*表示不管星期几都会触发，实际上并不是这样。

　　（3）-：表示范围。例如在Minutes域使用5-20，表示从5分到20分钟每分钟触发一次 

　　（4）/：表示起始时间开始触发，然后每隔固定时间触发一次。例如在Minutes域使用5/20,则意味着5分钟触发一次，而               25，45等分别触发一次. 

　　（5）,：表示列出枚举值。例如：在Minutes域使用5,20，则意味着在5和20分每分钟触发一次。 

　　（6）L：表示最后，只能出现在DayofWeek和DayofMonth域。如果在DayofWeek域使用5L,意味着在最后的一个星期四触           发。 

　　（7）W:表示有效工作日(周一到周五),只能出现在DayofMonth域，系统将在离指定日期的最近的有效工作日触发事件。例              如：在 DayofMonth使用5W，如果5日是星期六，则将在最近的工作日：星期五，即4日触发。如果5日是星期天，则在 在6日(周一)触发；如果5日在星期一到星期五中的一天，则就在5日触发。另外一点，W的最近寻找不会跨过月份 。

　　（8）LW:这两个字符可以连用，表示在某个月最后一个工作日，即最后一个星期五。 

　　（9）#:用于确定每个月第几个星期几，只能出现在DayofMonth域。例如在4#2，表示某月的第二个星期三。

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

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

<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.javaxl.quartz01.job;

import org.quartz.*;

/**
 * @author 小李飞刀
 * @site www.javaxl.com
 * @company
 * @create  2019-02-19 11:48
 */
public class RamJob implements Job {
    @Override
    public void execute(JobExecutionContext jobExecutionContext) throws JobExecutionException {
        System.out.println("定时任务执行......");
        JobDetail jobDetail = jobExecutionContext.getJobDetail();
        JobDataMap jobDataMap = jobDetail.getJobDataMap();
        System.out.println("定时任务参数：name->"+jobDataMap.get("name")+",job->"
                +jobDataMap.get("job")+",level->"+jobDataMap.get("level"));
    }
}

执行作业类逻辑：

public static void main(String[] args) throws SchedulerException {
//        创建调度工厂类实例StdSchedulerFactory
        SchedulerFactory sc=new StdSchedulerFactory();
//        创建调度器实例Scheduler
        Scheduler scheduler=sc.getScheduler();
//        创建任务详情JobDetail
        JobDetail jobDetail=newJob(RamJob.class)
                .withIdentity("detail01","group01")  //组成唯一标识
                .withDescription("this is a jobDetail")
//                向具体执行的作业类传值方式一
                .usingJobData("level","老手")
                .build();

        //向具体执行的作业类传值方式二
        JobDataMap jobDataMap=jobDetail.getJobDataMap();
        jobDataMap.put("name","张三");
        jobDataMap.put("job","司机");

        long currentTime = System.currentTimeMillis()+6*1000L;
        Date time = new Date(currentTime);

        Trigger trigger= (Trigger) TriggerBuilder.newTrigger()
                .withIdentity("trigger1","group01")   //组成唯一标识
                .startAt(time)             //开始时间
                .withDescription("this is a trigger")
                简单调度器
//                .withSchedule(SimpleScheduleBuilder.simpleSchedule()
                        每隔两秒重复执行3次
//                        .withIntervalInSeconds(2).withRepeatCount(3))

//                表达式调度器（在线生成定时任务表达式：http://cron.qqe2.com/）
//                每5秒执行一次作业类逻辑代码
                .withSchedule(CronScheduleBuilder.cronSchedule("0/5 * * * * ? "))
                .build();

//        注入作业类以及触发器到调度器中
        scheduler.scheduleJob(jobDetail,trigger);
//        启动调度器
        scheduler.start();

    }

这三个类是quartz的核心类： 

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