Quartz框架調用Demo
任務調度在JAVA應用程序中運用的十分普遍,掌握QUARTZ是必備的技能;
官網:http://www.quartz-scheduler.org/ 下載最新1.80資源包
commons-logging、log4j、slf4j 等jar包要添加進去,quartz的jar包則肯定必須;
實例:文件一(執行具體任務class)
public class QuartzDemo implements Job{ @Override public void execute(JobExecutionContext arg0) throws JobExecutionException { System.out.println("Quartz執行......."); } }
文件二:
public class QuartzManager{ private static final SimpleTrigger CronTrigger = null; public static void main(String[] args){ } public void simpleDemo(){ //通過SchedulerFactory來獲取一個調度器 SchedulerFactory schedulerFactory = new StdSchedulerFactory(); Scheduler scheduler; try { scheduler = schedulerFactory.getScheduler(); //引進作業程序 JobDetail jobDetail = new JobDetail("jobDetail-s1", "jobDetailGroup-s1", QuartzDemo.class); //new一個觸發器 SimpleTrigger simpleTrigger = new SimpleTrigger("simpleTrigger", "triggerGroup-s1"); //設置作業啟動時間 long ctime = System.currentTimeMillis(); simpleTrigger.setStartTime(new Date(ctime)); //設置作業執行間隔 simpleTrigger.setRepeatInterval(1000); //設置作業執行次數 simpleTrigger.setRepeatCount(10); //設置作業執行優先級默認為5 //simpleTrigger.setPriority(10); //作業和觸發器設置到調度器中 scheduler.scheduleJob(jobDetail, simpleTrigger); //啟動調度器 scheduler.start(); } catch (SchedulerException e) { // TODO Auto-generated catch block e.printStackTrace(); } } public void cronDemo(){ try { SchedulerFactory schedFact = new org.quartz.impl.StdSchedulerFactory(); Scheduler sched = schedFact.getScheduler(); sched.start(); JobDetail jobDetail = new JobDetail( " Income Report " , " Report Generation " , QuartzDemo.class ); jobDetail.getJobDataMap().put( " type " , " FULL " ); CronTrigger trigger = new CronTrigger( " Income Report " , " Report Generation " ); /**/ /* 每1分鍾執行一次 */ trigger.setCronExpression( "0 33 16 * * ?" ); sched.scheduleJob(jobDetail, trigger); } catch (Exception e) { e.printStackTrace(); } } public void caledarDemo(){ //通過SchedulerFactory來獲取一個調度器 SchedulerFactory schedulerFactory = new StdSchedulerFactory(); Scheduler scheduler; try { scheduler = schedulerFactory.getScheduler(); //引進作業程序 JobDetail jobDetail = new JobDetail("jobDetail-s1", "jobDetailGroup-s1", QuartzDemo.class); //new一個觸發器 CronTrigger simpleTrigger = new CronTrigger("trigger", "group", "job", "group", "16 26/1 8-17 * * ?"); // new SimpleTrigger("simpleTrigger", "triggerGroup-s1"); //設置作業啟動時間 //Calendar excelCal = Calendar.getInstance(); //excelCal.add(Calendar.DAY_OF_MONTH, 1); ///excelCal.set(Calendar.HOUR_OF_DAY, 16); //excelCal.set(Calendar.SECOND, 0); //excelCal.add(Calendar.MINUTE, 9); // long ctime = System.currentTimeMillis(); // simpleTrigger.setStartTime(excelCal.getTime()); //設置作業執行間隔 // simpleTrigger.setRepeatInterval(1000); //設置作業執行次數 // simpleTrigger.setRepeatCount(10); //設置作業執行優先級默認為5 //simpleTrigger.setPriority(10); //作業和觸發器設置到調度器中 scheduler.scheduleJob(jobDetail, simpleTrigger); //啟動調度器 scheduler.start(); } catch (SchedulerException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (ParseException e) { // TODO Auto-generated catch block e.printStackTrace(); } } }
需要注意的幾點是經常會出現org.quartz.core.ErrorLogger : An error occured instantiating job to be executed.....這種異常,解決辦法是
1)Job類必須有默認的無參構造方法,當然不覆蓋的話類本身就是無參的構造方法 2)Job的scope必須是Public類型的,因為quartz根據反射機制實例化類,如果不是public的,無法對其暴露 3) Job類不能是內部類,原因同上,所以最好單獨建類
Quartz的配置文件:quartz.properties詳解
# Configure Main Scheduler Properties org.quartz.scheduler.instanceName = TestScheduler org.quartz.scheduler.instanceId = one # 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 附: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觸發 特殊字符 意義 * 表示所有值; ? 表示未說明的值,即不關心它為何值; - 表示一個指定的范圍; , 表示附加一個可能值; / 符號前表示開始時間,符號后表示每次遞增的值; L("last") ("last") "L" 用在day-of-month字段意思是 "這個月最后一天";用在 day-of-week字段, 它簡單意思是 "7" or "SAT"。 如果在day-of-week字段里和數字聯合使用,它的意思就是 "這個月的最后一個星期幾" – 例如: "6L" means "這個月的最后一個星期五". 當我們用“L”時,不指明一個列表值或者范圍是很重要的,不然的話,我們會得到一些意想不到的結果。 W("weekday") 只能用在day-of-month字段。用來描敘最接近指定天的工作日(周一到周五)。例如:在day-of-month字段用“15W”指“最接近這個月第15天的工作日”,即如果這個月第15天是周六,那么觸發器將會在這個月第14天即周五觸發;如果這個月第15天是周日,那么觸發器將會在這個月第16天即周一觸發;如果這個月第15天是周二,那么就在觸發器這天觸發。注意一點:這個用法只會在當前月計算值,不會越過當前月。“W”字符僅能在day-of-month指明一天,不能是一個范圍或列表。也可以用“LW”來指定這個月的最后一個工作日。 # 只能用在day-of-week字段。用來指定這個月的第幾個周幾。例:在day-of-week字段用"6#3"指這個月第3個周五(6指周五,3指第3個)。如果指定的日期不存在,觸發器就不會觸發。 C 指和calendar聯系后計算過的值。例:在day-of-month 字段用“5C”指在這個月第5天或之后包括calendar的第一天;在day-of-week字段用“1C”指在這周日或之后包括calendar的第一天
注意:Quartz提供管理任務的Java代碼:
/** * Package Name:nc.xyzq.common.task * Date:2019年01月24日下午3:06:49 * @author lizm * */ package nc.xyzq.common.task; import org.quartz.CronTrigger; import org.quartz.JobDetail; import org.quartz.Scheduler; import org.quartz.SchedulerFactory; import org.quartz.impl.StdSchedulerFactory; //任務管理器 public class QuartzManager { private static SchedulerFactory gSchedulerFactory = new StdSchedulerFactory(); private static String JOB_GROUP_NAME = "EXTJWEB_JOBGROUP_NAME"; private static String TRIGGER_GROUP_NAME = "EXTJWEB_TRIGGERGROUP_NAME"; /** * 添加一個定時任務,使用默認的任務組名,觸發器名,觸發器組名 * * @param jobName 任務名 * @param jobClass 任務 * @param time 時間設置,參考quartz說明文檔 * */ public static void addJob(String jobName, String jobClass, String time) { try { //System.out.println("addJob>>>1111>>Apache Tomcat v6.0.32 at localhost:"+jobName+" jobClass:"+jobClass+" time:"+time); //通過SchedulerFactory來獲取一個調度器 Scheduler sched = gSchedulerFactory.getScheduler(); //引進作業程序 JobDetail jobDetail = new JobDetail(jobName, JOB_GROUP_NAME, Class .forName(jobClass));// 任務名,任務組,任務執行類 //new一個觸發器 CronTrigger trigger = new CronTrigger(jobName, TRIGGER_GROUP_NAME); // 觸發器時間設定 trigger.setCronExpression(time); sched.scheduleJob(jobDetail, trigger); // 啟動 if (!sched.isShutdown()) { sched.start(); } } catch (Exception e) { // TODO Auto-generated catch block e.printStackTrace(); } } /** * 添加一個定時任務 * * @param jobName 任務名 * @param jobGroupName 任務組名 * @param triggerName 觸發器名 * @param triggerGroupName 觸發器組名 * @param jobClass 任務 * @param time 時間設置,參考quartz說明文檔 */ public static void addJob(String jobName, String jobGroupName, String triggerName, String triggerGroupName, String jobClass, String time) { try { //通過SchedulerFactory來獲取一個調度器 Scheduler sched = gSchedulerFactory.getScheduler(); //引進作業程序 JobDetail jobDetail = new JobDetail(jobName, jobGroupName, Class .forName(jobClass));// 任務名,任務組,任務執行類 //觸發器 CronTrigger trigger = new CronTrigger(triggerName, triggerGroupName); // 觸發器時間設定 trigger.setCronExpression(time); sched.scheduleJob(jobDetail, trigger); // 啟動 if (!sched.isShutdown()) { sched.start(); } } catch (Exception e) { e.printStackTrace(); throw new RuntimeException(e); } } /** * 修改一個任務的觸發時間(使用默認的任務組名,觸發器名,觸發器組名) * * @param jobName * @param time */ public static void modifyJobTime(String jobName, String time) { try { Scheduler sched = gSchedulerFactory.getScheduler(); CronTrigger trigger = (CronTrigger) sched.getTrigger(jobName, TRIGGER_GROUP_NAME); if (trigger == null) { return; } String oldTime = trigger.getCronExpression(); if (!oldTime.equalsIgnoreCase(time)) { JobDetail jobDetail = sched.getJobDetail(jobName, JOB_GROUP_NAME); Class objJobClass = jobDetail.getJobClass(); String jobClass = objJobClass.getName(); removeJob(jobName); addJob(jobName, jobClass, time); } } catch (Exception e) { e.printStackTrace(); throw new RuntimeException(e); } } /** * 修改一個任務的觸發時間 * * @param triggerName * @param triggerGroupName * @param time */ public static void modifyJobTime(String triggerName, String triggerGroupName, String time) { try { Scheduler sched = gSchedulerFactory.getScheduler(); CronTrigger trigger = (CronTrigger) sched.getTrigger(triggerName, triggerGroupName); if (trigger == null) { return; } String oldTime = trigger.getCronExpression(); if (!oldTime.equalsIgnoreCase(time)) { CronTrigger ct = (CronTrigger) trigger; // 修改時間 ct.setCronExpression(time); // 重啟觸發器 sched.resumeTrigger(triggerName, triggerGroupName); } } catch (Exception e) { e.printStackTrace(); throw new RuntimeException(e); } } /** * 移除一個任務(使用默認的任務組名,觸發器名,觸發器組名) * * @param jobName */ public static void removeJob(String jobName) { try { Scheduler sched = gSchedulerFactory.getScheduler(); // 停止觸發器 sched.pauseTrigger(jobName, TRIGGER_GROUP_NAME); // 移除觸發器 sched.unscheduleJob(jobName, TRIGGER_GROUP_NAME); // 刪除任務 sched.deleteJob(jobName, JOB_GROUP_NAME); } catch (Exception e) { e.printStackTrace(); throw new RuntimeException(e); } } /** * 移除一個任務 * * @param jobName * @param jobGroupName * @param triggerName * @param triggerGroupName */ public static void removeJob(String jobName, String jobGroupName, String triggerName, String triggerGroupName) { try { Scheduler sched = gSchedulerFactory.getScheduler(); // 停止觸發器 sched.pauseTrigger(triggerName, triggerGroupName); // 移除觸發器 sched.unscheduleJob(triggerName, triggerGroupName); // 刪除任務 sched.deleteJob(jobName, jobGroupName); } catch (Exception e) { e.printStackTrace(); throw new RuntimeException(e); } } /** * 啟動所有定時任務 */ public static void startJobs() { try { Scheduler sched = gSchedulerFactory.getScheduler(); if (sched.isShutdown()) { sched.start(); } } catch (Exception e) { e.printStackTrace(); throw new RuntimeException(e); } } /** * 關閉所有定時任務 */ public static void shutdownJobs() { try { Scheduler sched = gSchedulerFactory.getScheduler(); if (!sched.isShutdown()) { sched.shutdown(); } } catch (Exception e) { e.printStackTrace(); throw new RuntimeException(e); } } /*** * 停止觸發器 * @param triggerName * @param triggerGroupName */ public static void pauseTrigger(){ try { Scheduler sched = gSchedulerFactory.getScheduler(); sched.pauseTriggerGroup(TRIGGER_GROUP_NAME); } catch (Exception e) { e.printStackTrace(); throw new RuntimeException(e); } } /*** * 重啟觸發器 * @param triggerName * @param triggerGroupName * @param time */ public static void resumeTrigger() { try { Scheduler sched = gSchedulerFactory.getScheduler(); // 重啟觸發器 sched.resumeTriggerGroup(TRIGGER_GROUP_NAME); } catch (Exception e) { e.printStackTrace(); throw new RuntimeException(e); } } }