【Quartz】Quartz概述及入门实例

林炳文Evankaka原创作品。转载请注明出处http://blog.csdn.net/evankaka

        Quartz 在开源任务调度框架中的翘首，它提供了强大任务调度机制，难能可贵的是它同时保持了使用的简单性。Quartz 允许开发人员灵活地定义触发器的调度时间表，并可以对触发器和任务进行关联映射。
        此外，Quartz提供了调度运行环境的持久化机制，可以保存并恢复调度现场，即使系统因故障关闭，任务调度现场数据并不会丢失。此外，Quartz还提供了组件式的侦听器、各种插件、线程池等功能。

一、Quartz功能概述

Quartz是一个开源的任务调度系统，它能用来调度很多任务的执行。

运行环境

• Quartz 能嵌入在其他应用程序里运行。
• Quartz 能在一个应用服务器里被实例化(或servlet容器), 并且参与XA事务
• Quartz能独立运行（通过JVM）,或者通过RMI
• Quartz能被集群实例化

任务调度

当一个指定给任务的触发器发生时,任务就被调度执行.触发器能被创建为:

• 一天的某个时间(精确到毫秒级)
• 一周的某些天
• 一个月的某些天
• 一年的某些天
• 不在一个Calendar列出的某些天 (例如工作节假日)
• 在一个指定的次数重复
• 重复到一个指定的时间/日期
• 无限重复
• 在一个间隔内重复

能够给任务指定名称和组名.触发器也能够指定名称和组名,这样可以很好的在调度器里组织起来.一个加入到调度器里的任务可以被多个触发器注册。在J2EE环境里，任务能作为一个分布式（XA）事务的一部分来执行。

任务执行

• 任务能够是任何实现Job接口的Java类。
• 任务类能够被Quartz实例化,或者被你的应用框架。
• 当一个触发器触发时，调度器会通知实例化了JobListener 和TriggerListener 接口的0个或者多个Java对象(监听器可以是简单的Java对象, EJBs, 或JMS发布者等). 在任务执行后，这些监听器也会被通知。
• 当任务完成时，他们会返回一个JobCompletionCode ，这个代码告诉调度器任务执行成功或者失败.这个代码 也会指示调度器做一些动作-例如立即再次执行任务。

任务持久化

• Quartz的设计包含JobStore接口，这个接口能被实现来为任务的存储提供不同的机制。
• 应用JDBCJobStore, 所有被配置成“稳定”的任务和触发器能通过JDBC存储在关系数据库里。
• 应用RAMJobStore, 所有任务和触发器能被存储在RAM里因此不必在程序重起之间保存-一个好处就是不必使用数据库。

事务

• 使用JobStoreCMT（JDBCJobStore的子类），Quartz 能参与JTA事务。
• Quartz 能管理JTA事务(开始和提交)在执行任务之间，这样，任务做的事就可以发生在JTA事务里。

集群

• Fail-over.
• Load balancing.

监听器和插件

• 通过实现一个或多个监听接口，应用程序能捕捉调度事件来监控或控制任务/触发器的行为。
• 插件机制可以给Quartz增加功能，例如保持任务执行的历史记录，或从一个定义好的文件里加载任务和触发器。
• Quartz 装配了很多插件和监听器。

二、Quartz体系结构

Quartz对任务调度的领域问题进行了高度的抽象，提出了调度器、任务和触发器这3个核心的概念，并在org.quartz通过接口和类对重要的这些核心概念进行描述：

●Job

       是一个接口，只有一个方法voidexecute(JobExecutionContext context)，开发者实现该接口定义运行任务，JobExecutionContext类提供了调度上下文的各种信息。Job运行时的信息保存在 JobDataMap实例中；

●JobDetail

        Quartz在每次执行Job时，都重新创建一个Job实例，所以它不直接接受一个Job的实例，相反它接收一个Job实现 类，以便运行时通过newInstance()的反射机制实例化Job。因此需要通过一个类来描述Job的实现类及其它相关的静态信息，如Job名字、描 述、关联监听器等信息，JobDetail承担了这一角色。

通过该类的构造函数可以更具体地了解它的功用：JobDetail(Java.lang.String name, java.lang.String group,java.lang.Class jobClass)，该构造函数要求指定Job的实现类，以及任务在Scheduler中的组名和Job名称；

●Trigger

       是一个类，描述触发Job执行的时间触发规则。主要有SimpleTrigger和CronTrigger这两个子类。当仅需触 发一次或者以固定时间间隔周期执行，SimpleTrigger是最适合的选择；而CronTrigger则可以通过Cron表达式定义出各种复杂时间规 则的调度方案：如每早晨9:00执行，周一、周三、周五下午5:00执行等；

●Calendar

       org.quartz.Calendar和java.util.Calendar不同，它是一些日历特定时间点的集合（可以简 单地将org.quartz.Calendar看作java.util.Calendar的集合——java.util.Calendar代表一个日历时间点，无特殊说明后面的Calendar即指org.quartz.Calendar）。一个Trigger可以和多个Calendar关联，以便排除或 包含某些时间点。

假设，我们安排每周星期一早上10:00执行任务，但是如果碰到法定的节日，任务则不执行，这时就需要在Trigger触发机制的基础上使用 Calendar进行定点排除。针对不同时间段类型，Quartz在org.quartz.impl.calendar包下提供了若干个Calendar 的实现类，如AnnualCalendar、MonthlyCalendar、WeeklyCalendar分别针对每年、每月和每周进行定义；

●Scheduler

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

        Scheduler可以将Trigger绑定到某一JobDetail中，这样当Trigger触发时，对应的Job就被执行。一个Job可以对应 多个Trigger，但一个Trigger只能对应一个Job。可以通过SchedulerFactory创建一个Scheduler实例。 Scheduler拥有一个SchedulerContext，它类似于ServletContext，保存着Scheduler上下文信息，Job和 Trigger都可以访问SchedulerContext内的信息。SchedulerContext内部通过一个Map，以键值对的方式维护这些上下文数据，SchedulerContext为保存和获取数据提供了多个put()和getXxx()的方法。可以通过Scheduler# getContext()获取对应的SchedulerContext实例；

三、入门实例

本文工程免费下载

新建一个Java project.

导入相应的包

执行业务逻辑的Job

[java] view plain copy

1. package com.mucfc;  
2. import java.text.SimpleDateFormat;  
3. import java.util.Date;  
4.   
5. import org.quartz.Job;  
6. import org.quartz.JobExecutionContext;  
7. import org.quartz.JobExecutionException;  
8. /**   
9. *Quartz事件类 
10. *作者 林炳文（[e-mail] 博客：http://blog.csdn.net/evankaka）   
11. *时间 2015.4.29 
12. */  
13. public class Quartz implements Job{  
14.     /** 
15.      * 事件类，处理具体的业务 
16.      */  
17.     @Override  
18.     public void execute(JobExecutionContext arg0) throws JobExecutionException {  
19.         System.out.println("Hello quzrtz  "+  
20.         new SimpleDateFormat("yyyy-MM-dd HH:mm:ss ").format(new Date()));  
21.     }  
22.   
23. }  

任务调度

[java] view plain copy

1. package com.mucfc;  
2. import org.quartz.JobBuilder;  
3. import org.quartz.JobDetail;  
4. import org.quartz.Scheduler;  
5. import org.quartz.SchedulerException;  
6. import org.quartz.SimpleScheduleBuilder;  
7. import org.quartz.Trigger;  
8. import org.quartz.TriggerBuilder;  
9. import org.quartz.impl.StdSchedulerFactory;  
10. /**   
11. *Quartz定时执行事件 
12. *作者 林炳文（[e-mail] 博客：http://blog.csdn.net/evankaka）   
13. *时间 2015.4.29 
14. */  
15. public class QuartzTest {  
16.   
17.     public static void main(String[] args) {  
18.         QuartzTest quartzTest=new QuartzTest();  
19.         quartzTest.startSchedule();  
20.   
21.     }  
22.   
23.     public void startSchedule() {  
24.         try {  
25.             // 1、创建一个JobDetail实例，指定Quartz  
26.             JobDetail jobDetail = JobBuilder.newJob(Quartz.class)  
27.             // 任务执行类  
28.             .withIdentity("job1_1", "jGroup1")  
29.             // 任务名，任务组  
30.             .build();     
31.             //2、创建Trigger  
32.             SimpleScheduleBuilder builder=SimpleScheduleBuilder.simpleSchedule()  
33.             //设置间隔执行时间  
34.             .withIntervalInSeconds(5)  
35.             //设置执行次数  
36.             .repeatForever();  
37.             Trigger trigger=TriggerBuilder.newTrigger().withIdentity(  
38.                     "trigger1_1","tGroup1").startNow().withSchedule(builder).build();  
39.             //3、创建Scheduler  
40.             Scheduler scheduler=StdSchedulerFactory.getDefaultScheduler();  
41.             scheduler.start();        
42.             //4、调度执行  
43.             scheduler.scheduleJob(jobDetail, trigger);                
44.             try {  
45.                 Thread.sleep(60000);  
46.             } catch (InterruptedException e) {  
47.                 e.printStackTrace();  
48.             }  
49.    
50.             scheduler.shutdown();  
51.               
52.         } catch (SchedulerException e) {  
53.             e.printStackTrace();  
54.         }  
55.     }  
56. }  

（注意这里，通过静态import，直接就newJob****。）

输出结果：

这里要注意，定时事件不是在主线程中执行的，而是会开另外的线程来执行。并且当主线程休眠1分钟后，会把定时事件给关了，这里即使不会无限执行的事件，也要用shutdown();关闭掉，要不定时事件的线程不会释放资源！

林炳文Evankaka原创作品。转载请注明出处http://blog.csdn.net/evankaka

本文工程免费下载