定时任务quartz

在quartz中一个作业实例必须实现org.quartz.Job接口

package com.unicom.gdnum.jobs;

import java.util.*;

import org.apache.commons.logging.*;
import org.quartz.Job;
import org.quartz.JobExecutionContext;
import org.quartz.JobExecutionException;

public class HelloworldJob implements Job{

static Log log=LogFactory.getLog(HelloworldJob.class);
public  HelloworldJob() {
 
}
public void execute(JobExecutionContext arg0) throws JobExecutionException {
  // TODO Auto-generated method stub
  log.info("Hello World Quartz......."+(new Date()).toLocaleString());
}
}


quartz有自己的配置文个名为quartz.properties，如果我们不在src/（根目录）如果我们不建立文件那么quartz就会使用quartz.jar包里的这个的文件。该文件通常包含以下内容：

#
# Configure Main Scheduler Properties
#

org.quartz.scheduler.instanceName = TestScheduler
org.quartz.scheduler.instanceId = AUTO

#
# Configure ThreadPool
#

org.quartz.threadPool.class = org.quartz.simpl.SimpleThreadPool
org.quartz.threadPool.threadCount =  5
org.quartz.threadPool.threadPriority = 4

#
# Configure JobStore
#

org.quartz.jobStore.misfireThreshold = 5000

org.quartz.jobStore.class = org.quartz.simpl.RAMJobStore

# ===========================================================================
# Configure SchedulerPlugins  ===============================================
# ===========================================================================
org.quartz.plugin.triggHistory.class = org.quartz.plugins.history.LoggingTriggerHistoryPlugin
org.quartz.plugin.triggHistory.triggerFiredMessage = Trigger {1}.{0} fired job {6}.{5} at: {4, date, HH:mm:ss MM/dd/yyyy}
org.quartz.plugin.triggHistory.triggerCompleteMessage = Trigger {1}.{0} completed firing job {6}.{5} at {4, date, HH:mm:ss MM/dd/yyyy} with resulting trigger instruction code: {9}

org.quartz.plugin.jobInitializer.class = org.quartz.plugins.xml.JobInitializationPlugin
org.quartz.plugin.jobInitializer.fileName = /quartz_job.xml
org.quartz.plugin.jobInitializer.overWriteExistingJobs = false
org.quartz.plugin.jobInitializer.failOnFileNotFound = true

org.quartz.plugin.shutdownhook.class = org.quartz.plugins.management.ShutdownHookPlugin
org.quartz.plugin.shutdownhook.cleanShutdown = true


以上配置quartz所需的配置，其中org.quartz.plugin.jobInitializer.fileName = /quartz_job.xml指定作业配置文件名，下面我是为HelloworldJob 写的一个配置，quartz_job.xml内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<quartz>
  <job>
    <job-detail>
      <name>helloworld</name>
      <group>group1</group>
      <job-class>com.unicom.gdnum.jobs.HelloworldJob</job-class>
    </job-detail>
    <trigger>
      <cron>
        <name>test</name>
        <group>group1</group>
        <job-name>helloworld</job-name>
        <job-group>group1</job-group>
        <cron-expression>0 0/1 * * * ?</cron-expression>
     </cron>
    </trigger>
  </job>
</quartz>


这是在tomcat中作的一个例子，当然要使用quartz面要下载其相关包!

public   class  CourseService   {

   public   void  sendCourseEnrollmentReport()  {
    System.out.println( " HelloWorld " );
  } 

}
调度任务的Class: TaskApp
import  org.springframework.beans.factory.BeanFactory;
import  org.springframework.beans.factory.xml.XmlBeanFactory;
import  org.springframework.core.io.FileSystemResource;

public   class  TaskApp   {

   public   static   void  main(String[] args)  throws  Exception   {
    BeanFactory factory  =   new  XmlBeanFactory( new  FileSystemResource(  " WebRoot/WEB-INF/classes/scheduleTask.xml " ));
    factory.getBean( " z " );
  } 
   
} 

配置调度执行任务的配置文件: scheduleTask.xml

<? xml version="1.0" encoding="UTF-8" ?> 
<! DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd" > 
< beans > 
   <!-- 起动Bean --> 
   < bean  id ="z"  class ="org.springframework.scheduling.quartz.SchedulerFactoryBean" > 
     < property  name ="triggers" > 
       < list > 
     < ref  bean ="cronReportTrigger"   /> 
       </ list > 
     </ property > 
   </ bean > 
   <!-- 实际的工作Bean --> 
   < bean  id ="courseService"  class ="CourseService" >
   </ bean > 
   <!-- jobBean用于设定启动时运用的Bean与方法 --> 
   < bean  id ="scheduledReportJobDetail"  class ="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean" > 
     < property  name ="targetObject" > 
     < ref  bean ="courseService"   /> 
     </ property > 
     < property  name ="targetMethod" > 
       < value > sendCourseEnrollmentReport </ value > 
     </ property > 
   </ bean > 
   <!-- 定时器设定起动频率&启动时间我设的是每5秒起动一次 (0 0 4 * * ?每日四点起动.) --> 
   < bean  id ="cronReportTrigger"  class ="org.springframework.scheduling.quartz.CronTriggerBean" > 
     < property  name ="jobDetail" > 
     < ref  bean ="scheduledReportJobDetail"   /> 
     </ property > 
     < property  name ="cronExpression" > 
       < value > 10,15,20,25,30,35,40,45,50,55 * * * * ? </ value > 
     </ property > 
   </ bean > 
</ beans >


关于配置文件中参数cronExpression的说明:

字段 允许值 允许的特殊字符
秒  0 - 59   ,  - * /
分  0 - 59   ,  - * /
小时  0 - 23   ,  - * /
日期  1 - 31   ,  - * ? / L W C
月份  1 - 12  或者 JAN-DEC  ,  - * /
星期  1 - 7  或者 SUN-SAT  ,  - * ? / L C #
年（可选） 留空 ,   1970 - 2099   ,  - * / 
表达式意义:
" 0 0 12 * * ? "  每天中午12点触发
" 0 15 10 ? * * "  每天上午10:15触发
" 0 15 10 * * ? "  每天上午10:15触发
" 0 15 10 * * ? * "  每天上午10:15触发
" 0 15 10 * * ? 2005 "  2005年的每天上午10:15触发
" 0 * 14 * * ? "  在每天下午2点到下午2:59期间的每1分钟触发
" 0 0/5 14 * * ? "  在每天下午2点到下午2:55期间的每5分钟触发
" 0 0/5 14,18 * * ? "  在每天下午2点到2:55期间和下午6点到6:55期间的每5分钟触发
" 0 0-5 14 * * ? "  在每天下午2点到下午2:05期间的每1分钟触发
" 0 10,44 14 ? 3 WED "  每年三月的星期三的下午2:10和2:44触发
" 0 15 10 ? * MON-FRI "  周一至周五的上午10:15触发
" 0 15 10 15 * ? "  每月15日上午10:15触发
" 0 15 10 L * ? "  每月最后一日的上午10:15触发
" 0 15 10 ? * 6L "  每月的最后一个星期五上午10:15触发
" 0 15 10 ? * 6L 2002-2005 "  2002年至2005年的每月的最后一个星期五上午10:15触发
" 0 15 10 ? * 6#3 "  每月的第三个星期五上午10:15触发
0   6  * * *          每天早上6点 
0  */ 2  * * *        每两个小时 
0   23 - 7 / 2 ， 8  * * *  晚上11点到早上8点之间每两个小时，早上八点 
0   11   4  *  1 - 3        每个月的4号和每个礼拜的礼拜一到礼拜三的早上11点 
0   4   1   1  *          1月1日早上4点 

***********************************************************************************

第一步:建立资源文件

Quartz有一个叫做quartz.properties的配置文件，它允许你修改框架运行时环境。缺省是使
用Quartz.jar里面的quartz.properties文件
。当然，你应该创建一个quartz.properties文件的副本并且把它放入你工程的classes目录
中以便类装载器找到它。

# Configure Main Scheduler Properties
#
org.quartz.scheduler.instanceName = TestScheduler
org.quartz.scheduler.instanceId = AUTO
#
# Configure ThreadPool
#
org.quartz.threadPool.class = org.quartz.simpl.SimpleThreadPool
org.quartz.threadPool.threadCount = 5
org.quartz.threadPool.threadPriority = 4
#
# Configure JobStore
#
org.quartz.jobStore.misfireThreshold = 5000
org.quartz.jobStore.class = org.quartz.simpl.RAMJobStore


第二步: 修改WEB.XML文件,主要是在应用启动时加载调度器,启动调度器,来加载被调度任务

<servlet>
    <servlet-name>action</servlet-name>
    <servlet-class>test.quartz.InitServlet</servlet-class>
    <init-param>
      <param-name>config</param-name>
      <param-value>/WEB-INF/struts-config.xml</param-value>
    </init-param>
    <init-param>
      <param-name>debug</param-name>
      <param-value>2</param-value>
    </init-param>
    <init-param>
      <param-name>application</param-name>
      <param-value>ApplicationResources</param-value>
    </init-param>
    <load-on-startup>2</load-on-startup>
  </servlet>


第三步:3添加一个servlet初始化类

package test.quartz;

import org.apache.struts.action.ActionServlet;
import javax.servlet.ServletException;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import test.quartz.QuartzInitializerServlet;
import org.quartz.Scheduler;
import org.quartz.impl.StdSchedulerFactory;
import javax.servlet.ServletContext;

public class InitServlet extends ActionServlet {
    public void init() throws javax.servlet.ServletException {
        try {
            ServletContext app = this.getServletContext();
            initScheduler(app);
        } catch (Exception ex) {}
        super.init();
    }

    protected void initScheduler(ServletContext app) {
        try {
            Scheduler scheduler = StdSchedulerFactory.getDefaultScheduler();
            app.setAttribute(Constants.SCHEDULER_KEY,scheduler);  //将任务调度实例放到servlet上下文
            QuartzInitializerServlet.startScheduler(app); //启动任务
        } catch (Exception e) {}
    }
}

package test.quartz;

import org.quartz.impl.StdSchedulerFactory;
import org.quartz.SchedulerException;
import org.quartz.JobDetail;
import org.quartz.Trigger;
import org.quartz.Scheduler;
import org.quartz.CronTrigger;
import java.text.ParseException;
import java.sql.SQLException;
import javax.servlet.ServletContext;

public class QuartzInitializerServlet {
    public static void startScheduler(ServletContext app) {
        try {
            Scheduler scheduler = null;
            if (app.getAttribute(Constants.SCHEDULER_KEY) != null) {
                scheduler = (Scheduler) app.getAttribute(Constants.
                        SCHEDULER_KEY);
                if (!scheduler.isShutdown()) {
                    scheduler.shutdown();
                }
            }
            scheduler = null;
            app.removeAttribute(Constants.SCHEDULER_KEY);

            scheduler = StdSchedulerFactory.getDefaultScheduler();
            app.setAttribute(Constants.SCHEDULER_KEY, scheduler);
           
            jobDetail(scheduler, "Jobhouse", scheduler.DEFAULT_GROUP,
                          "triger1", Scheduler.DEFAULT_GROUP, JobEcecute.class,
                          0 0 21 * * ?);//每天晚上9点执行
            jobDetail(scheduler, "Jobqqstatus", scheduler.DEFAULT_GROUP,
                          "triger2", Scheduler.DEFAULT_GROUP,
                          JobRefreshQQstaus.class,
                          0 0 3 * * ?);//每天凌晨3点执行
            scheduler.start();
        } catch (SQLException ex) {}
          catch (SchedulerException ex) {}
    }


//将任务添加到调度器
    private static void jobDetail(Scheduler scheduler, String jobName,
                                  String jobgroup,
                                  String trigerName,
                                  String trigerGroup, Class jobClass,
                                  String triggerTime) {
        try {
         //任务实体
            JobDetail jobDetail = new JobDetail(jobName, jobgroup, jobClass);
            //任务触发器
            Trigger trigger = new CronTrigger(trigerName, trigerGroup,
                                              triggerTime);
            //将任务添加到调度器
            scheduler.scheduleJob(jobDetail, trigger);
        } catch (ParseException ex) {}
          catch (SchedulerException ex) {}
    }
}


第四步:创建被调度任务类

package com.duiduihu.ecf.common.quartz;

import org.quartz.JobExecutionContext;
import org.quartz.JobExecutionException;
import org.quartz.Job;

public class JobEcecute implements Job {
    public void execute(JobExecutionContext context) throws
            JobExecutionException {
        System.out.println("Hello the World! - " + new Date());
        System.out.println("任务已经被调度!!");
    }
}




Quartz中CronTrigger介绍

Quartz中CronTrigger的expression："Cron-Expression"
"Cron-Expression"与linux中的crontab有很大的不同，昨天差点迷惑了我。

"Cron-Expression"由6到7个用空格分开的字段组成的表达式这6或7个字段必须遵循下面的顺
序和格式：

Field Name   Allowed Values   Allowed Special Characters
Seconds    0-59    , - * /
Minutes    0-59    , - * /
Hours    0-23    , - * /
Day-of-month    1-31    , - * ? / L W C
Month    1-12 or JAN-DEC    , - * /
Day-of-Week    1-7 or SUN-SAT    , - * ? / L C #
Year (Optional)    empty, 1970-2099    , - * /

*是一个通配符，表示任何值，用在Minutes字段中表示每分钟。
?只可以用在day-of-month或者Day-of-Week字段中，用来表示不指定特殊的值。
-用来表示一个范围，比如10-12用在Month中表示10到12月。
,用来表示附加的值，比如MON,WED,FRI在day-of-week字段中表示礼拜一和礼拜三和礼拜五。
/用来表示增量，比如0/15用在Minutes字段中表示从0分开始0和15和30和45分。
L只可以用在day-of-month或者Day-of-Week字段中，如果用在Day-of-month中，表示某个月
的最后一天，1月则是表示31号，2月则表示28号（非闰年），如果用在Day-of-Week中表示礼
拜六（数字7）；但是如果L与数字组合在一起用在Day-of-month中，比如6L，则表示某个月
的最后一个礼拜六；
C
W
#

0 1 0 1 1-12 ?表示每月1号0点1分执行。
0 0 21 ? * 1表示每个礼拜天21点0分执行。
0 0 0 * * ?表示每天0点0分执行。
0 * 22 * * ?表示每天22点开始每分钟
0 * 0-23 * * ?表示每天每分钟


关于cron表达式：

Cron 表达式包括以下 7 个字段：

秒
分
小时
月内日期
月
周内日期
年（可选字段）
特殊字符

Cron 触发器利用一系列特殊字符，如下所示：

反斜线（/）字符表示增量值。例如，在秒字段中“5/15”代表从第 5 秒开始，每 15 秒一次。
问号（?）字符和字母 L 字符只有在月内日期和周内日期字段中可用。问号表示这个字段不包含具体值。所以，如果指定月内日期，可以在周内日期字段中插入“?”，表示周内日期值无关紧要。字母 L 字符是 last 的缩写。放在月内日期字段中，表示安排在当月最后一天执行。在周内日期字段中，如果“L”单独存在，就等于“7”，否则代表当月内周内日期的最后一个实例。所以“0L”表示安排在当月的最后一个星期日执行。
在月内日期字段中的字母（W）字符把执行安排在最靠近指定值的工作日。把“1W”放在月内日期字段中，表示把执行安排在当月的第一个工作日内。
井号（#）字符为给定月份指定具体的工作日实例。把“MON#2”放在周内日期字段中，表示把任务安排在当月的第二个星期一。
星号（*）字符是通配字符，表示该字段可以接受任何可能的值。
字段 允许值 允许的特殊字符
秒 0-59 , - * /
分 0-59 , - * /
小时 0-23 , - * /
日期 1-31 , - * ? / L W C
月份 1-12 或者 JAN-DEC , - * /
星期 1-7 或者 SUN-SAT , - * ? / L C #
年（可选） 留空, 1970-2099 , - * /
表达式意义
"0 0 12 * * ?" 每天中午12点触发
"0 15 10 ? * *" 每天上午10:15触发
"0 15 10 * * ?" 每天上午10:15触发
"0 15 10 * * ? *" 每天上午10:15触发
"0 15 10 * * ? 2005" 2005年的每天上午10:15触发
"0 * 14 * * ?" 在每天下午2点到下午2:59期间的每1分钟触发
"0 0/5 14 * * ?" 在每天下午2点到下午2:55期间的每5分钟触发
"0 0/5 14,18 * * ?" 在每天下午2点到2:55期间和下午6点到6:55期间的每5分钟触发
"0 0-5 14 * * ?" 在每天下午2点到下午2:05期间的每1分钟触发
"0 10,44 14 ? 3 WED" 每年三月的星期三的下午2:10和2:44触发
"0 15 10 ? * MON-FRI" 周一至周五的上午10:15触发
"0 15 10 15 * ?" 每月15日上午10:15触发
"0 15 10 L * ?" 每月最后一日的上午10:15触发
"0 15 10 ? * 6L" 每月的最后一个星期五上午10:15触发
"0 15 10 ? * 6L 2002-2005" 2002年至2005年的每月的最后一个星期五上午10:15触发
"0 15 10 ? * 6#3" 每月的第三个星期五上午10:15触发
每天早上6点0 6 * * *

每两个小时0 */2 * * *
晚上11点到早上8点之间每两个小时，早上八点0 23-7/2，8 * * *

每个月的4号和每个礼拜的礼拜一到礼拜三的早上11点0 11 4 * 1-3
1月1日早上4点0 4 1 1 *



REFERCENCES:http://blog.csdn.net/haomenghan/article/details/7788976