quartz学习一--入门

原创 2016年06月01日 15:24:12
一、概述
    1、简介
       (1)、项目创立于1998年, 不间断更新,活跃度高。

       (2)、纯Java设计,设计用于JavaSE、JavaEE, 方便集成于:JVM、JMI

       (3)、官网
            http://www.quartz-scheduler.org/

       (4)、cron表达式辅助工具
            http://www.cronmaker.com/    

    2、功能
       (1)、核心概念
            scheduler                                --->        调度器

            trigger                                --->        触发器

            job                                    --->        调度任务对象

            jobDetail                                --->        调度任务描述

            listener                                --->        调度监听

            calendar                                --->        调度时间点

       (2)、支持集群
            org.quartz.jobStore.isClustered

       (3)、支持任务恢复
            requestsRecovery

    3、示例
       // (1)、通过SchedulerFactory构建Scheduler对象  
       Scheduler sched = sf.getScheduler();  

       // (2)、声明 CronTrigger 触发器
       CronTrigger trigger = new CronTrigger("helloWorldTrigger", "cronGroup", "1/1 * * * * ?");  

       // (3)、声明  JobDetail(将 job 等属性赋值给JobDetail)
       JobDetail job = new JobDetail("helloWorldJob", Scheduler.DEFAULT_GROUP, HelloWorldJob.class);

       // (4)、工厂模式,组装各个组件<JOB,Trigger>  
       sched.scheduleJob (job, trigger);  
 
       // (5)、start   
       sched.start();  

    4、流程图
       (1)、创建调度工厂                            --->        工厂模式

       (2)、根据工厂取得调度器实例                        --->        工厂模式

       (3)、Builder模式构建子组件<Job,Trigger>                    --->        builder模式, 如JobBuilder、TriggerBuilder、DateBuilder

       (4)、通过调度器组装子组件,调度器.组装<子组件1,子组件2...>        --->        工厂模式

       (5)、调度器.start                            --->        工厂模式

二、入门(居于 Quartz 1.*)
    1、目录结构和内容
       docs/api                                    --->        Quartz 框架的JavaDoc Api 说明文档

       docs/dbTables                                --->        创建 Quartz 的数据库对象的脚本

       docs/wikidocs                                --->        Quartz 的帮助文件,点击 index.html 开始查看

       Examples                                    --->        多方面使用 Quartz 的例子Lib Quartz 使用到的第三方包

       src/java/org/quartz                            --->        使用 Quartz 的客户端程序源代码,公有 API

       src/java/org/quartz/core                            --->        使用 Quartz 的服务端程序源代码,私有 API

       src/java/org/quartz/simpl                        --->        Quartz 提供的不衣赖于第三方产品的简单实现

       src/java/org/quartz/impl                            --->        依赖于第三方产品的支持模块的实现

       src/java/org/quartz/utils                        --->        整个框架要用到的辅助类和工具组件

       注:Quartz 框架包含许多的类和接口,它们分布在大概 11 个包中。多数所要使用到的类或接口放置在 org.quartz 包中。这个包含盖了 Quartz 框架的公有 API.

    2、Scheduler
       (1)、作用
            负责对用户定义的所有任务进行调度的类

       (2)、SchedulerFactory                            --->        调度工厂
            a、StdSchedulerFactory
           Quartz默认的SchedulerFactory,依赖于属性类(Properties)决定如何生产 Scheduler 实例

           properties加载顺序:
           检查 System.getProperty("org.quartz.properties") 中是否设置了别的文件名

           使用 quartz.properties 作为要加载的文件名

           试图从当前工作目录中加载这个文件

           试图从系统 classpath 下加载这个文件
           
           Quartz jar包中有一个默认的 quartz.properties 文件

            b、DirectSchedulerFactory
           对SchedulerFactory的直接实现, 通过它可以直接构建Scheduler、threadpool 等

           -- 最简单  
           public void createScheduler(ThreadPool threadPool, JobStore jobStore);  

           -- 最复杂  
           public void createScheduler(String schedulerName, String schedulerInstanceId,ThreadPool threadPool, JobStore jobStore, String rmiRegistryHost, int rmiRegistryPort);  

       (3)、Scheduler
            a、启动 Scheduler
           scheduler.start();
        
            b、销毁 Scheduler
           scheduler.shutdown();

            c、StdScheduler
           Quartz默认的Scheduler

            d、RemoteScheduler
           带有RMI功能的Scheduler

    3、Trigger
       (1)、作用
            描述触发Job执行的时间触发规则。

        调度类(Scheduler)在 特定时间 调用此类,再由trigger类调用指定的定时程序。

       (2)、SimpleTrigger
            a、作用
           用于按频率调度 指定任务

            b、常用属性
           jobDetail        --->        指定调度任务

           repeatInterval        --->        指定间隔时间

           repeatCount        --->        指定次数,默认无穷次

           startDelay        --->        指定延迟多少毫秒启动调度,默认立即
           
           startTime        --->        指定某个时间点启动调试,默认立即

       (3)、CronTriggerBean
            a、作用
           用于按时间点调度 指定任务;使用Linux的Cron表达式 定义时间规则,Cron表达式由6或7个由空格分隔的时间字段组成
           
            b、常用属性
           jobDetail        --->        指定调度任务

           cronExpression        --->        指定重复执行的时间点

            c、cron表达式
           字段        允许值            允许的特殊字符

           秒        0-59            , - * /

           分        0-59            , - * /

           小时        0-23            , - * /

           日期        1-31            , - * ? / L W C

           月份        1-12 或者 JAN-DEC    , - * /

           星期        1-7 或者 SUN-SAT    , - * ? / L C #

           年(可选)        留空, 1970-2099    , - * /

           注:星期与日期不可同时指定。

            d、cron特殊字符
           *            --->        表示任意
           ?            --->        表示不设置
           -            --->        表达一个范围
           ,            --->        表达一个列表值
           /            --->        x/y表达一个等步长序列,x为起始值,y为增量步长值
           L            --->        该字符只在日期和星期字段中使用,代表“Last”的意思
           W            --->        该字符只能出现在日期字段里,表示离该日期最近的工作日
           LW组合            --->        在日期字段可以组合使用LW,它的意思是当月的最后一个工作日
           #            --->        该字符只能在星期字段中使用,表示当月某个工作日:  6#3表示当月的第三个星期五(6表示星期五,#3表示当前的第三个)
           C            --->        该字符只在日期和星期字段中使用,计划所关联的日期,如果日期没有被关联,则相当于日历中所有日期:  5C在日期字段中就相当于日历5日以后的第一天

       (4)、其他 Trigger(不同版本有不同扣展)
            DateIntervalTrigger                            --->        日期间隔触发的Trigger

    4、JOB 接口                                    --->        调度任务接口
       (1)、作用
            触发器在被触发后进行的操作,可以指定任意一个类的某个方法。

       (2)、JobExecutionContext
            JOB上下文,保存着Trigger、 JobDetail 等信息

       (3)、定义的方法
            public void execute(JobExecutionContext context) throws JobExecutionException;

       (4)、JobDetail
            a、作用
           描述Job的实现类及其它相关的静态信息。
           
            b、原理(看参见 "一、3、(3)")
           Quartz在每次执行Job时,都重新创建一个Job实例,所以它不直接接受一个Job的实例,相反它接收一个Job实现类,以便运行时通过newInstance()的反射机制实例化Job

            c、作用
           JobDetail不存储Job的实例,但它允许你定义一个实例,JobDetail 又指向JobDataMap

           JobDetail持有Job的详细信息,如它所属的组,名称等信息

       (4)、JobDataMap
            a、作用
           保存着任务实例的对象,并保持着他们状态信息,它是Map接口的实现,即你可以往里面put和get一些你想存储和获取的信息.

            b、使用
           JobDataMap jobDataMap = context.getJobDetail().getJobDataMap();

           注: 在Quartz 1.5之后,JobDataMap在 Trigger 级也是可用的。
               实际使用中trigger级别有时取不到map中的值, 使用getMergedJobDataMap 可以获取到

       (5)、StatefulJob
            a、作用
           代表有状态的任务,该接口是一个没有方法的标签接口,其目的是让Quartz知道任务的类型,以便采用不同的执行方案。
           
            b、与Job的区分
           无状态任务在执行时拥有自己的JobDataMap拷贝,对JobDataMap的更改不会影响下次的执行。

           有状态任务共享同一个JobDataMap实例,每次任务执行对JobDataMap所做的更改会保存下来,后面的执行可以看到这个更改,也即每次执行任务后都会对后面的执行发生影响。

           无状态的Job可以并发执行,而有状态的StatefulJob不能并发执行: 如果前次的StatefulJob还没有执行完毕,下一次的任务将阻塞等待,直到前次任务执行完毕。

       (6)、原生Job实现
            org.quartz.jobs.FileScanJob                        --->        检查某个指定文件是否变化,并在文件被改变时通知到相应监听器的 Job
            org.quartz.jobs.FileScanListener                    --->        在文件被修改后通知 FileScanJob 的监听器
            org.quartz.jobs.NativeJob                        --->        用来执行本地程序(如 windows 下 .exe 文件) 的 Job
            org.quartz.jobs.NoOpJob                        --->        什么也不做。一些用户甚至仅仅用它来导致一个监听器的运行
            org.quartz.jobs.ee.mail.SendMailJob                    --->        使用 JavaMail API 发送 e-mail 的 Job
            org.quartz.jobs.ee.jmx.JMXInvokerJob                --->        调用 JMX bean 上的方法的 Job
            org.quartz.jobs.ee.ejb.EJBInvokerJob                --->        用来调用 EJB 上方法的 Job
       
       注:一个job可以对应多个Trgger , 一个Trigger只能对应一个job .



版权声明:本文为博主原创文章,未经博主允许不得转载。

Quartz定时器快速入门学习(二)

在上一节中我们学习了手工方式创建定时器任务,接下来我们学习另外两种方式。          1. 第二种方式:通过吧job,trigger编写在配置文件quarz.properties和jobs.x...

quartz1.8+jdk1.5入门学习

今天项目要做一个功能,每天晚上在1点,自动读取另一台服务器上的数据;由于不想使用timer,听说quartz不错,不会正好学习一下,咋的,用用呗!孩儿立志出乡关,代码不成誓不还!遥问洒家何时睡,每天都...

Quartz.NET学习系列(一)--- 快速入门

Quartz.NET是一个任务调度的开源框架,官网地址是http://www.quartz-scheduler.net/index.html 帮助文档地址是http://www.quartz-sche...
  • Eye_cng
  • Eye_cng
  • 2015年03月14日 17:08
  • 1783

Quartz框架入门学习(一)

Quartz的使用

quartz入门学习(二)

可重复执行的scheduler,使用simpleTrigger,由于其他代码相同,在这里指给出quartzClass的java代码: quartzClass.java: public cl...

quartz学习入门(一)

第一个最简单的Quartz demo

quartz scheduler 入门教程

  • 2015年07月08日 19:32
  • 25KB
  • 下载

Quartz入门案例

  • 2015年08月12日 22:04
  • 1.32MB
  • 下载

Quartz任务调度快速入门

转载文章, 阅读原文 概述 了解Quartz体系结构 Quartz对任务调度的领域问题进行了高度的抽象,提出了调度器、任务和触发器这3个核心的概念,并在org...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:quartz学习一--入门
举报原因:
原因补充:

(最多只允许输入30个字)