Quartz - 任务调度框架

Quartz

         在某一个有规律的时间点干某件事。并且时间的触发的条件可以非常复杂，复杂到需要一个专门的框架来干这个事。                  Quartz就是来干这样的事，你给它一个触发条件的定义，它负责到了时间点，触发相应的Job起来干活如果应用程序需要在给定时间执行任务，或者如果系统有连续维护作业，那么Quartz是理想的解决方案。

一、特点

1、作业调度

2、作业持久性

二、使用

1、导入依赖

 
        org.quartz-scheduler
        quartz
        2.2.3
    

 

2、 定义Job

package com.vince.job;

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

import java.util.Date;

public class Myjob  implements Job {
    //执行
    public void execute(JobExecutionContext context) throws JobExecutionException {
        //创建工作详情
        JobDetail jobDetail=context.getJobDetail();
        //获取工作的名称
        String name = jobDetail.getKey().getName();//任务名
        String group = jobDetail.getKey().getGroup();//任务group
        String job=jobDetail.getJobDataMap().getString("data04");//任务中的数据
        System.out.println("job执行~job名:"+name+"   group:"+group+"   data:"+job+new Date());
    }
}

 

3 、API测试

package com.vince.test;

import com.vince.job.Myjob;
import org.quartz.*;
import org.quartz.impl.StdSchedulerFactory;

public class TestAll {

    public static void main(String[] args) throws SchedulerException {

        //创建scheduler，调度器
        Scheduler scheduler = StdSchedulerFactory.getDefaultScheduler();

        //定义一个Trigger,触发条件类
        TriggerBuilder triggerBuilder = TriggerBuilder.newTrigger();
        Trigger trigger  = triggerBuilder.withIdentity("trigger1", "group1") //定义name/group
                        /*.startNow()//一旦加入scheduler，立即生效，即开始时间
                        .withSchedule(SimpleScheduleBuilder.simpleSchedule()
                        .withIntervalInSeconds(2) //每隔一秒执行一次
                        .repeatForever()) //一直执行，直到结束时间
                                          //可以设置结束时间,如果不设置，则一直执行
                        .endAt(new GregorianCalendar(2019,10,19,21,35,0).getTime())*/

                        .withSchedule(CronScheduleBuilder.cronSchedule("*/2 * * * * ?"))
                        .build();

        //定义一个JobDetail
        //定义Job类为Myjob类，这是真正的执行逻辑所在
        JobDetail job = JobBuilder.newJob(Myjob.class)
                .withIdentity("测试任务2","test") //定义name/group
                .usingJobData("data04","正在测试定时任务~") //定义属性，存储数据
                .build();

        //调度器 中加入 任务和触发器
        scheduler.scheduleJob(job,trigger);



    }


}

 

三、核心

    1、Scheduler：调度器。所有的调度都是由它控制。
    2、Scheduler就是Quartz的大脑，所有任务都是由它来设施。
    3、Schduelr包含一个两个重要组件: JobStore和ThreadPool。
    4、JobStore是会来存储运行时信息的，包括Trigger,Schduler,JobDetail，业务锁等。
    5、ThreadPool就是线程池，Quartz有自己的线程池实现。所有任务的都会由线程池执行。

      SchdulerFactory，顾名思义就是来用创建Schduler了，有两个实现：DirectSchedulerFactory和 StdSchdulerFactory。前者可以用来在代码里定制你自己的Schduler参数。后者是直接读取classpath下的quartz.properties（不存在就都使用默认值）配置来实例化Schduler。通常来讲，我们使用StdSchdulerFactory也就足够了。

    SchdulerFactory本身是支持创建RMI stub的，可以用来管理远程的Scheduler，功能与本地一样。

 

四、CronTrigger

        适合于更复杂的任务，它支持类型于Linux Cron的语法（并且更强大）。

  Cron表达式：

位置	时间域	允许值	特殊值
1	秒	0-59	, - * /
2	分钟	0-59	, - * /
3	小时	0-23	, - * /
4	日期	1-31	, - * ? / L W
5	月份	1-12	, - * /
6	星期	1-7	, - * ? / L #
7	年份（可选）	1-31	, - * /

 

星号(*)：可用在所有字段中，表示对应时间域的每一个时刻，例如， 在分钟字段时，表示“每分钟”；

问号（?）：该字符只在日期和星期字段中使用，它通常指定为“不确定值”

减号(-)：表达一个范围，如在小时字段中使用“10-12”，则表示从10到12点，即10,11,12；

逗号(,)：表达一个列表值，如在星期字段中使用“MON,WED,FRI”，则表示星期一，星期三和星期五；

斜杠(/)：x/y表达一个等步长序列，x为起始值，y为增量步长值。如在分钟字段中使用0/15，则表示为0,15,30和45秒，而5/15在分钟字段中表示5,20,35,50，你也可以使用*/y，它等同于0/y；

L：该字符只在日期和星期字段中使用，代表“Last”的意思，但它在两个字段中意思不同。L在日期字段中，表示这个月份的最后一天，如一月的31号，非闰年二月的28号；如果L用在星期中，则表示星期六，等同于7。但是，如果L出现在星期字段里，而且在前面有一个数值X，则表示“这个月的最后一个周x”，例如，6L表示该月的最后星期五；

W：该字符只能出现在日期字段里，是对前导日期的修饰，表示离该日期最近的工作日。例如15W表示离该月15号最近的工作日，如果该月15号是星期六，则匹配14号星期五；如果15日是星期日，则匹配16号星期一；如果15号是星期二，那结果就是15号星期二。但必须注意关联的匹配日期不能够跨月，如你指定1W，如果1号是星期六，结果匹配的是3号星期一，而非上个月最后的那天。W字符串只能指定单一日期，而不能指定日期范围；

LW组合：在日期字段可以组合使用LW，它的意思是当月的最后一个工作日；

 

表达式示例：

表示式	说明
秒 分 时 日 月 周
0 0 12 * * ?	每天12点运行
0 15 10 * * ?	每天10:15运行
0 15 10 * * ? 2008	在2008年的每天10：15运行
0 * 14 * * ?	每天14点到15点之间每分钟运行一次，开始于14:00，结束于14:59。

Job并发 ：

   job是有可能并发执行的，比如一个任务要执行10秒中，而调度算法是每秒中触发1次，那么就有可能多个任务被并发执行。

   这个时候一个@DisallowConcurrentExecution解决这个问题。

 

@DisallowConcurrentExecution
public class DoNothingJob implements Job {
    public void execute(JobExecutionContext context) throws JobExecutionException {
        System.out.println("操作");
    }
}

 

注意，@DisallowConcurrentExecution是对JobDetail实例生效，也就是如果你定义两个JobDetail，引用同一个Job类，是可以并发执行的。

@DisallowConcurrentExecution //会不允许并发执行，（如果每1s触发一次，但每个job要执行3秒）
public class MyJob implements Job{
    @Override
    public void execute(JobExecutionContext context) throws JobExecutionException {
        try {
            Thread.sleep(3000);
        } catch (InterruptedException e) {
            e.printStackTrace();
        }
        System.out.println("任务调度：组："+group+",工作名："+name+" "+data+new Date());
    }
}

五、Spring整合Quartz

1、依赖

 
      org.springframework
      spring-context-support
      ${springframework.version}
    

    
      org.springframework
      spring-tx
      ${springframework.version}
    

    
      org.springframework
      spring-web
      ${springframework.version}
    

    
      org.quartz-scheduler
      quartz
      ${quartz.version}
    

 

2、配置

调度器 SchedulerFactoryBean

触发器 CronTriggerFactoryBean

JobDetail JobDetailFactoryBean

    

    
    
        
        
        
        
        
        
        
        
        
        
    

   


    
    
        
        
        
        
        
        
        
        
    

    
    
        
            
                
                
            
        
        
        
        
            
                # 指定调度器名称，实际类型为：QuartzScheduler
                org.quartz.scheduler.instanceName = MyScheduler
                # 指定连接池
                org.quartz.threadPool.class = org.quartz.simpl.SimpleThreadPool
                # 连接池线程数量
                org.quartz.threadPool.threadCount = 11
                # 优先级
                org.quartz.threadPool.threadPriority = 5
                # 不持久化job
                org.quartz.jobStore.class = org.quartz.simpl.RAMJobStore
            
        
    

3、web.xml 项目的全局配置

Archetype Created Web Application
  
    contextConfigLocation
    classpath:applicationContext.xml
  

  
    org.springframework.web.context.ContextLoaderListener