下载、设置和运行Quartz(GUI)图形界面程序----Quartz Web
一、获取Quartz Web程序(Quartz GUI)。
早期的 Quartz 框架开发者意识到一个 GUI 对于某类用户群体是必需的。几年前,一个 Web 应用被创立,它可用于管理 Quartz 框架。虽说是历经了几年有相当投入的开发,但不得不说的,总是时断时续的。近来出现有更多的要求对这个应用的更新与支持,因而又重新吸引了新的开发者自愿的工作并使之保持不断更新。这个应用就是知名的 Quartz Web 程序。Quartz Web 程序是作为 OpenSymphony 上 Quartz 源程序库的一部分。它曾经是放在 SourceForge 上的,但最近已迁移到新家了(译者注:在 SourceForge 仍可下载到)。旧的站点是 http://sourceforge.net/projects/quartz;新的站点(包括 Quartz Web 程序) 可在 http://www.quartz-scheduler.org/community/repository.html 上找到。
当前,还没有 Web 程序的二进制版,而且标准的 Quartz 下载中也不包括 Web 程序,所以你需要进入quartz的SVN(http://svn.terracotta.org/svn/quartz)源代码树下的webapp目录即为Quartz Web 的源码目录,下载到 Quartz 源代码树并使用 quartz/webapp目录下的 Ant 或Maven构建文件来构建这个 Web 程序。
最新版的quartz web采用了struts2+freemarker+spring2.5的架构,还用到了开源的sitemesh和dwr,并在web.xml中设置用org.quartz.ui.web.init.DefinitionInitializer启动quartz,具体设置如下:
<servlet>
<servlet-name>DefinitionInitializer</servlet-name>
<servlet-class>
org.quartz.ui.web.init.DefinitionInitializer
</servlet-class>
<init-param>
<param-name>definition-file</param-name>
<param-value>(PATH_TO_DEFINITIONS_FILE)</param-value>
<!--
if (PATH_TO_DEFINITIONS_FILE) is left as such, definitions are loaded from
/WEB-INF/classes/JobDefinitions.xml
-->
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
二、修改设置。
运行quartz/webapp 目录下的 Ant 或Maven构建文件来构建这个 Web 程序,会得到一各为quartz.war的包,但在打包前我们应该修改其默认设置。默认下Quartz Web是被设置内存(非持久化) 存储,如果要改为数据库存诸则须修改quartz的设置文件quartz.properties,为其配置jdbc(需用到dbcp连接池,所以另需加入commons-dbcp和commons-pool包)数据源或JNDI数据。
下面为jobStore各种设置:
1、内存存储:
org.quartz.jobStore.misfireThreshold = 60000
org.quartz.jobStore.class = org.quartz.simpl.RAMJobStore
2、JDBC数据源(本例为oracle数据库,不同的数据库只要修改org.quartz.jobStore.driverDelegateClass的值为对应的数据库即可):
org.quartz.jobStore.misfireThreshold = 60000
org.quartz.jobStore.class = org.quartz.impl.jdbcjobstore.JobStoreTX
org.quartz.jobStore.driverDelegateClass = org.quartz.impl.jdbcjobstore.oracle.OracleDelegate
#org.quartz.jobStore.driverDelegateClass = org.quartz.impl.jdbcjobstore.DB2v7Delegate
org.quartz.jobStore.dataSource = myDS
org.quartz.jobStore.tablePrefix = QRTZ_
org.quartz.jobStore.isClustered = false
org.quartz.dataSource.myDS.driver = oracle.jdbc.driver.OracleDriver
org.quartz.dataSource.myDS.URL = jdbc:oracle:thin:@polarbear:1521:dev
org.quartz.dataSource.myDS.user = quartz
org.quartz.dataSource.myDS.password = quartz
org.quartz.dataSource.myDS.maxConnections = 5
3、JNDI数据源(本例为oracle数据库,不同的数据库只要修改org.quartz.jobStore.driverDelegateClass的值为对应的数据库即可):
org.quartz.jobStore.misfireThreshold = 60000
org.quartz.jobStore.class = org.quartz.impl.jdbcjobstore.JobStoreTX
org.quartz.jobStore.driverDelegateClass = org.quartz.impl.jdbcjobstore.oracle.OracleDelegate
#org.quartz.jobStore.driverDelegateClass = org.quartz.impl.jdbcjobstore.DB2v7Delegate
org.quartz.jobStore.dataSource = myDS
org.quartz.jobStore.tablePrefix = QRTZ_
org.quartz.jobStore.isClustered = false
org.quartz.dataSource.myDS.jndiURL = java:comp/env/jdbc/JNDITEMP
Quartz Web程序通过插件的形式设置日志记录和自动加载job配置文件,具体如下:
1、日志记录插件:
org.quartz.plugin.triggHistory.class = org.quartz.plugins.history.LoggingJobHistoryPlugin
2、用插件org.quartz.plugins.xml.JobInitializationPlugin加载job配置文件,org.quartz.plugin.jobInitializer.fileNames指定了位于classpath下的job配置文件的名称,这里配置了两个插件,分别指定了三个job配置文件jobs.xml、jobs2.xml,jobs3.xml:
org.quartz.plugin.jobInitializer.class = org.quartz.plugins.xml.JobInitializationPlugin
# init plugin will load jobs.xml as a classpath resource i.e. /jobs.xml if not found on file system
org.quartz.plugin.jobInitializer.fileNames=jobs.xml
org.quartz.plugin.jobInitializer.overWriteExistingJobs = false
org.quartz.plugin.jobInitializer.failOnFileNotFound = false
org.quartz.plugin.jobInitializer.scanInterval = 30
# org.quartz.plugin.jobInitializer.wrapInUserTransaction = true
org.quartz.plugin.jobInitializerMultiple.class = org.quartz.plugins.xml.JobInitializationPlugin
# init plugin will load jobs.xml as a classpath resource i.e. /jobs.xml and jobs2.xml if not found on file system
org.quartz.plugin.jobInitializerMultiple.fileNames=jobs2.xml,jobs3.xml
org.quartz.plugin.jobInitializerMultiple.overWriteExistingJobs = false
org.quartz.plugin.jobInitializerMultiple.failOnFileNotFound = false
# org.quartz.plugin.jobInitializerMultiple.wrapInUserTransaction = true
Quartz Web程序通过JobDefinitions.xml来默认加载常用的job的定义,默认定义了三种quartz内置的job,分别为:
org.quartz.jobs.NativeJob
org.quartz.jobs.NoOpJob
org.quartz.jobs.ee.mail
下面是Quartz内置的的各种job:
Job 类 | Job 用法 |
org.quartz.jobs.FileScanJob | 检查某个指定文件是否变化,并在文 件被改变时通知到相应监听器的 Job |
org.quartz.jobs.FileScanListener | 在文件被修改后通知 FileScanJob 的监听器 |
org.quartz.jobs.NativeJob | 用来执行本地程序(如 windows 下 .exe 文件) 的 Job |
org.quartz.jobs.NoOpJob | 什么也不做,但用来测试监听器不是很有用的。 一些用户甚至仅仅用它来导致一个监听器的运行 |
org.quartz.jobs.ee.mail.SendMailJob | 使用 JavaMail API 发送 e-mail 的 Job |
org.quartz.jobs.ee.jmx.JMXInvokerJob | 调用 JMX bean 上的方法的 Job |
org.quartz.jobs.ee.ejb.EJBInvokerJob | 用来调用 EJB 上方法的 Job |
三、运行。将打包好的war包部署到服务上,访问http://localhost:8080/quartz,然后用默认用户名:quartz 密码:quartz 登陆便可激忿进入系统。用户名和密码可在applicationContext.xml中修改,具体如下:
<bean id="authenticator" class="org.quartz.ui.web.security.SimpleAuthenticator">
<property name="username">
<value>quartz</value>
</property>
<property name="password">
<value>quartz</value>
</property>
</bean>
Quartz Web 程序的截屏
1、Quartz Web 程序主界面的左上方展示了它所拥有的特征列表
2、Scheduler 控制界面,允许你启动、停止和暂停 Scheduler
四、与现有Web程序结合(我已结合过,可行)。
我们也可将Quartz web加入到现有的web程序中,具体做法为:
1、将Quartz web的所有jar包和设置文件和页面文件copy至现有Web工程中。
2、合并各设置文件(主要是:web.xml、struts.xml和applicationContext.xml等)
3、修改Quartz web各程序的访问的命名空间。
4、Quartz web并不完善,有好多明显的错误,好多页面有错误需要修改后才能通过gui成功配置各调度