Spring下quartz调度持久化实战

终于有时间写博客了，这次详细记录下spring 3.X中quartz框架如何持久化调度任务相关知识点，按照目录编排。

1.介绍

1.1quartz概述

Quartz包含三个抽象概念，调度器（谁管理），任务（干什么），触发器（什么时候干）.其中几个名词大致介绍下：

@1：Job：接口，实现接口方法定义任务

@2：JobDetail:关联Job实现类和Schedular的类，其构造函数，指定Job实现类，任务在Schedular中的组名和Job名称

@3：Trigger：触发器类，描述触发事件，包含简单的时间规则和复杂的时间规则，SimpleTrigger和CronTrigger

@4：Schedular：Quartz容器，包含Trigger和JobDetail，大致结构如图

持久化的意思

之前的文章所做的demo是将定时任务的信息保存在内存中的，见以下配置
org.quartz.jobStore.class = org.quartz.simpl.RAMJobStore
如果用内存记录定时任务信息，应用重新启动后，定时任务信息将会丢失。
比如，用户A通过系统设置1小时后执行Z操作，设置好后的，因系统重新启动，
新启动的系统将会丢失“1小时后执行Z操作”的定时任务。
如果，我们需要在系统意外（或非意外）重新启动后，仍保留定时任务信息，可以使用数据库存储定时任务信息。
org.quartz.jobStore.class = org.quartz.impl.jdbcjobstore.JobStoreTX

1.2持久化12张表

建立数据存储表

        因为需要把quartz的数据保存到数据库，所以要建立相关的数据库。这个可以从下载到的quartz包里面找到对应的sql脚本，目前可以支持MySQL，DB2，Oracle等主流的数据库，自己可以根据项目需要选择合适的脚本运行。

        我的项目是mysql的，就在数据中建立了一个quartz的database，然后执行tables_mysql_innodb.sql脚本建表。其中脚本 文件位于：quartz-1.6.6\docs\dbTables

12张表：

pdm结构：

具体的pdm，文章最后将会以附件形式上传。

2.持久化配置

quartz.xml:

[html] view plain copy

1. <?xml version="1.0" encoding="utf-8"?>  
2. <beans xmlns="http://www.springframework.org/schema/beans"  
3.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:aop="http://www.springframework.org/schema/aop"  
4.     xmlns:tx="http://www.springframework.org/schema/tx"  
5.     xsi:schemaLocation="http://www.springframework.org/schema/beans  
6.                         http://www.springframework.org/schema/beans/spring-beans-2.5.xsd  
7.        http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-2.5.xsd  
8.        http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-2.5.xsd">  
9.       
10.     <!-- quartz持久化存储 -->  
11.     <bean id="quartzScheduler" class="org.springframework.scheduling.quartz.SchedulerFactoryBean">  
12.         <property name="dataSource">    
13.             <ref bean="dataSource"/>    
14.         </property>  
15.         <property name="applicationContextSchedulerContextKey"  value="applicationContextKey" />  
16.         <property name="configLocation" value="classpath:/quartz/quartz.properties"/>  
17.     </bean>  
18.       
19.     <!--记录调度日志服务 -->  
20.     <bean id="simpleService" class="com.ai.sm.quartz.job.SimpleService">   
21.     </bean>   
22.       
23.     <!-- 任务详情 -->  
24.     <bean id="jobDetail" class="org.springframework.scheduling.quartz.JobDetailBean">  
25.         <property name="jobClass">  
26.             <value>com.ai.sm.quartz.job.MyQuartzJobBean</value>  
27.         </property>  
28.         <property name="jobDataAsMap">  
29.             <map>  
30.                 <entry key="simpleService">  
31.                     <ref bean="simpleService"/>  
32.                 </entry>  
33.             </map>  
34.         </property>  
35.     </bean>     
36.       
37.     <!-- 封装调度服务 -->  
38.     <bean id="schedulerService" class="com.ai.sm.quartz.smo.SchedulerServiceImpl">   
39.         <property name="scheduler">  
40.             <ref bean="quartzScheduler" />  
41.         </property>  
42.         <property name="jobDetail">  
43.             <ref bean="jobDetail" />  
44.         </property>  
45.     </bean>   
46. </beans>  

1.工厂模式，建立一个SchedulerFactoryBean的实例，其中需要指定dataSource，configLocation，其中最重要的就是引入了quartz.properties这样一个配置文件。

2.定义一个simpleService，主要是记录任务调度日志。

3.定义JobDetailBean的实例，需要指定jobClass，调度任务处理类，这里我需要记录日志，所以property是simpleService。

4.封装一个服务schedulerService，对外提供任务的创建，销毁，启动，停用等API。

quartz.properties:

[html] view plain copy

1. #============================================================================  
2. # Configure Main Scheduler Properties   
3. #============================================================================  
4. org.quartz.scheduler.instanceName = DefaultQuartzScheduler  
5. org.quartz.scheduler.rmi.export = false  
6. org.quartz.scheduler.rmi.proxy = false  
7. org.quartz.scheduler.wrapJobExecutionInUserTransaction = false  
8.   
9. #============================================================================  
10. # Configure ThreadPool   配置数据库连接池  
11. #============================================================================  
12. org.quartz.threadPool.class = org.quartz.simpl.SimpleThreadPool    
13. org.quartz.threadPool.threadCount = 10  
14. org.quartz.threadPool.threadPriority = 5  
15. org.quartz.threadPool.threadsInheritContextClassLoaderOfInitializingThread = true  
16.   
17. #============================================================================  
18. # Configure JobStore  配置做业存储方式  
19. #============================================================================  
20. #相当于扫描频率，如果系统基于秒级，应培植成1000,quartz默认为分级（60000-分钟级别）  
21. org.quartz.jobStore.misfireThreshold = 60000  
22. #org.quartz.jobStore.class = org.quartz.simpl.RAMJobStore  
23.   
24. #在这里自己控制事务  
25. org.quartz.jobStore.class = org.quartz.impl.jdbcjobstore.JobStoreTX  
26. #org.quartz.jobStore.driverDelegateClass=org.quartz.impl.jdbcjobstore.HSQLDBDelegate  
27. org.quartz.jobStore.driverDelegateClass=org.quartz.impl.jdbcjobstore.StdJDBCDelegate     
28. #org.quartz.jobStore.useProperties = true  
29. org.quartz.jobStore.tablePrefix = QRTZ_    
30. org.quartz.jobStore.isClustered = false    
31. org.quartz.jobStore.maxMisfiresToHandleAtATime=1   

3.任务调度对外API

该API主要是提供任务创建，销毁，启用，停用，并对启用/体用过程记录日志。

simpleService：

[java] view plain copy

1. package com.ai.sm.quartz.job;  
2.   
3. import java.io.Serializable;  
4.   
5.   
6. /** 
7.  * 记录调度日志信息  
8.  * @author Administrator 
9.  * @see [相关类/方法]（可选） 
10.  * @since [产品/模块版本] （可选） 
11.  */  
12. public class SimpleService implements Serializable{  
13.       
14.     private static final long serialVersionUID = 122323233244334343L;  
15.       
16.     private TaskSMO taskSMO = null;  
17.   
18.     public TaskSMO getTaskSMO() {  
19.         if (taskSMO == null) {  
20.             taskSMO = (TaskSMO) SpringBeanInvoker.getBean("task.taskSMO");  
21.         }  
22.         return taskSMO;  
23.     }  
24.   
25.     /** 
26.      *  
27.      * 功能描述: 主要处理调度日志 
28.      * 〈功能详细描述〉 
29.      * 
30.      * @param triggerName 
31.      * @see [相关类/方法](可选) 
32.      * @since [产品/模块版本](可选) 
33.      */  
34.     public void vsopMethod(String triggerName){  
35.         //这里执行定时调度业务  
36.         TriggersExecLogModel triggersExecLog =new TriggersExecLogModel();  
37.         TriggersClassRelModel triggersClassRel = new TriggersClassRelModel();  
38.         triggersClassRel.setRelId(Long.valueOf(triggerName));  
39.         List list =this.getTaskSMO().queryTriggersClassRel(triggersClassRel);  
40.         triggersExecLog.setTriggerName(triggerName);  
41.         triggersExecLog.setStartDt(new Date());   
42.         HttpURLConnection http_conn = null;  
43.         Long logId= new Long(0);  
44.         if(list.size()>0){  
45.             triggersClassRel=(TriggersClassRelModel)list.get(0);  
46.             triggersExecLog.setJobName(triggersClassRel.getTriggerName());  
47.             try{  
48.                 if(triggersClassRel.getClassType()==3){  
49.                     if(triggersClassRel.getClassPara().startsWith("http")){  
50.                          logId=this.taskSMO.queryCountLogId();  
51.                          URL http_url = new URL(triggersClassRel.getClassPara());     
52.                          http_conn = (HttpURLConnection) http_url.openConnection();  
53.                          http_conn.setDoOutput(true);  
54.                          http_conn.setRequestMethod("POST");//传输用post方式  
55.                          http_conn.setRequestProperty("Content-Type","application/x-www-form-urlencoded");  
56.                          http_conn.connect();  
57.                          DataOutputStream out = new DataOutputStream(http_conn.getOutputStream());  
58.                            
59.                          String str_buf = new String();  
60.                            
61.                          str_buf="jobId="+logId;  
62.                           
63.                          out.writeBytes(str_buf);  
64.                          out.flush();  
65.                          out.close();  
66.                          int code = http_conn.getResponseCode();  
67.                     }else{  
68.                         JobMethodType.javaMethod(triggersClassRel.getClassPara());  
69.                     }  
70.                 }  
71.                 if(triggersClassRel.getClassType()==2){  
72.                     this.getTaskSMO().queryCall(triggersClassRel.getClassPara());  
73.                 }  
74.                 triggersExecLog.setLogId(logId);  
75.                 triggersExecLog.setEndDt(new Date());  
76.                 triggersExecLog.setStateCd("2");  
77.                 triggersExecLog.setRelClass(triggersClassRel.getClassPara());  
78.                 triggersExecLog.setCreateDt(new Date());  
79.                 triggersExecLog.setRemarks("调用成功");  
80.                 this.getTaskSMO().insertTriggersExecLog(triggersExecLog);  
81.             }catch(Exception e){  
82.                 e.printStackTrace();  
83.                 logId=this.taskSMO.queryCountLogId();  
84.                 triggersExecLog.setLogId(logId);  
85.                 triggersExecLog.setEndDt(new Date());  
86.                 triggersExecLog.setStateCd("3");  
87.                 triggersExecLog.setCreateDt(new Date());  
88.                 triggersExecLog.setRemarks(MsgHandleUtil.getSubStr(MsgHandleUtil.getExceptionString(e), 300));  
89.                 this.getTaskSMO().insertTriggersExecLog(triggersExecLog);  
90.             }finally{  
91.                   if(http_conn!=null)  
92.                       http_conn.disconnect();  
93.             }  
94.         }  
95.     }  
96. }  

MyQuartzJobBean：

[java] view plain copy

1. public class MyQuartzJobBean extends QuartzJobBean {  
2.   
3.     private SimpleService simpleService;  
4.       
5.     public void setSimpleService(SimpleService simpleService) {  
6.         this.simpleService = simpleService;  
7.     }  
8.   
9.     @Override  
10.     protected void executeInternal(JobExecutionContext jobexecutioncontext)  {  
11.         Trigger trigger = jobexecutioncontext.getTrigger();  
12.         String triggerName = trigger.getName();       
13.         simpleService.vsopMethod(triggerName);  
14.     }  
15.   
16. }  

SchedulerServiceImpl：

[java] view plain copy

1. package com.ai.sm.quartz.smo;  
2.   
3.   
4. import java.text.ParseException;  
5. import java.util.Date;  
6. import java.util.Map;  
7. import java.util.UUID;  
8.   
9. import org.apache.commons.lang.StringUtils;  
10. import org.apache.commons.lang.math.NumberUtils;  
11. import org.apache.commons.lang.time.DateUtils;  
12.   
13. import org.quartz.CronExpression;  
14. import org.quartz.CronTrigger;  
15. import org.quartz.JobDetail;  
16. import org.quartz.Scheduler;  
17. import org.quartz.SchedulerException;  
18. import org.quartz.SimpleTrigger;  
19. import org.springframework.beans.factory.annotation.Autowired;  
20. import org.springframework.beans.factory.annotation.Qualifier;  
21. import org.springframework.stereotype.Service;  
22.   
23.   
24. @Service("schedulerService")  
25. public class SchedulerServiceImpl implements SchedulerService {  
26.   
27.     private Scheduler scheduler;  
28.     private JobDetail jobDetail;  
29.     @Autowired  
30.     public void setJobDetail(@Qualifier("jobDetail") JobDetail jobDetail) {  
31.         this.jobDetail = jobDetail;  
32.     }  
33.   
34.     @Autowired  
35.     public void setScheduler(@Qualifier("quartzScheduler") Scheduler scheduler) {  
36.         this.scheduler = scheduler;  
37.     }  
38.   
39.   
40.     public void schedule(String cronExpression) {  
41.         schedule("", cronExpression);  
42.     }  
43.   
44.       
45.     public void schedule(String name, String cronExpression) {  
46.         schedule( name,  cronExpression,Scheduler.DEFAULT_GROUP);  
47.     }  
48.       
49.       
50.     public void schedule(String name, String cronExpression,String group) {  
51.         try {  
52.             schedule(name, new CronExpression(cronExpression),group);  
53.         } catch (ParseException e) {  
54.             throw new RuntimeException(e);  
55.         }  
56.     }  
57.   
58.       
59.     public void schedule(CronExpression cronExpression) {  
60.         schedule(null, cronExpression);  
61.     }  
62.   
63.       
64.     public void schedule(String name, CronExpression cronExpression) {  
65.         schedule( name,  cronExpression,Scheduler.DEFAULT_GROUP) ;  
66.     }  
67.       
68.       
69.     public void schedule(String name, CronExpression cronExpression,String group) {  
70.         if (name == null || name.trim().equals("")) {  
71.             name = UUID.randomUUID().toString();  
72.         }  
73.   
74.         try {  
75.             scheduler.addJob(jobDetail, true);  
76.   
77.             CronTrigger cronTrigger = new CronTrigger(name, group, jobDetail.getName(),  
78.                     Scheduler.DEFAULT_GROUP);  
79.             cronTrigger.setCronExpression(cronExpression);  
80.             scheduler.scheduleJob(cronTrigger);  
81.             scheduler.rescheduleJob(cronTrigger.getName(), cronTrigger.getGroup(), cronTrigger);  
82.               
83.         } catch (SchedulerException e) {  
84.             throw new RuntimeException(e);  
85.         }  
86.     }  
87.   
88.     public void schedule(Map<String,String> map) {  
89.           
90.         String temp = null;  
91.         SimpleTrigger simpleTrigger = new SimpleTrigger();  
92.           
93.         simpleTrigger.setJobName(jobDetail.getName());        
94.         simpleTrigger.setJobGroup(Scheduler.DEFAULT_GROUP);       
95.         simpleTrigger.setRepeatInterval(1000L);  
96.           
97.         temp = map.get("triggerName");        
98.         if (StringUtils.isEmpty(StringUtils.trim(temp)) ){  
99.             temp = UUID.randomUUID().toString();  
100.         }else{  
101.             temp +="&"+UUID.randomUUID().toString();  
102.         }  
103.         simpleTrigger.setName(temp);  
104.           
105.         temp = map.get("triggerGroup");  
106.         if(StringUtils.isEmpty(temp)){  
107.             temp = Scheduler.DEFAULT_GROUP;  
108.         }  
109.         simpleTrigger.setGroup(temp);  
110.           
111.         temp = map.get("startTime");  
112.         if(StringUtils.isNotEmpty(temp)){  
113.             simpleTrigger.setStartTime(this.parseDate(temp));  
114.         }  
115.           
116.         temp = map.get("endTime");  
117.         if(StringUtils.isNotEmpty(temp)){  
118.             simpleTrigger.setEndTime(this.parseDate(temp));  
119.         }  
120.           
121.         temp = map.get("repeatCount");  
122.         if(StringUtils.isNotEmpty(temp) && NumberUtils.toInt(temp) > 0){  
123.             simpleTrigger.setRepeatCount(NumberUtils.toInt(temp));  
124.         }  
125.           
126.         temp = map.get("repeatInterval");  
127.         if(StringUtils.isNotEmpty(temp) && NumberUtils.toLong(temp) > 0){  
128.             simpleTrigger.setRepeatInterval(NumberUtils.toLong(temp)*1000);  
129.         }  
130.   
131.         try {  
132.             scheduler.addJob(jobDetail, true);  
133.           
134.             scheduler.scheduleJob(simpleTrigger);  
135.             scheduler.rescheduleJob(simpleTrigger.getName(), simpleTrigger.getGroup(), simpleTrigger);  
136.         } catch (SchedulerException e) {  
137.             throw new RuntimeException(e);  
138.         }  
139.     }  
140.       
141.       
142.     public void pauseTrigger(String triggerName,String group){        
143.         try {  
144.             scheduler.pauseTrigger(triggerName, group);  
145.         } catch (SchedulerException e) {  
146.             throw new RuntimeException(e);  
147.         }  
148.     }  
149.       
150.       
151.     public void resumeTrigger(String triggerName,String group){       
152.         try {  
153.             //Trigger trigger = scheduler.getTrigger(triggerName, group);  
154.               
155.             scheduler.resumeTrigger(triggerName, group);  
156.         } catch (SchedulerException e) {  
157.             throw new RuntimeException(e);  
158.         }  
159.     }  
160.       
161.       
162.     public boolean removeTrigdger(String triggerName,String group){       
163.         try {  
164.             scheduler.pauseTrigger(triggerName, group);  
165.             return scheduler.unscheduleJob(triggerName, group);  
166.         } catch (SchedulerException e) {  
167.             throw new RuntimeException(e);  
168.         }  
169.     }  
170.       
171.     private Date parseDate(String time){  
172.         try {  
173.             return DateUtils.parseDate(time, new String[]{"yyyy-MM-dd HH:mm"});  
174.         } catch (ParseException e) {              
175.             throw new RuntimeException(e);  
176.         }  
177.     }  
178. }