quarzt(官方)---给自己看的文档(下载和安装)

官方路径:http://www.quartz-scheduler.org/documentation/quartz-2.2.x/quick-start.html

下载并安装

首先, 下载最新的稳定版本 - 不需要注册。 打开发行版的包装并安装它,以便您的应用程序可以看到它。

Quartz JAR文件

Quartz软件包包含许多jar文件,位于分发根目录下。 主Quartz库名为quartz-xxx.jar(其中xxx是版本号)。 为了使用任何Quartz的功能,该jar必须位于应用程序的类路径上。

一旦你下载了Quartz,就将其解压缩到一个地方,抓住quartz-xxx.jar并把它放在你想要的地方。 (如果您需要有关如何解压缩文件的信息,请在离开开发环境或互联网附近的任何地方学习,严肃地说。)

我主要在应用程序服务器环境中使用Quartz,所以我喜欢将Quartz JAR包含在我的企业应用程序(.ear或.war文件)中。 但是,如果要将Quartz提供给许多应用程序,那么只需确保它位于应用程序服务器的类路径上。 如果您正在制作一个独立的应用程序,请将其放置在应用程序的类路径中,以及应用程序所依赖的所有其他JAR。

Quartz取决于许多第三方库(以jar的形式),它们包含在'lib'目录中的发行版.zip文件中。 要使用Quartz的所有功能,所有这些jar都必须存在于您的类路径上。 如果您正在构建一个独立的Quartz应用程序,我建议您只需将它们全部添加到类路径中。 如果您在应用服务器环境中使用Quartz,至少有一些jar可能已经存在于类路径中,因此您可以负担(如果您愿意)对包含哪些jar有更多的选择性。

在appserver环境中,当意外包含同一个jar的两个不同版本时,请小心奇怪的结果。 例如,WebLogic包括J2EE(在weblogic.jar中)的实现,它可能与servlet.jar中的不同。 在这种情况下,通常最好将servlet.jar从您的应用程序中删除,因此您知道正在使用哪些类。

属性文件

Quartz使用一个属性文件(原创性),即quartz.properties。 首先这不是必需的,但是除了最基本的配置之外,它必须位于你的类路径上。

再次,为了给出一个基于我个人情况的例子,我的应用程序是使用WebLogic Workshop开发的。 我将我的所有配置文件(包括quartz.properties)保存在我应用程序根目录下的一个项目中。 当我将所有内容打包成一个.ear文件时,配置项目将被打包成一个.jar,它包含在最后的.ear文件中。 这将自动将quartz.properties放在类路径上。

如果您正在构建包含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一起使用它,我建议你在使用数据库打开一个全新的维度之前,通过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)调用)。

posted @ 2017-03-22 15:16  liutiantian  阅读(432)  评论(0编辑  收藏  举报