在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