当前位置：文档之家 › Quartz的使用说明

Quartz的使用说明

  • 格式：doc
  • 大小：58.50 KB
  • 文档页数：6

Quartz的使用说明Quartz是一个完全由java编写的开源作业调度框架,具体的介绍可到/quartz/官方网站查看。

Quartz的几个核心的接口和类为：Job接口：自己写的"定时程序"实现此接口的voidexecute(JobExecutionContext arg0)方法,Job还有一类为有状态的StatefulJob接口，如果我们需要在上一个作业执行完后，根据其执行结果再进行下次作业的执行，则需要实现此接口。

Trigger抽象类：调度类(Scheduler)在时间到时调用此类，再由trigger类调用指定的定时程序。

Quertz中提供了两类触发器为：SimpleTrigger,CronTrigger。

前者用于实现比较简单的定时功能，例如几点开始，几点结束，隔多长时间执行，共执行多少次等，后者提供了使用表达式来描述定时功能，因此适用于比较复杂的定时描述，例如每个月的最后一个周五，每周的周四等。

JobDetail类：具体某个定时程序的详细描述，包括Name,Group,JobDataMap等。

JobExecutionContext类：定时程序执行的run-time的上下文环境，用于得到当前执行的Job的名字，配置的参数等。

JobDataMap类：用于描述一个作业的参数，参数可以为任何基本类型例如String,float等，也可为某个对象的引用.JobListener,TriggerListener接口：用于监听触发器状态和作业扫行状态，在特写状态执行相应操作。

JobStore类：在哪里执行定进程序，可选的有在内存中，在数据库中。

简单的定时程序：时钟调制类:import org.apache.log4j.Logger;import org.quartz.Scheduler;import org.quartz.SchedulerException;import org.quartz.SchedulerFactory;import org.quartz.impl.StdSchedulerFactory;public class QuartzManage {Logger log = Logger.getLogger(QuartzManage.class);public void startup(){try {log.debug("-----Initializing Scheduler------------"); SchedulerFactory sf = new StdSchedulerFactory();Scheduler sched = sf.getScheduler();sched.start();log.debug("Started Scheduler--------------");} catch (SchedulerException e) {// TODO Auto-generated catch blocke.printStackTrace();}}}实现Job类：import java.util.Date;import org.quartz.JobExecutionContext;import org.quartz.JobExecutionException;import org.quartz.StatefulJob;public class TestJob implements Job {@Overridepublic void execute(JobExecutionContext arg0) throws JobExecutionException {// TODO Auto-generated method stubSystem.out.print("#################33" + new Date());try {Thread.currentThread().sleep(4000);} catch (InterruptedException e) {// TODO Auto-generated catch blocke.printStackTrace();}}}执行上面这个类基本实现了一个简单的定时程序。

但问题是现在这个类只能应用在application中，在web环境里执行还需要添加一些配置,例如添加servlet,添加配置文件quartz.properties或者quartz-job.xml(在ＸＭＬ文件里以配置方式定义 triiger,定时描述等）。

web应用中使用在web.xml中添加QuartzInitializerServlet，Quartz为能够在web应用中使用，提供了一个 QuartzInitializerServlet和一个QuartzInitializerListener，用于在加载web应用时，对quartz 进行初始化。

我在使用servlet时加载成功，在使用listener时不成功，不知道怎么回事？servlet配置：QuartzInitializerorg.quartz.ee.servlet.QuartzInitializerServletshutdown-on-unloadtrueconfig-filequartz.properties2listener配置可以看源码，主要的上面的参数配置为,再加一个.上面提到了quartz.properties,这是自行指定的，Quartz提供了一个默认的配置文件，可以满足基本的j2se应用，如果在 web应用中，我们想把job,trigger 配置都写到文件中，就需要自己来写，并指定在初始化时加载我们自己的quratz.properties，位置放在classes下。

#=================================================================== # Configure Main Scheduler Properties#===================================================================org.quartz.scheduler.instanceName = TestSchedulerorg.quartz.scheduler.instanceId = AUTO#=================================================================== # Configure ThreadPool#===================================================================org.quartz.threadPool.class = org.quartz.simpl.SimpleThreadPoolorg.quartz.threadPool.threadCount = 3org.quartz.threadPool.threadPriority = 5#===================================================================# Configure JobStore#=================================================================== org.quartz.jobStore.misfireThreshold = 60000org.quartz.jobStore.class = org.quartz.simpl.RAMJobStore#=================================================================== # Configure Plugins#=================================================================== org.quartz.plugin.triggHistory.class =org.quartz.plugins.history.LoggingJobHistoryPluginorg.quartz.plugin.jobInitializer.class =org.quartz.plugins.xml.JobInitializationPluginorg.quartz.plugin.jobInitializer.fileNames = quartz_job.xmlorg.quartz.plugin.jobInitializer.overWriteExistingJobs = trueorg.quartz.plugin.jobInitializer.failOnFileNotFound = trueorg.quartz.plugin.jobInitializer.scanInterval = 10org.quartz.plugin.jobInitializer.wrapInUserTransaction = falsequartz要使用插件来加载自己的xml配置文件，上边我们指定了在初始化时加载classes\scheduler\quartz_jobs.xml，默认的是加载classes\quartz_jobs.xml文件。

quartz_jobs.xml文件：<?xml version="1.0" encoding="UTF-8"?><quartz><job><job-detail><name>callJob</name><group>group1</group><job-class>com.hundsun.u3c.podserver.quartz.job.CallJob</job-class> </job-detail><trigger><cron><name>cron2</name><group>group1</group><job-name>callJob</job-name><job-group>group1</job-group><cron-expression>0/3 * * * * ?</cron-expression></cron></trigger></job><job><job-detail><name>callJob2</name><group>group1</group><job-class>com.hundsun.u3c.podserver.quartz.job.CallJob2</job-class> </job-detail><trigger><cron><name>cron3</name><group>group2</group><job-name>callJob2</job-name><job-group>group2</job-group><cron-expression>0/10 * * * * ?</cron-expression></cron></trigger></job></quartz>上面配置了一个作业，并声明一个参数Name；配置了一个CronTrigger,每三秒执行一次。

合集下载

调度任务框架Quart的使用

调度任务框架Quart的使用

Cron表达式Quartz使用类似于Linux下的Cron表达式定义时间规则，Cron表达式由6或7个由空格分隔的时间字段组成，如表1所示：表1 Cron表达式时间字段位置时间域名允许值允许的特殊字符1 秒0-59 , - * /2 分钟0-59 , - * /3 小时0-23 , - * /4 日期1-31 , - * ? / L W C5 月份1-12 , - * /6 星期1-7 , - * ? / L C #7 年(可选) 空值1970-2099 , - * /Cron表达式的时间字段除允许设置数值外，还可使用一些特殊的字符，提供列表、范围、通配符等功能，细说如下：●星号(*)：可用在所有字段中，表示对应时间域的每一个时刻，例如，*在分钟字段时，表示“每分钟”；●问号（?）：该字符只在日期和星期字段中使用，它通常指定为“无意义的值”，相当于点位符；●减号(-)：表达一个范围，如在小时字段中使用“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号星期二。

Quartz中文文档使用

Quartz中文文档使用

Quartz中⽂⽂档使⽤Quartz中⽂使⽤说明⽂档,内容相当详细,有需要的码友们可以看看!!好东西要分享!!下⾯是⽂档的内容⽬录,附上下载的地址:中⽂版⽬录总汇及内容提要第⼀章. 企业应⽤中的作业调度内容提要：什么是作业调度，作业调度为什么说是重要的，企业应⽤中的作业调度，⾮企业应⽤中的作业调度，作业调度与⼯作流，关于作业调度其他可选择⽅案第⼆章. Quartz 起步内容提要：本章对 Quartz 框架⼀个快速的⼊门介绍，同时也⼤略指导你从哪⾥下载，构建和安装这个框架第三章. Hello Quartz (第⼀部分)内容提要：建⽴ Hello Quartz ⼯程，并创建⼀个 Quartz Job 类 ScanDirectoryJob.第三章. Hello Quartz (第⼆部分)内容提要：创建⼀个 Quartz Scheduler，关联上⼀个 Quartz Trigger 以编程⽅式调度前⾯编写的 ScanDirectoryJob 运⾏。

第三章. Hello Quartz (第三部分)内容提要：通过配置 quartz.properties、quartz_jobs.xml 以声明的⽅式调度 ScanDirectoryJob 运⾏。

第三章. Hello Quartz (第四部分)内容提要：让我们最后简单讨论打包⼀个⽤到了 Quarts 框架的应⽤程序的流程，需要依赖于哪些包，也以此来结束本章的内容。

第四章. 部署 Job (第⼀部分)内容提要：介绍 Scheduler 和 SchedulerFactory 有哪些类型、SchedulerFactory 的关键 API ⽅法；以及如何通过 java.util.Properties 实例或默认quartz.properties ⽂件创建 Scheduler。

第四章. 部署 Job (第⼆部分)内容提要：如何管理 Scheduler(启动、停⽌、Standby 模式)。

Quartz开发指南

Quartz开发指南

定时器(Quartz)使用说明本文目前主要包括如下几个部分：Quartz功能简介：介绍Quartz的特点及概念。

使用Quartz的常见问题：很多用户在使用过程中遇到常见问题的解答。

快速开始：让读者尽快掌握Quartz开发。

Quartz官方开发指南：通过一些列的课程来指导如何使用Quartz.Quartz功能简介Quartz特点：z Quartz能嵌入到任何独立的应用中运行。

z Quartz能在应用服务器或者Servlet容器中实例化，并且能够参与XA事务。

z Quartz能够以独立的方式运行（在它自己的Java虚拟机中），可以通过RMI使用Quartz。

z Quartz可以被实例化为独立程序的集群（有负载均衡和容错能力）。

Job Scheduling（任务日程安排）任务在给定的触发器（Trigger）触发时执行。

触发器可以通过几乎以下所有形式的组合方式进行创建：z在一天中的任意时刻（可以精确到毫秒）。

z一周中特定的一些天。

z一个月中特定的一些天。

z一年中特定的一些天z不在日历列表中注册的一些天（比如节假日）。

z循环特定的次数。

z循环到特定的时间。

z无限循环。

z按照一定的时间间隔循环。

“任务”由创建者给定名字，并且可以加入到给定名称的“任务组”中。

为了简化触发器在日程中的管理，“触发器”也可以被给定名字和分组。

任务只能加入到日程中一次，但是可以为其注册多个触发器。

在J2EE环境中，任务可以作为分布(XA)事务的一部分执行。

Job Execution（任务执行）•任务是任何实现简单Job接口的Java 类，这样开发者能够执行任何完成他们工作的任务。

•任务类的实例可以由Quartz实例化，也可以由你的程序框架实例化。

当触发器被触发时，日程管理器将会通知某个或者多个实现了JobListener 或TriggerListener的对象（监听器可以是简单的Java对象，或者EJBs,或者JMS消息发布器，等等）。

Quartz指南

Quartz指南

Quartz指南1 什么是QuartzQuartz是一个作业调度系统（a job scheduling system），Quartz不但可以集成到其他的软件系统中，而且也可以独立运行的；在本文中“job scheduler”的意思是：一个负责在约定的时间到达时执行（或通知）其他软件控件的方法。

Quartz是非常灵活的，为了实现我们的需求Quartz包含了许多可以独立或被集成使用的典型范例，同时使我们编写项目中的代码也觉得很简单自然（natural）。

Quartz是很轻量级的，只需要简单的安装或配置就可以在项目中使用；如果只是相对简单的使用实际上可以直接地使用（out-of-the-box）。

Quartz具有容错性，能够持久化所调度的作业，即在系统重启后也可以继续执行原先未完成的作业。

虽然Quartz对给定的计划可以简单地运行一些系统的处理是很适用的，但只有当我们学习如何使用Quartz去驱动我们的应用业务处理流程时，才能真正的认识到Quartz的全部潜能。

1.1 什么是Quartz－从软件控件的角度Quartz是以.jar文件的形式发布的，Quartz java库中包含了Quartz所有的核心功能，该功能的主要接口（API）是Scheduler接口，Scheduler接口提供了一些简单的操作，如：schedulering/unscheduling jobs，starting/stopping/pausing the scheduler。

如果我们要调度自定义的作业，该作业必须实现Job接口，Job接口包含了一个必须实现的方法：execute(…)；如果我们需要实现当到达被调度的时间能够得到通知，我们必须实现TriggerListener或JobListener接口。

Quartz主要程序不但能够作为独立的应用（带有RMI 接口）运行，也可以作为J2EE组件资源在J2EE应用服务器运行。

2 使用Quartz使用Scheduler前必须实例化Scheduler，需要由SchedulerFactory类来创建Scheduler，Factory 的实例可以通过在JNDI存储中的Factory的序列化的方式来获取，实例化Factory后直接使用该实例也是很容易的，如下面的例子。