quartz基本介绍

2020-01-20 16:02:32来源：博客园阅读 ()

quartz基本介绍

Quartz基本介绍

简介

Quartz是一个功能强大的开源任务调度框架,几乎可以继承到任何java应用程序。Quartz可以用来创建简单或为运行十个，百个，甚至是好几万个Jobs这样复杂的程序。同时Quartz Scheduler包含许多企业级功能，例如对JTA事务和集群的支持

简单实例

该实例用来在下一分钟执行一个helloJob

public class HelloJobMain {

    public static void main(String[] args) throws Exception {
      //  DirectSchedulerFactory directSchedulerFactory =  DirectSchedulerFactory.getInstance();

        //创建一个调度工厂对象，并从里面获取一个调度器
        SchedulerFactory schedulerFactory = new StdSchedulerFactory();
        Scheduler scheduler = schedulerFactory.getScheduler();


        //获取当前时间的下一分钟
        Date runTime = DateBuilder.evenMinuteDate(new Date());
        //定义一个job jobkey名称 jobkey 组
        JobDetail job = JobBuilder.newJob(HelloJob.class).withIdentity("job1", "group1").build();

        JobDataMap jobDataMap = job.getJobDataMap();
        //JobDataMap jobDataMap=new JobDataMap();
        jobDataMap.put("zhangsan",23);

        //定义一个定时器
        Trigger trigger = TriggerBuilder.newTrigger().withIdentity("trigger1", "group1").startAt(runTime).build();

        scheduler.getContext().put("lisi",24);

        scheduler.scheduleJob(job, trigger);

        scheduler.start();


        Thread.sleep(65L * 1000L);

        scheduler.shutdown(true);

    }
}

public class HelloJob implements Job {
    /**
     * @param jobExecutionContext
     * @throws JobExecutionException
     */
    @Override
    public void execute(JobExecutionContext jobExecutionContext) throws JobExecutionException {
        System.out.println("HelloJob 任务执行啦");

        JobDetail jobDetail = jobExecutionContext.getJobDetail();
        JobKey key = jobDetail.getKey();
        Trigger trigger = jobExecutionContext.getTrigger();
        TriggerKey key1 = trigger.getKey();

        JobDataMap mergedJobDataMap = jobExecutionContext.getMergedJobDataMap();
        System.out.println(mergedJobDataMap.get("zhangsan"));

        SchedulerContext context = null;
        try {
            context = jobExecutionContext.getScheduler().getContext();
        } catch (SchedulerException e) {
            e.printStackTrace();
        }
        System.out.println(context.get("lisi"));


    }
}

上面代码是创建一个Job的基本步骤，即包括：

1、创建SchedulerFactory工厂对象，并从中获取一个Scheduler

2、创建一个JobDetail

3、创建一个触发器即Trigger

4、注册到Scheduler,即scheduler.scheduleJob(job, trigger);

5、启动Scheduler，即scheduler.start();

核心类与接口

Job:是一个接口，里面有一个方法public void execute(JobExecutionContext jobExecutionContext) throws JobExecutionException，开发者在开发调度任务的时候，只需要实现该接口即可。JobExecutionContext类提供了调度上下文的各种信息。Job运行时的信息保存在JobDataMap，也可以保存在SchedulerContext中。

JobDetail:传递给定Job实例的详细信息，包括Job名字以及所属的组

Trigger：触发Job执行的时间的规则。主要有CalendarIntervalTrigger，CronTrigger，DailyTimeIntervalTrigger，SimpleTrigger，常用的有SimpleTrigger和CronTrigger两个。

? CalendarIntervalTrigger：按照固定的时间间隔来触发任务。比如：使用月作为间隔单位，不小心设置为月底的最后一天，比如1月31号，Trigger的Unit为month，interval是1，则下一个触发为2月28号，之后再次触发为3月28号，依次类推。

? DailyTimeIntervalTrigger：跟CalendarIntervalTrigger类似，比如：Trigger设置在8:00~11:00之间，每72分钟执行一次，则执行时间为8:00, 9:12, 10:24，下次执行时间为第二天的8:00, 9:12, 10:24。

? CronTrigger：按照Cron表达式给定的时间触发任务

? SimpleTrigger：用来触发只需执行一次或者在给定时间触发并且重复N次且每次执行延迟一定时间的任务。

Scheduler：代表一个Quartz的独立运行容器，Trigger和JobDetail可以注册到Scheduler中，两者在Scheduler中拥有各自的组及名称，组及名称是Scheduler查找定位容器中某一对象的依据，Trigger的组及名称必须唯一，JobDetail的组和名称也必须唯一（但可以和Trigger的组和名称相同，因为它们是不同类型的）。Scheduler定义了多个接口方法，允许外部通过组及名称访问和控制容器中Trigger和JobDetail。

ThreadPool：Scheduler使用一个线程池作为任务运行的基础设施，任务通过共享线程池中的线程提高运行效率。
JobStore：通过类实现的接口，这些类要为org.quartz.core.QuartzScheduler的使用提供一个org.quartz.Job和org.quartz.Trigger存储机制。作业和触发器的存储应该以其名称和组的组合为唯一性。
QuartzSchedulerResources：包含创建QuartzScheduler实例所需的所有资源（JobStore，ThreadPool等）。
SchedulerFactory ：提供用于获取调度程序实例的客户端可用句柄的机制
QuartzSchedulerThread：负责执行向QuartzScheduler注册的触发Trigger的工作的线程。

Cron表达式

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

字段	允许值	允许特殊字符
Seconds	0-59	, - * /
Minutes	0-59	, - * /
Hours	0-23	, - * /
Day-of-month	1-31	, - * ? / L W
Month	0-11 or JAN-DEC	, - * /
Day-of-Week	1-7 or SUN-SAT	, - * ? / L #
Year (Optional)	empty, 1970-2199	, - * /

*号：代表任意的值，比如：在minutes代表任意每一分钟

？号：用于day-of-month 和 day-of-week，表示不匹配任何值

-号：比如用在hour字段，10-12 表示匹配10,11,12

,号：表示枚举值，比如在day-of-week：MON,WED,FRI代表Monday, Wednesday, 和Friday

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

L号：表示最后，用在day-of-month 和day-of-week, 如果在day-of-week域使用5L,意味着在最后的一个星期四触发。

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

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

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

表达式	含义
0 0 12 * * ?	表示每天12点执行
0 15 10 ? * *	每天10:15am执行
0 15 10 * * ?	每天10:15am执行
0 15 10 * * ? *	每天10:15am执行
0 15 10 * * ? 2005	2005年每天10:15am执行
0 * 14 * * ?	每天从2:00pm到2:59pm每分钟执行
0 0/5 14 * * ?	每天从2:00pm到2:59pm每5分钟执行
0 0/5 14,18 * * ?	每天2:00pm到2:59pm和6:00pm到6:59pm,每5分钟执行一次
0 0-5 14 * * ?	每天2：00pm到2:05pm每分钟执行
0 10,44 14 ? 3 WED	每年三月的星期三的下午2:10和2:44触发
0 15 10 ? * MON-FRI	周一至周五的上午10:15触发
0 15 10 15 * ?	每月15日上午10:15触发
0 15 10 L * ?	每月最后一日的上午10:15触发
0 15 10 ? * 6L	每月的最后一个星期五上午10:15触发
0 15 10 ? * 6L 2002-2005	2002年至2005年的每月的最后一个星期五上午10:15触发
0 15 10 ? * 6#3	每月的第三个周五上午10:15触发