在web项目中有一个任务,需要灵活配置调度任务时间,并能自由启动或停止调度, 有关调度的实现可以用quartz这个开源调度组件。
在web项目中配置quartz,比如:每天凌晨几点定时运行一个程序,这只要在工程中的spring配置文件中配置好spring整合quartz的几个属性就好。
Xml代码
<bean id="sfb" class="org.springframework.scheduling.quartz.SchedulerFactoryBean">
<property name="triggers">
<list>
<ref local="bjcronTrigger" />
</list>
</property>
</bean>
<bean id="bjcronTrigger"
class="org.springframework.scheduling.quartz.CronTriggerBean">
<property name="jobDetail">
<ref bean="miJobDetail" />
</property>
<property name="cronExpression">
<value>0 0/5 1 * * ? *</value>
</property>
</bean>
<bean id="miJobDetail"
class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">
<property name="targetObject">
<ref bean="JobMethodBean" />
</property>
<property name="targetMethod">
<value>taskTimePoll</value>
</property>
</bean>
<bean id="JobMethodBean"
class="com.yinbo.entrust.service.impl.JobMethodBean">
<property name="tasktimepollManager">
<ref bean="tasktimepollManager" />
</property>
<property name="workFlowManager">
<ref bean="workFlowManager" />
</property>
</bean>
<!-- 任务定时轮询 -->
<bean id="tasktimepollDao"
class="com.mycompany.entrust.dao.impl.TasktimepollDaoHibernate"
autowire="byName" />
<bean id="tasktimepollManager"
class="com.mycompany.entrust.service.impl.TasktimepollManagerImpl">
<property name="tasktimepollDao" ref="tasktimepollDao" />
</bean>
这种配置就是对quartz的一种简单的使用了,调度任务会在spring启动的时候加载到内存中,按照bjcronTrigger中定义的crontrigger定义的时间按时触发调度任务。但是这是quartz使用“内存”方式的一种配置,也比较常见,当然对于不使用spring的项目,也可以单独整合quartz。方法也比较简单,可以从quartz的doc中找到配置方式,或者看一下《Quartz Job Scheduling Framework 》(附件中可下载)这本书中的例子。
但是对于想持久化调度任务的状态,并且灵活调整调度时间的方式来说,上面的内存方式就不能满足要求了,需要采用数据库方式集成quartz,这部分集成其实在《Quartz Job Scheduling Framework 》中也有较为详细的介绍,在spring配置quartz数据库存储方式的配置:
Xml代码
<bean id="scheduler"
class="org.springframework.scheduling.quartz.SchedulerFactoryBean">
<property name="dataSource">
<ref bean="dataSource" />
</property>
<property name="schedulerName" value="Mscheduler" />
<property name="configLocation">
<ref local="configLocationResource" />
</property>
<property name="applicationContextSchedulerContextKey"
value="applicationContextKey" />
<property name="autoStartup" value="false" />
</bean>
<bean id="configLocationResource"
class="org.springframework.core.io.ClassPathResource">
<constructor-arg value="quartz.properties"
type="java.lang.String">
</constructor-arg>
</bean>
<bean id="schedulerService"
class="cn.mycompany.mdms.scheduler.service.SchedulerServiceImpl">
<property name="scheduler">
<ref bean="scheduler" />
</property>
</bean>
<!-- 自动扫描作业服务类 -->
<bean id="monitorDirService"
class="cn.mycompany.mdms.monitordir.MonitorDirService">
<property name="adm">
<ref bean="IMAdapterManager" />
</property>
</bean>
属性说明:
dataSource:项目中用到的数据源,里面包含了quartz用到的数据库表;
schedulerName:调度器名,主要在调度集群的时候会有用,如果出现多个调度器实例的时候可以用来进行区分,详细看一下《Quartz Job Scheduling Framework 》;
configLocation:用于指明quartz的配置文件的位置,如果不用spring配置quartz的话,本身quartz是通过一个配置文件进行配置的,默认名称是quartz.properties,里面配置的参数在quartz的doc文档中都有介绍,可以调整quartz,项目中用这个文件部分的配置了一些属性,代码如下:
Java代码
#============================================================================
# Configure Main Scheduler Properties
#============================================================================
#org.quartz.scheduler.instanceName = Mscheduler
org.quartz.scheduler.instanceId = AUTO
#============================================================================
# Configure ThreadPool
#============================================================================
org.quartz.threadPool.class = org.quartz.simpl.SimpleThreadPool
org.quartz.threadPool.threadCount = 3
org.quartz.threadPool.threadPriority = 5
#============================================================================
# Configure JobStore
#============================================================================
#org.quartz.jobStore.class = org.quartz.simpl.RAMJobStore
org.quartz.jobStore.class = org.quartz.impl.jdbcjobstore.JobStoreTX
#org.quartz.jobStore.driverDelegateClass = org.quartz.impl.jdbcjobstore.StdJDBCDelegate
org.quartz.jobStore.useProperties = true
#org.quartz.jobStore.dataSource = myDS
org.quartz.jobStore.tablePrefix = QRTZ_
org.quartz.jobStore.isClustered = false
org.quartz.jobStore.maxMisfiresToHandleAtATime=1
#============================================================================
# Configure Datasources
#============================================================================
#org.quartz.dataSource.myDS.driver = com.ibm.db2.jcc.DB2Driver
#org.quartz.dataSource.myDS.URL = jdbc:db2://localhost:50000/db
#org.quartz.dataSource.myDS.user = db2
#org.quartz.dataSource.myDS.password = db2
#org.quartz.dataSource.myDS.maxConnections = 5
#============================================================================
# Configure Plugins
#============================================================================
#org.quartz.plugin.triggHistory.class = org.quartz.plugins.history.LoggingJobHistoryPlugin
#org.quartz.plugin.jobInitializer.class = org.quartz.plugins.xml.JobInitializationPlugin
#org.quartz.plugin.jobInitializer.fileNames = jobs.xml
#org.quartz.plugin.jobInitializer.overWriteExistingJobs = true
#org.quartz.plugin.jobInitializer.failOnFileNotFound = true
#org.quartz.plugin.jobInitializer.scanInterval = 10
#org.quartz.plugin.jobInitializer.wrapInUserTransaction = false
比如这里面有关数据源的配置部分就屏蔽掉了,采用spring注入datasource的方式已经进行了配置;
applicationContextSchedulerContextKey:
是org.springframework.scheduling.quartz.SchedulerFactoryBean这个类中把spring上下文以key/value的方式存放在了quartz的上下文中了,可以用applicationContextSchedulerContextKey所定义的key得到对应的spring上下文;
autoStartup:表示是否调度随工程启动自动启动,如果是false表示不自动启动,则需要调用scheduler.start()进行启动。
标签: 杂谈 |
建表,SQL语句在quartz-1.6.6\docs\dbTables文件夹中可以找到,介绍下主要的几张表:
表qrtz_job_details: 保存job详细信息,该表需要用户根据实际情况初始化
job_name:集群中job的名字,该名字用户自己可以随意定制,无强行要求
job_group:集群中job的所属组的名字,该名字用户自己随意定制,无强行要求
job_class_name:集群中个note
job实现类的完全包名,quartz就是根据这个路径到classpath找到该job类
is_durable:是否持久化,把该属性设置为1,quartz会把job持久化到数据库中
job_data:一个blob字段,存放持久化job对象
表qrtz_triggers: 保存trigger信息
trigger_name: trigger的名字,该名字用户自己可以随意定制,无强行要求
trigger_group:trigger所属组的名字,该名字用户自己随意定制,无强行要求
job_name: qrtz_job_details表job_name的外键
job_group: qrtz_job_details表job_group的外键
trigger_state:当前trigger状态,设置为ACQUIRED,如果设置为WAITING,则job不会触发
trigger_cron:触发器类型,使用cron表达式
表qrtz_cron_triggers:存储cron表达式表
trigger_name: qrtz_triggers表trigger_name的外键
trigger_group: qrtz_triggers表trigger_group的外键
cron_expression:cron表达式
表qrtz_scheduler_state:存储集群中note实例信息,quartz会定时读取该表的信息判断集群中每个实例的当前状态
instance_name:之前配置文件中org.quartz.scheduler.instanceId配置的名字,就会写入该字段,如果设置为AUTO,quartz会根据物理机名和当前时间产生一个名字
last_checkin_time:上次检查时间
checkin_interval:检查间隔时间
步骤4:
配置quartz.properties文件
# 调度标识名 集群中每一个实例都必须使用相同的名称 org.quartz.scheduler.instanceName=
scheduler#ID设置为自动获取 每一个必须不同 org.quartz.scheduler.instanceId=
AUTO#数据保存方式为持久化 org.quartz.jobStore.class =
org.quartz.impl.jdbcjobstore.JobStoreTX#数据库平台
org.quartz.jobStore.driverDelegateClass =
org.quartz.impl.jdbcjobstore.oracle.weblogic.WebLogicOracleDelegate
#数据库别名 随便取org.quartz.jobStore.dataSource = myXADS#表的前缀
org.quartz.jobStore.tablePrefix = QRTZ_#设置为TRUE不会出现序列化非字符串类到BLOB
时产生的类版本问题 org.quartz.jobStore.useProperties = true#加入集群
org.quartz.jobStore.isClustered = true#调度实例失效的检查时间间隔
org.quartz.jobStore.clusterCheckinInterval = 20000#容许的最大作业延长时间
org.quartz.jobStore.misfireThreshold = 60000#ThreadPool实现的类名
org.quartz.threadPool.class =
org.quartz.simpl.SimpleThreadPool#线程数量
org.quartz.threadPool.threadCount = 10#线程优先级
org.quartz.threadPool.threadPriority = 5#自创建父线程
org.quartz.threadPool.threadsInheritContextCla
= true #设置数据源org.quartz.dataSource.myXADS.jndiURL =CT#jbdi类名
org.quartz.dataSource.myXADS.java.naming.factory.initial =
weblogic.jndi.WLInitialContextFactory
#URLorg.quartz.dataSource.myXADS.java.naming.provider.url =
t3://localhost:7001
Quartz与Hibernate数据库连接的结合
发表日期:2008-1-5
首先介绍一下我们的系统构架,采用webwork,sPRing,hibernate整合架构,现在引入Quartz框架,Quartz和 hibernate各自拥有的自己数据库配置和连接池的配置,现在的任务是把两者用同一套配置.
先谈谈Quartz,我用的版本是1.5.1,后面的版本我没去看了,没时间,接下来说的都以这个版本为准.Quartz虽然在提供一个 ConnectionProvider接口,提供给程序扩展,但是看它的StdSchedulerFactory实现类,要对它进行扩展还是一件比较麻烦一件事情,所以我就直接修改了StdSchedulerFactory类,以达到的我的需求.
接下来的问题是既然要结合,那么让Quartz来提供连接池配置呢还是有Hibernate提供.研究了两者的连接池方面的源代码,发现 Hibernate的连接池设计远远好于Quartz,Quartz目前只提供一个连接池提供类PoolingConnectionProvider,而且使用的连接池是dbcp,这个连接池听说问题多多,相反hibernate提供了更加灵活的配置,所以连接池由Hibernate提供.
首先实现一个Quartz中ConnectionProvider子类HibernateConnectionProvider
public class HibernateConnectionProvider implements ConnectionProvider {
private Connection con = null;
protected static ThreadLocal hibernateHolder = new ThreadLocal();
public Connection getConnection() throws SQLException {
con = null;
sessionFactoryImpl sessionFactory = null;
sessionFactory = (SessionFactoryImpl) Global.getSessionFacotry();
con = sessionFactory.getConnectionProvider().getConnection();
return con;
}
public void shutdown() throws SQLException {
// FIXME Auto-generated method stub
}
}
,然后修改StdSchedulerFactory,在不破坏其本来的逻辑和可配置性下进行了相应的修改.修改的是private Scheduler instantiate() throws SchedulerException方法,找到//Set up any DataSources段进行修改,代码如下:
String[] dsNames = cfg.getPropertyGroups(PROP_DATASOURCE_PREFIX);
for (int i = 0; i < dsNames.length; i++) {
PropertiesParser pp = new PropertiesParser(cfg.getPropertyGroup(
PROP_DATASOURCE_PREFIX + "." + dsNames[i], true));
String dsDriver = pp
.getStringProperty(PROP_DATASOURCE_DRIVER, null);
String dsURL = pp.getStringProperty(PROP_DATASOURCE_URL, null);
boolean dsAlwaysLookup = pp.getBooleanProperty(
PROP_DATASOURCE_JNDI_ALWAYS_LOOKUP, false);
String dsUser = pp.getStringProperty(PROP_DATASOURCE_USER, "");
String dsPass = pp.getStringProperty(PROP_DATASOURCE_PASSWord, "");
int dsCnt = pp.getIntProperty(PROP_DATASOURCE_MAX_CONNECTIONS, 3);
String providerClass = pp.getStringProperty(
PROP_DATASOURCE_PROVIDER_CLASS, null);
String dsJndi = pp
.getStringProperty(PROP_DATASOURCE_JNDI_URL, null);
String dsJndiInitial = pp.getStringProperty(
PROP_DATASOURCE_JNDI_INITIAL, null);
String dsJndiprovider = pp.getStringProperty(
PROP_DATASOURCE_JNDI_PROVDER, null);
String dsJndiPrincipal = pp.getStringProperty(
PROP_DATASOURCE_JNDI_PRINCIPAL, null);
String dsJndiCredentials = pp.getStringProperty(
PROP_DATASOURCE_JNDI_CREDENTIALS, null);
String dsValidation = pp.getStringProperty(
PROP_DATASOURCE_VALIDATION_QUERY, null);
if (providerClass == null
providerClass.equals("")
providerClass
.equals("org.quartz.utils.PoolingConnectionProvider")) {
if (dsDriver == null) {
initException = new SchedulerException(
"Driver not specified for DataSource: "
+ dsNames[i]);
throw initException;
}
if (dsURL == null) {
initException = new SchedulerException(
"DB URL not specified for DataSource: "
+ dsNames[i]);
throw initException;
}
try {
PoolingConnectionProvider cp = new PoolingConnectionProvider(
dsDriver, dsURL, dsUser, dsPass, dsCnt,
dsValidation);
dbMgr = DBConnectionManager.getInstance();
dbMgr.addConnectionProvider(dsNames[i], cp);
} catch (SQLException sqle) {
initException = new SchedulerException(
"Could not initialize DataSource: " + dsNames[i],
sqle);
throw initException;
}
} else if (providerClass
.equals("org.quartz.utils.JNDIConnectionProvider")) {
Properties props = null;
if (null != dsJndiInitial null != dsJndiProvider
null != dsJndiPrincipal null != dsJndiCredentials) {
props = new Properties();
if (dsJndiInitial != null)
props.put(PROP_DATASOURCE_JNDI_INITIAL, dsJndiInitial);
if (dsJndiProvider != null)
props.put(PROP_DATASOURCE_JNDI_PROVDER, dsJndiProvider);
if (dsJndiPrincipal != null)
props.put(PROP_DATASOURCE_JNDI_PRINCIPAL,
dsJndiPrincipal);
if (dsJndiCredentials != null)
props.put(PROP_DATASOURCE_JNDI_CREDENTIALS,
dsJndiCredentials);
}
JNDIConnectionProvider cp = new JNDIConnectionProvider(dsJndi,
props, dsAlwaysLookup);
dbMgr = DBConnectionManager.getInstance();
dbMgr.addConnectionProvider(dsNames[i], cp);
} else if (providerClass
.equals("org.quartz.utils.HibernateConnectionProvider")) {
HibernateConnectionProvider cp = new HibernateConnectionProvider();
dbMgr = DBConnectionManager.getInstance();
dbMgr.addConnectionProvider(dsNames[i], cp);
} else {
initException = new SchedulerException(
"Provider_Class not Supported: " + providerClass);
throw initException;
}
}
最后就是修改配置文件quartz.properties,加入
#org.quartz.dataSource.myDS.provider_class = org.quartz.utils.JNDIConnectionProvider
#org.quartz.dataSource.myDS.provider_class = org.quartz.utils.PoolingConnectionProvider
org.quartz.dataSource.myDS.provider_class = org.quartz.utils.HibernateConnectionProvider加#的供参考.
spring+quartz数据库方式在web项目中整合