Quartz 企业级任务调度框架（三）之快速开始指南

最新推荐文章于 2024-03-31 19:12:22 发布

yx1166

最新推荐文章于 2024-03-31 19:12:22 发布

阅读量266

点赞数

分类专栏： Quartz 任务调度框架

本文链接：https://blog.csdn.net/yx1166/article/details/79445405

版权

Quartz 任务调度框架专栏收录该内容

6 篇文章 3 订阅

订阅专栏

下载和安装

首先，下载最新的稳定版本-注册不是必需的。解压缩并安装它，以便应用程序可以看到它。

Quartz JAR Files

Quartz包中包含许多jar文件，位于根目录中。主库命名为quartz-xxx.jar（其中xxx是版本号）。为了使用任何Quartz的功能，这个jar必须位于应用程序的classpath。

下载了Quartz，把它解压到某个地方，抓住quartz-xxx.jar并把它放在你想要的地方。

我主要在应用程序服务器环境中使用Quartz，所以我的首选是将Quartz JAR包含在我的企业应用程序（.ear或.war文件）中。然而，如果您想让Quartz对许多应用程序可用，那么只需确保它位于应用程序服务器的classpath中即可。如果您正在创建一个独立的应用程序，请将其放在应用程序的类路径中，同时应用程序依赖于其他所有JAR。

Quartz依赖于包含在'lib'目录中的.zip文件中的许多第三方库（以jar的形式）。要使用Quartz的所有功能，所有这些jar都必须存在于你的classpath中。如果你正在构建一个独立的Quartz应用程序，我建议你将它们全部添加到classpath中。如果您在应用服务器环境中使用Quartz，那么至少有一些jar可能已经存在于classpath中，所以您可以负担得起（如果您想要）对包含哪些jar的更多选择。

注意：在应用程序服务器环境中，当意外地包含同一个jar的两个不同版本时，要谨防出现奇怪的结果。

例如，WebLogic包含J2EE（在weblogic.jar中）的实现，它可能与servlet.jar中的不同。在这种情况下，通常最好将servlet.jar放在应用程序之外，以便知道正在使用哪些类。

Properties File

Quartz使用名为quartz.properties的属性文件。一开始这不是必需的，但是除了最基本的配置之外，它必须位于classpath中。

其次，根据我的个人情况举例说明，我的应用程序是使用WebLogic Workshop开发的。我将所有配置文件（包括quartz.properties）都保存在我的应用程序根目录下的项目中。当我将所有东西打包成一个.ear文件时，config项目被打包成一个.jar文件，它包含在最终的.ear文件中。这会自动将quartz.properties放在classpath中。

如果您正在构建包含Quartz的Web应用程序（即以.war文件的形式），那么您可能需要将quartz.properties文件放在WEB-INF / classes文件夹中，以便它位于类路径。

配置

这是最重要的！ Quartz是一个非常可配置的应用程序。配置Quartz的最好方法是编辑quartz.properties文件，并将其放置在应用程序的类路径中（请参阅上面的安装部分）。

Quartz发行版中有几个示例属性文件，特别是在examples /目录下。我建议你创建自己的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个作业。
org.quartz.jobStore.class - 所有Quartz的数据，例如任务和触发器的细节，都保存在内存中（而不是数据库中）。即使你有一个数据库并希望在Quartz中使用它，我建议你在使用数据库打开一个全新的维度之前，先让Quartz使用RamJobStore。

开始一个示例程序

现在您已经下载并安装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();
          }
      }
  }

注意：一旦使用StdSchedulerFactory.getDefaultScheduler（）获得调度程序后，在您调用scheduler.shutdown（）之前，您的应用程序不会终止，因为会有活动的线程。

请注意代码示例中的静态导入;这些将在下面的代码示例中发挥作用。

如果您尚未设置日志记录，则所有日志都将被发送到控制台，并且您的输出将如下所示：

[INFO] 21 Jan 08:46:27.857 AM main [org.quartz.core.QuartzScheduler]
Quartz Scheduler v.2.0.0-SNAPSHOT created.

[INFO] 21 Jan 08:46:27.859 AM main [org.quartz.simpl.RAMJobStore]
RAMJobStore initialized.

[INFO] 21 Jan 08:46:27.865 AM main [org.quartz.core.QuartzScheduler]
Scheduler meta-data: Quartz Scheduler (v2.0.0) 'Scheduler' with instanceId 'NON_CLUSTERED'
  Scheduler class: 'org.quartz.core.QuartzScheduler' - running locally.
  NOT STARTED.
  Currently in standby mode.
  Number of jobs executed: 0
  Using thread pool 'org.quartz.simpl.SimpleThreadPool' - with 50 threads.
  Using job-store 'org.quartz.simpl.RAMJobStore' - which does not support persistence. and is not clustered.


[INFO] 21 Jan 08:46:27.865 AM main [org.quartz.impl.StdSchedulerFactory]
Quartz scheduler 'Scheduler' initialized from default resource file in Quartz package: 'quartz.properties'

[INFO] 21 Jan 08:46:27.866 AM main [org.quartz.impl.StdSchedulerFactory]
Quartz scheduler version: 2.0.0

[INFO] 21 Jan 08:46:27.866 AM main [org.quartz.core.QuartzScheduler]
Scheduler Scheduler_$_NON_CLUSTERED started.

[INFO] 21 Jan 08:46:27.866 AM main [org.quartz.core.QuartzScheduler]
Scheduler Scheduler_$_NON_CLUSTERED shutting down.

[INFO] 21 Jan 08:46:27.866 AM main [org.quartz.core.QuartzScheduler]
Scheduler Scheduler_$_NON_CLUSTERED paused.

[INFO] 21 Jan 08:46:27.867 AM main [org.quartz.core.QuartzScheduler]
Scheduler Scheduler_$_NON_CLUSTERED shutdown complete.

为了做一些有趣的事情，你需要编写在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）调用）。现在去享受一些乐趣吧！

注意：本文中的classpath可能是应用程序根目录的意思，但我也不太确定，有待验证！

Quartz JavaDoc

http://www.quartz-scheduler.org/api/2.2.1/index.html

参考地址：

http://www.quartz-scheduler.org/documentation/quartz-2.2.x/quick-start.html