在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 = TestSchedulerorg.quartz.scheduler.instanceId = AUTO## Configure ThreadPool #org.quartz.threadPool.class = org.quartz.simpl.SimpleThreadPoolorg.quartz.threadPool.threadCount = 5org.quartz.threadPool.threadPriority = 4## Configure JobStore #org.quartz.jobStore.misfireThreshold = 5000org.quartz.jobStore.class = org.quartz.simpl.RAMJobStore# ===========================================================================# Configure SchedulerPlugins ===============================================# ===========================================================================org.quartz.plugin.triggHistory.class = org.quartz.plugins.history.LoggingTriggerHistoryPluginorg.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.JobInitializationPluginorg.quartz.plugin.jobInitializer.fileName = /quartz_job.xmlorg.quartz.plugin.jobInitializer.overWriteExistingJobs = falseorg.quartz.plugin.jobInitializer.failOnFileNotFound = trueorg.quartz.plugin.shutdownhook.class = org.quartz.plugins.management.ShutdownHookPluginorg.quartz.plugin.shutdownhook.cleanShutdown = true以上配置quartz所需的配置,其中org.quartz.plugin.jobInitializer.fileName = /quartz_job.xml指定作业配置文件名,下面我是为HelloworldJob 写的一个配置,quartz_job.xml内容如下:
这是在tomcat中作的一个例子,当然要使用quartz面要下载其相关包!helloworld group1 com.unicom.gdnum.jobs.HelloworldJob test group1 helloworld group1 0 0/1 * * * ?
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
< beans > < bean id ="z" class ="org.springframework.scheduling.quartz.SchedulerFactoryBean" > < property name ="triggers" > < list > < ref bean ="cronReportTrigger" /> < bean id ="courseService" class ="CourseService" > < bean id ="scheduledReportJobDetail" class ="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean" > < property name ="targetObject" > < ref bean ="courseService" /> < property name ="targetMethod" > < value > sendCourseEnrollmentReport < bean id ="cronReportTrigger" class ="org.springframework.scheduling.quartz.CronTriggerBean" > < property name ="jobDetail" > < ref bean ="scheduledReportJobDetail" /> < property name ="cronExpression" > < value > 10,15,20,25,30,35,40,45,50,55 * * * * ?关于配置文件中参数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 = TestSchedulerorg.quartz.scheduler.instanceId = AUTO## Configure ThreadPool#org.quartz.threadPool.class = org.quartz.simpl.SimpleThreadPoolorg.quartz.threadPool.threadCount = 5org.quartz.threadPool.threadPriority = 4## Configure JobStore#org.quartz.jobStore.misfireThreshold = 5000org.quartz.jobStore.class = org.quartz.simpl.RAMJobStore第二步: 修改WEB.XML文件,主要是在应用启动时加载调度器,启动调度器,来加载被调度任务
第三步:3添加一个servlet初始化类action test.quartz.InitServlet config /WEB-INF/struts-config.xml debug 2 application ApplicationResources 2
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,则表示某个月的最后一个礼拜六;CW# 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