官方路径:http://www.quartz-scheduler.org/documentation/quartz-2.2.x/quick-start.html
下载并安装
首先, 下载最新的稳定版本 - 不需要注册。 打开发行版的包装并安装它,以便您的应用程序可以看到它。
Quartz JAR文件
主Quartz库名为quartz-xxx.jar(其中xxx是版本号)。 为了使用任何Quartz的功能,该jar必须位于应用程序的类路径上。
一旦你下载了Quartz,就将其解压缩到一个地方,抓住quartz-xxx.jar并把它放在你想要的地方。 (如果您需要有关如何解压缩文件的信息,请在离开开发环境或互联网附近的任何地方学习,严肃地说。)
我主要在应用程序服务器环境中使用Quartz,所以我喜欢将Quartz JAR包含在我的企业应用程序(.ear或.war文件)中。 但是,如果要将Quartz提供给许多应用程序,那么只需确保它位于应用程序服务器的类路径上。 如果您正在制作一个独立的应用程序,请将其放置在应用程序的类路径中,以及应用程序所依赖的所有其他JAR。
要使用Quartz的所有功能,所有这些jar都必须存在于您的类路径上。 如果您正在构建一个独立的Quartz应用程序,我建议您只需将它们全部添加到类路径中。 如果您在应用服务器环境中使用Quartz,至少有一些jar可能已经存在于类路径中,因此您可以负担(如果您愿意)对包含哪些jar有更多的选择性。
在appserver环境中,当意外包含同一个jar的两个不同版本时,请小心奇怪的结果。 例如,WebLogic包括J2EE(在weblogic.jar中)的实现,它可能与servlet.jar中的不同。 在这种情况下,通常最好将servlet.jar从您的应用程序中删除,因此您知道正在使用哪些类。
属性文件
首先这不是必需的,但是除了最基本的配置之外,它必须位于你的类路径上。
再次,为了给出一个基于我个人情况的例子,我的应用程序是使用WebLogic Workshop开发的。 我将我的所有配置文件(包括quartz.properties)保存在我应用程序根目录下的一个项目中。 当我将所有内容打包成一个.ear文件时,配置项目将被打包成一个.jar,它包含在最后的.ear文件中。 这将自动将quartz.properties放在类路径上。
如果您正在构建包含Quartz的Web应用程序(即.war文件的形式),则可能希望将quartz.properties文件放在WEB-INF / classes文件夹中,以使其在类路径。
组态
这是大点! 配置Quartz的最佳方法是编辑一个quartz.properties文件,并将其放在应用程序的类路径中(参见上面的安装部分)。
我建议您创建自己的quartz.properties文件,而不是制作一个示例的副本,并删除不需要的位。 这样比较简单,您将会更多地了解Quartz提供的功能。
Quartz Configuration Reference中提供了可用属性的完整文档 。
要快速起床和运行,一个基本的quartz.properties看起来像这样:
org.quartz.scheduler.instanceName = MyScheduler org.quartz.threadPool.threadCount = 3 org.quartz.jobStore.class = org.quartz.simpl.RAMJobStore
- org.quartz.scheduler.instanceName - 此调度程序的名称将为“MyScheduler”。
- org.quartz.threadPool.threadCount - 线程池中有3个线程,这意味着最多可以同时运行3个作业。
- 即使你有一个数据库,并希望与Quartz一起使用它,我建议你在使用数据库打开一个全新的维度之前,通过RamJobStore获得Quartz。
启动示例应用程序
现在,您已经下载并安装了Quartz,现在是开始运行示例应用程序的时候了。 以下代码获取调度程序的一个实例,启动它,然后关闭它:
QuartzTest.java
import org.quartz.Scheduler; import org.quartz.SchedulerException; import org.quartz.impl.StdSchedulerFactory; import static org.quartz.JobBuilder.*; import static org.quartz.TriggerBuilder.*; import static org.quartz.SimpleScheduleBuilder.*; public class QuartzTest { public static void main(String[] args) { try { // Grab the Scheduler instance from the Factory Scheduler scheduler = StdSchedulerFactory.getDefaultScheduler(); // and start it off scheduler.start(); scheduler.shutdown(); } catch (SchedulerException se) { se.printStackTrace(); } } }
注意代码示例中的静态导入; 这些将在下面的代码示例中发挥作用。
如果您尚未设置日志记录,则所有日志将发送到控制台,并且输出将如下所示:
[INFO] 21 Jan 08:46:27.857 AM main [org.quartz.core.QuartzScheduler]
Quartz Scheduler v.2.0.0-SNAPSHOT创建。
[INFO] 21 Jan 08:46:27.859 AM main [org.quartz.simpl.RAMJobStore]
RAMJobStore已初始化。
[INFO] 21 Jan 08:46:27.865 AM main [org.quartz.core.QuartzScheduler]
调度器元数据:Quartz Scheduler(v2.0.0)'Scheduler'with instanceId'NON_CLUSTERED' 计划程序类:'org.quartz.core.QuartzScheduler' - 在本地运行。 没有开始。 当前处于待机模式。 执行的作业数量:0 使用线程池'org.quartz.simpl.SimpleThreadPool' - 有50个线程。 使用job-store'org.quartz.simpl.RAMJobStore' - 它不支持持久性。 并且不聚簇。 [INFO] 21 Jan 08:46:27.865 AM main [org.quartz.impl.StdSchedulerFactory] Quartz调度程序“Scheduler”从Quartz包中的默认资源文件初始化:'quartz.properties' [INFO] 21 Jan 08:46:27.866 AM main [org.quartz.impl.StdSchedulerFactory] Quartz调度器版本:2.0.0 [INFO] 21 Jan 08:46:27.866 AM main [org.quartz.core.QuartzScheduler] 计划程序调度程序_ $ _ NON_CLUSTERED已启动。 [INFO] 21 Jan 08:46:27.866 AM main [org.quartz.core.QuartzScheduler] Scheduler Scheduler _ $ _NON_CLUSTERED关闭。 [INFO] 21 Jan 08:46:27.866 AM main [org.quartz.core.QuartzScheduler] 计划程序计划程序_ $ _ NON_CLUSTERED已暂停。 [INFO] 21 Jan 08:46:27.867 AM main [org.quartz.core.QuartzScheduler] 调度程序调度程序_ $ _ NON_CLUSTERED关闭完成。
要做一些有趣的事情,你需要在start()和shutdown()调用之间的代码。
// define the job and tie it to our HelloJob class
JobDetail job = newJob(HelloJob.class) .withIdentity("job1", "group1") .build(); // Trigger the job to run now, and then repeat every 40 seconds Trigger trigger = newTrigger() .withIdentity("trigger1", "group1") .startNow() .withSchedule(simpleSchedule() .withIntervalInSeconds(40) .repeatForever()) .build(); // Tell quartz to schedule the job using our trigger scheduler.scheduleJob(job, trigger);
(您还需要在调用shutdown()之前,稍等一段时间才能触发并执行作业。对于一个简单的例子,您可能只想添加一个Thread.sleep(60000)调用)。