quartz任务时间调度入门使用

Quartz 是 OpenSymphony 开源组织在任务调度领域的一个开源项目，完全基于 Java 实现。

作为一个优秀的开源调度框架，Quartz 具有以下特点：

1. 强大的调度功能，例如支持丰富多样的调度方法，可以满足各种常规及特殊需求；
2. 灵活的应用方式，例如支持任务和调度的多种组合方式，支持调度数据的多种存储方式；
3. 分布式和集群能力，Terracotta 收购后在原来功能基础上作了进一步提升。本文暂不讨论该部分内容

另外，作为 Spring 默认的调度框架，Quartz 很容易与 Spring 集成实现灵活可配置的调度功能。

下面是本文中用到的一些专用词汇，在此声明：

scheduler：

任务调度器

trigger：

触发器，用于定义任务调度时间规则

job：

任务，即被调度的任务

misfire：

错过的，指本来应该被执行但实际没有被执行的任务调度

1、首先下载一份quartz源文件，下载地址：http://www.quartz-scheduler.org/，解压出来，我的是quartz-2.2.3版本，也可以直接发邮件给我912547587@qq.com索要，我解压出来，如图所示：

2、打开文件夹quartz-2.2.3,里面内容如图所示：

docs：一些文件信息；

examples：官方的案例；

javadoc:官方API；

lib:开发过程中所使用的jar包；

licenses:版本的序列号

src:quartz源码信息；

3、根据官方案例库，我们来学习一下他们调用过程，首先创建一个eclipse的Java工程，将项目导进去，创建两个Java文件和一个log4j.xml文件，eclipse结构如图：

SimpleExample.jav 1

 package org.quartz.examples.example1;

 import static org.quartz.DateBuilder.evenMinuteDate;
 import static org.quartz.JobBuilder.newJob;
 import static org.quartz.TriggerBuilder.newTrigger;

 import org.quartz.JobDetail;
 import org.quartz.Scheduler;
 import org.quartz.SchedulerFactory;
 import org.quartz.Trigger;
 import org.quartz.impl.StdSchedulerFactory;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;

 import java.util.Date;

 /**
  * This Example will demonstrate how to start and shutdown the Quartz scheduler and how to schedule a job to run in
  * Quartz.
  *
  * @author Bill Kratzer
  */
 public class SimpleExample {

   public void run() throws Exception {
     Logger log = LoggerFactory.getLogger(SimpleExample.class);

     log.info("------- Initializing ----------------------");

     // First we must get a reference to a scheduler，首先我们获取一个任务调度器
     SchedulerFactory sf = new StdSchedulerFactory();
     Scheduler sched = sf.getScheduler();

     log.info("------- Initialization Complete -----------");

     // computer a time that is on the next round minute获取下一个整点分钟，比如现在是11:20:23,获取的时间就是11:21:00
     Date runTime = evenMinuteDate(new Date());

     log.info("------- Scheduling Job  -------------------");

     // define the job and tie it to our HelloJob class定义一个任务，并把要执行的逻辑告诉Job任务
     JobDetail job = newJob(HelloJob.class).withIdentity("job1", "group1").build();

     // Trigger the job to run on the next round minute，触发器，当下一个整点分钟执行HelloJOb中的逻辑
     Trigger trigger = newTrigger().withIdentity("trigger1", "group1").startAt(runTime).build();

     // Tell quartz to schedule the job using our trigger将任务和触发器加入到任务调度器中
     sched.scheduleJob(job, trigger);
     log.info(job.getKey() + " will run at: " + runTime);

     // Start up the scheduler (nothing can actually run until the
     // scheduler has been started)任务启动
     sched.start();

     log.info("------- Started Scheduler -----------------");

     // wait long enough so that the scheduler as an opportunity to
     // run the job!等待10s中
     log.info("------- Waiting 10 seconds... -------------");
     try {
       // wait 65 seconds to show job
       Thread.sleep(10L * 1000L);
       // executing...
     } catch (Exception e) {
       //
     }

     // shut down the scheduler任务自动关闭
     log.info("------- Shutting Down ---------------------");
     sched.shutdown(true);
     log.info("------- Shutdown Complete -----------------");
   }

   public static void main(String[] args) throws Exception {

     SimpleExample example = new SimpleExample();
     example.run();

   }

 }

HelloJob.java

 /*
  * All content copyright Terracotta, Inc., unless otherwise indicated. All rights reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"); you may not
  * use this file except in compliance with the License. You may obtain a copy
  * of the License at
  *
  *   http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
  * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
  * License for the specific language governing permissions and limitations
  * under the License.
  *
  */

 package org.quartz.examples.example1;

 import java.util.Date;

 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.quartz.Job;
 import org.quartz.JobExecutionContext;
 import org.quartz.JobExecutionException;

 /**
  * <p>
  * This is just a simple job that says "Hello" to the world.
  * </p>
  *
  * @author Bill Kratzer
  */
 public class HelloJob implements Job {

     private static Logger _log = LoggerFactory.getLogger(HelloJob.class);

     /**
      * <p>
      * Empty constructor for job initilization
      * </p>
      * <p>
      * Quartz requires a public empty constructor so that the
      * scheduler can instantiate the class whenever it needs.
      * </p>
      */
     public HelloJob() {
     }

     /**
      * <p>
      * Called by the <code>{@link org.quartz.Scheduler}</code> when a
      * <code>{@link org.quartz.Trigger}</code> fires that is associated with
      * the <code>Job</code>.
      * </p>
      *
      * @throws JobExecutionException
      *             if there is an exception while executing the job.
      */
     public void execute(JobExecutionContext context)
         throws JobExecutionException {

         // Say Hello to the World and display the date/time要执行的业务逻辑
         _log.info("Hello World! - " + new Date());
     }

 }

log4j.xml文件

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">

<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">

  <appender name="default" class="org.apache.log4j.ConsoleAppender">
    <param name="target" value="System.out"/>
    <layout class="org.apache.log4j.PatternLayout">
      <param name="ConversionPattern" value="[%p] %d{dd MMM hh:mm:ss.SSS aa} %t [%c]%n%m%n%n"/>
    </layout>
  </appender>

 <logger name="org.quartz">
   <level value="info" />
 </logger>

  <root>
    <level value="info" />
    <appender-ref ref="default" />
  </root>

</log4j:configuration>

执行结果日志：

[INFO] 2017-03-20 18:31:36 992 main [org.quartz.examples.example1.SimpleExample]
------- Initializing ----------------------

[INFO] 2017-03-20 18:31:37 028 main [org.quartz.impl.StdSchedulerFactory]
Using default implementation for ThreadExecutor

[INFO] 2017-03-20 18:31:37 032 main [org.quartz.simpl.SimpleThreadPool]
Job execution threads will use class loader of thread: main

[INFO] 2017-03-20 18:31:37 044 main [org.quartz.core.SchedulerSignalerImpl]
Initialized Scheduler Signaller of type: class org.quartz.core.SchedulerSignalerImpl

[INFO] 2017-03-20 18:31:37 045 main [org.quartz.core.QuartzScheduler]
Quartz Scheduler v.2.2.3 created.

[INFO] 2017-03-20 18:31:37 045 main [org.quartz.simpl.RAMJobStore]
RAMJobStore initialized.

[INFO] 2017-03-20 18:31:37 047 main [org.quartz.core.QuartzScheduler]
Scheduler meta-data: Quartz Scheduler (v2.2.3) 'DefaultQuartzScheduler' 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 10 threads.
  Using job-store 'org.quartz.simpl.RAMJobStore' - which does not support persistence. and is not clustered.

[INFO] 2017-03-20 18:31:37 047 main [org.quartz.impl.StdSchedulerFactory]
Quartz scheduler 'DefaultQuartzScheduler' initialized from default resource file in Quartz package: 'quartz.properties'

[INFO] 2017-03-20 18:31:37 047 main [org.quartz.impl.StdSchedulerFactory]
Quartz scheduler version: 2.2.3

[INFO] 2017-03-20 18:31:37 047 main [org.quartz.examples.example1.SimpleExample]
------- Initialization Complete -----------

[INFO] 2017-03-20 18:31:37 048 main [org.quartz.examples.example1.SimpleExample]
------- Scheduling Job  -------------------

[INFO] 2017-03-20 18:31:37 058 main [org.quartz.examples.example1.SimpleExample]
group1.job1 will run at: Mon Mar 20 18:32:00 CST 2017

[INFO] 2017-03-20 18:31:37 058 main [org.quartz.core.QuartzScheduler]
Scheduler DefaultQuartzScheduler_$_NON_CLUSTERED started.

[INFO] 2017-03-20 18:31:37 059 main [org.quartz.examples.example1.SimpleExample]
------- Started Scheduler -----------------

[INFO] 2017-03-20 18:31:37 059 main [org.quartz.examples.example1.SimpleExample]
------- Waiting 65 seconds... -------------

[INFO] 2017-03-20 18:31:47 060 main [org.quartz.examples.example1.SimpleExample]
------- Shutting Down ---------------------

[INFO] 2017-03-20 18:31:47 060 main [org.quartz.core.QuartzScheduler]
Scheduler DefaultQuartzScheduler_$_NON_CLUSTERED shutting down.

[INFO] 2017-03-20 18:31:47 060 main [org.quartz.core.QuartzScheduler]
Scheduler DefaultQuartzScheduler_$_NON_CLUSTERED paused.

[INFO] 2017-03-20 18:31:47 535 main [org.quartz.core.QuartzScheduler]
Scheduler DefaultQuartzScheduler_$_NON_CLUSTERED shutdown complete.

[INFO] 2017-03-20 18:31:47 535 main [org.quartz.examples.example1.SimpleExample]
------- Shutdown Complete -----------------