在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