定时任务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
---------------------------------------------------------------------------------------------------------------------------------
copyright:http://www.cnblogs.com/anee/
