quartz

quartz

1、 quartz

1. 基本概念

quartz定时任务必须搞清楚几个概念：

调度器：负责调度作业和触发器；

触发器：设置作业执行的时间、参数、条件等；（简单触发器和Cron触发器）

作业：定时任务内容，被执行的程序；

JobDetail——处理类

Trigger——触发器，指定触发时间，必须要有JobDetail属性，即触发对象

Scheduler——调度器，组织处理类和触发器，配置方式一般只需指定触发器（因为触发器已经指定了对应的处理类），代码方式则需同时指定触发对象和触发器。

代码方式中，quartz2.x一般都是用相应工厂类来建立JobDetail和Trigger的。

一般来说，任务调度有2中方法，一种是只把Job定义为一个普通类，但同时在配置文件中必须指定targetObject和属性。

 

1 、JobDetail ： JobDetail 是一个具体的类。

 2、Trigger ：触发器，它用于定义 Job 何时执行。最常用的是 SimpleTrigger 和 CronTrigger 。一般来说，如果你需要在一个固定的时间和重复次数或者一个固定的间隔时间，那么 SimpleTrigger 比较合适；如果你有许多复杂的作业调度，那么 CronTrigger 比较合适。CronTrigger 和 Unix 的 cron 机制基本一样，我们需要的只是一个 cron 表达式。比如“ 0 0 12 * * ? ”会在每天中午 12 点触发 执行；“ 0 15 10 ? * 6L ”会在每个月的最后一个星期五的早上 10:15 触发 Job 执行。

   3、 Scheduler 和 SchedulerFactory ： Scheduler 负责管理 Trigger 、调度 Job ， SchedulerFactory 则是 Scheduler 工厂，负责生成Scheduler 。

2. Trigger

Quartz 提供了四种类型的 Trigger，但其中两种是最为常用的，分别是下面的两种：SimpleTrigger 和 CronTrigger.
    SimpleTrigger 是两个之中简单的那个，它主要用来激发单事件的 Job，Trigger 在指定时间激发，并重复 n 次--两次激发时间之间的延时为 m，然后结束作业。

CronTrigger 非常复杂且强大。它是基于通用的公历，当需要用一种较复杂的时间表去执行一个 Job 时用到。

3. Job

Job 重大区别就是：两个或多个有状态的 JobDetail 实例不能并发执行。说的是你创建并注册了一个有状态 JobDetail 到 Scheduler 上。你还建立了两个 Trigger 来触发这个 Job：一个每五分钟触发，另一个也是每五分钏触发。假如这两个 Trigger 试图在同一时刻触发 Job，框架是不允许这种事情发生的。第二个 Trigger 一直会被阻塞直到第一个结束。

4、监听器

Quartz 提供了三种类型的监听器：监听 Job 的，监听 Trigger 的，和监听 Scheduler 自已的。

可以分成以下步骤：
1. 创建一个 Java 类，实现监听器接口
2. 用你的应用中特定的逻辑实现监听器接口的所有方法
3. 注册监听器

JobListener 和 TriggerListener 可被注册为全局或非全局监听器。一个全局监听器能接收到所有的 Job/Trigger 的事件通知。而一个非全局监听器(或者说是一个标准的监听器) 只能接收到那些在其上已注册了监听器的 Job 或 Triiger 的事件。

一、 监听 Job 事件
org.quartz.JobListener 接口包含一系列的方法，它们会由 Job 在其生命周期中产生的某些关键事件时被调用。JobListener分为全局监听和局部监听，具体实现如下：

全局：JobListener jobListener = new SimpleJobListener("SimpleJobListener");         
      scheduler.addGlobalJobListener(jobListener);         
      scheduler.start();

局部：JobListener jobListener =new SimpleJobListener("SimpleJobListener");            
      scheduler.addJobListener(jobListener);                    
      jobDetail.addJobListener(jobListener.getName());               
      scheduler.scheduleJob(jobDetail, trigger);           
      scheduler.start();

注意注册的方法，另外对于非全局的 JobListener，它应于任何引用到它的 JobDetail 使用 schedulerJob() 或 addJob() 方法注册之前被注册。

二、监听 Trigger 事件

org.quartz.TriggerListener 接口也包含一系列给 Scheduler 调用的方法。然而，与 JobListener 有所不同的是，TriggerListener 接口还有关于 Trigger 实例生命周期的方法。

监听的实现和job的监听基本差不多，对于全局和局部说明：

scheduler.addGlobalTriggerListener(new SimpleMyTriggerListener()); 和

scheduler.addTriggerListener( triggerListener );

对于局部监听要注意是的对特定的trigger.addTriggerListener( triggerListener.getName() );

添加监听，注意名字要监听器的名称要相同。

和非全局的 JobListener 提到的相同的警告可以应用到这里来；你必须在把它设置给 Trigger 实例并存储了 Trigger 之前把TriggerListener 加入到 Scheduler 中。

三、 监听 Scheduler 事件

org.quartz.SchedulerListener 接口包含了一系列的回调方法，它们会在 Scheduler 的生命周期中有关键事件发生时被调用。

public void startScheduler() throws SchedulerException {          
Scheduler scheduler = null;          
scheduler = StdSchedulerFactory.getDefaultScheduler();          
//添加监听
SchedulerListener schedulerListener = new SimpleSchedulerListener();         
scheduler.addSchedulerListener(schedulerListener);         
scheduler.start();         
//注册作业和触发器        
JobDetail jobDetail = new JobDetail("PrintInfoJob",Scheduler.DEFAULT_GROUP, MyJob.class);          
Trigger trigger = TriggerUtils.makeSecondlyTrigger(5);          
trigger.setName("SimpleTrigger");         
trigger.setStartTime(new Date());          
scheduler.scheduleJob(jobDetail, trigger);      
} 
在代码中，Scheduler 创建后是在 Job 注册之前被启动的。这就使得在 Job 部署时 jobScheduled() 方法能得到调用。我们也改变了 Trigger 只重复两次而不是无限的运行。这样能强制 triggerFinalized() 方法被调用，因为这个 Trigger 不再有机会触发了。除了这些人为的条件外，使用 SchedulerListener 就和使用 Job 或 Trigger 监听器是一样的了。

4. quartz的jar包

Quartz  下载地址 ：

          http://grepcode.com/snapshot/repo1.maven.org/maven2/org.quartz-scheduler/quartz/1.7.3

5. 表达式

字段名   允许的值   允许的特殊字符

 

秒 

 

0-59 

 

, - * / 

分 

 

0-59 

 

, - * / 

小时 

 

0-23 

 

, - * / 

日 

 

1-31 

 

, - * ? / L W C 

月 

 

1-12 or JAN-DEC 

 

, - * / 

周几 

 

1-7 or SUN-SAT 

 

, - * ? / L C # 

年 (可选字段) 

 

empty, 1970-2099 

 

, - * / 

 

'*' 字符可以用于所有字段，在“分”字段中设为"*"表示"每一分钟"的含义。

'?' 字符可以用在“日”和“周几”字段. 它用来指定 '不明确的值'. 这在你需要指定这两个字段中的某一个值而不是另外一个的时候会被用到。在后面的例子中可以看到其含义。

'-' 字符被用来指定一个值的范围，比如在“小时”字段中设为"10-12"表示"10点到12点".

',' 字符指定数个值。比如在“周几”字段中设为"MON,WED,FRI"表示"the days Monday, Wednesday, and Friday".

'/' 字符用来指定一个值的的增加幅度. 比如在“秒”字段中设置为"0/15"表示"第0, 15, 30, 和 45秒"。而 "5/15"则表示"第5, 20, 35, 和 50". 在'/'前加"*"字符相当于指定从0秒开始. 每个字段都有一系列可以开始或结束的数值。对于“秒”和“分”字段来说，其数值范围为0到59，对于“小时”字段来说其为0到23, 对于“日”字段来说为0到31, 而对于“月”字段来说为1到12。"/"字段仅仅只是帮助你在允许的数值范围内从开始"第n"的值。 因此对于“月”字段来说"7/6"只是表示7月被开启而不是“每六个月”, 请注意其中微妙的差别。

'L'字符可用在“日”和“周几”这两个字段。它是"last"的缩写, 但是在这两个字段中有不同的含义。例如,“日”字段中的"L"表示"一个月中的最后一天" —— 对于一月就是31号对于二月来说就是28号（非闰年）。而在“周几”字段中, 它简单的表示"7" or "SAT"，但是如果在“周几”字段中使用时跟在某个数字之后, 它表示"该月最后一个星期×" —— 比如"6L"表示"该月最后一个周五"。当使用'L'选项时,指定确定的列表或者范围非常重要，否则你会被结果搞糊涂的。

'W' 可用于“日”字段。用来指定历给定日期最近的工作日(周一到周五) 。比如你将“日”字段设为"15W"，意为: "离该月15号最近的工作日"。因此如果15号为周六，触发器会在14号即周五调用。如果15号为周日, 触发器会在16号也就是周一触发。如果15号为周二,那么当天就会触发。然而如果你将“日”字段设为"1W", 而一号又是周六, 触发器会于下周一也就是当月的3号触发,因为它不会越过当月的值的范围边界。'W'字符只能用于“日”字段的值为单独的一天而不是一系列值的时候。

'L'和'W'可以组合用于“日”字段表示为'LW'，意为"该月最后一个工作日"。

'#' 字符可用于“周几”字段。该字符表示“该月第几个周×”，比如"6#3"表示该月第三个周五( 6表示周五而"#3"该月第三个)。再比如: "2#1" = 表示该月第一个周一而 "4#5" = 该月第五个周三。注意如果你指定"#5"该月没有第五个“周×”，该月是不会触发的。

'C' 字符可用于“日”和“周几”字段，它是"calendar"的缩写。它表示为基于相关的日历所计算出的值（如果有的话）。如果没有关联的日历, 那它等同于包含全部日历。“日”字段值为"5C"表示"日历中的第一天或者5号以后"，“周几”字段值为"1C"则表示"日历中的第一天或者周日以后"。

对于“月份”字段和“周几”字段来说合法的字符都不是大小写敏感的。

下面是一些完整的例子:

表达式   含义

 

"0 0 12 * * ?" 

 

每天中午十二点触发 

"0 15 10 ? * *" 

 

每天早上10：15触发 

"0 15 10 * * ?" 

 

每天早上10：15触发 

"0 15 10 * * ? *" 

 

每天早上10：15触发 

"0 15 10 * * ? 2005" 

 

2005年的每天早上10：15触发 

"0 * 14 * * ?" 

 

每天从下午2点开始到2点59分每分钟一次触发

"0 0/5 14 * * ?" 

 

每天从下午2点开始到2：55分结束每5分钟一次触发

"0 0/5 14,18 * * ?" 

 

每天的下午2点至2：55和6点至6点55分两个时间段内每5分钟一次触发

"0 0-5 14 * * ?" 

 

每天14:00至14:05每分钟一次触发

"0 10,44 14 ? 3 WED" 

 

三月的每周三的14：10和14：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" 

 

每月最后一个周五的10：15触发

"0 15 10 ? * 6L 2002-2005" 

 

2002年至2005年的每月最后一个周五的10：15触发

"0 15 10 ? * 6#3" 

 

每月的第三个周五的10：15触发

 

  以上例子都是我的现实项目改过来的。。。经过测试的。。O(∩_∩)O哈哈哈~

 

"30 * * * * ?" 每半分钟触发任务

"30 10 * * * ?" 每小时的10分30秒触发任务

"30 10 1 * * ?" 每天1点10分30秒触发任务

"30 10 1 20 * ?" 每月20号1点10分30秒触发任务

"30 10 1 20 10 ? *" 每年10月20号1点10分30秒触发任务

"30 10 1 20 10 ? 2011" 2011年10月20号1点10分30秒触发任务

"30 10 1 ? 10 * 2011" 2011年10月每天1点10分30秒触发任务

"30 10 1 ? 10 SUN 2011" 2011年10月每周日1点10分30秒触发任务

"15,30,45 * * * * ?" 每15秒，30秒，45秒时触发任务

"15-45 * * * * ?" 15到45秒内，每秒都触发任务

"15/5 * * * * ?" 每分钟的每15秒开始触发，每隔5秒触发一次

"15-30/5 * * * * ?" 每分钟的15秒到30秒之间开始触发，每隔5秒触发一次

"0 0/3 * * * ?" 每小时的第0分0秒开始，每三分钟触发一次

"0 15 10 ? * MON-FRI" 星期一到星期五的10点15分0秒触发任务

"0 15 10 L * ?" 每个月最后一天的10点15分0秒触发任务

"0 15 10 LW * ?" 每个月最后一个工作日的10点15分0秒触发任务

"0 15 10 ? * 5L" 每个月最后一个星期四的10点15分0秒触发任务

"0 15 10 ? * 5#3" 每个月第三周的星期四的10点15分0秒触发任务

 

2、定时器的启动和实现

参考：http://seanhe.iteye.com/blog/691835
参考这张图，首先quartz的加载可以有两种方式：
方式1：通过servlet，参考：http://blog.csdn.net/ychatou1220/article/details/5806914
方式2：通过spring，例如：

点击(此处)折叠或打开

1. <bean id="scheduler" class="org.springframework.scheduling.quartz.SchedulerFactoryBean">

2.         <property name="dataSource">

3.             <ref bean="scheduleDataSource" />

4.         </property>

5.         <property name="autoStartup" value="true" />

6.         <property name="schedulerFactoryClass" value="org.quartz.impl.StdSchedulerFactory"></property>

7.         <property name="configLocation" value="classpath:quartz.properties" />

8.         <property name="globalJobListeners">

9.             <list>

10.                 <ref bean="jobListener" />

11.             </list>

12.         </property>

13.     </bean>

SpringContext在加载SchedulerFactoryBean时会去加载他的afterPropertiesSet方法。而SchedulerFactoryBean会去与quartz的StdSchedulerFactory交互初使化配置，StdSchedulerFactory会create类QuartzScheduler
QuartzScheduler，QuartzScheduler会启动总控制线程QuartzSchedulerThread不停的轮循。

 

 

3、调度器、执行器、作业调的包

org.springframework.scheduling.quartz.SchedulerFactoryBean

org.springframework.scheduling.quartz.CronTriggerBean

org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean

4、代码实现

1. Scheduler scheduler = StdSchedulerFactory.getDefaultScheduler();  

2. JobDetail jobDetail = JobBuilder.newJob(Job.class)  

3.                     .setJobData(new JobDataMap(Map map)).build();  

4. 

5.                       //在某一时刻触发  

6.             Trigger trigger = TriggerBuilder.newTrigger().startAt(Date date).build();  

7.                    //在指定cron表达式的时间点触发  

8. //      Trigger trigger = TriggerBuilder.newTrigger()  

9. //              .withSchedule(CronScheduleBuilder.cronSchedule(String cron)).build();  

10.                       //调度器将任务类与触发器关联  

11.             scheduler.scheduleJob(jobDetail, trigger);  

12.             scheduler.start();