quartz学习总结

最新推荐文章于 2025-06-18 12:52:36 发布

原创最新推荐文章于 2025-06-18 12:52:36 发布 · 980 阅读

0 ·

CC 4.0 BY-SA版权

quartz 专栏收录该内容

8 篇文章

订阅专栏

通过这篇文章先了解下quartz调度的大致内容

简单的说调度器就是：

Job：是一个接口，只有一个方法void execute(JobExecutionContext context)，开发者实现该接口定义运行任务，JobExecutionContext类提供了调度上下文的各种信息（Scheduler运行时会执行类A的excute方法），

JobDetail描述Job的实现类及其它相关的静态信息，如Job名字、描述、关联监听器等信息。

Trigger：是一个类，描述触发Job执行的时间触发规则。主要有SimpleTrigger和CronTrigger这两个子类。当仅需触发一次或者以固定时间间隔周期执行，SimpleTrigger是最适合的选择；而CronTrigger则可以通过Cron表达式定义出各种复杂时间规则的调度方案：如每早晨9:00执行，周一、周三、周五下午5:00执行等

Calendar：一个Trigger可以和多个Calendar关联

Scheduler：代表一个Quartz的独立运行容器，Trigger和JobDetail可以注册到Scheduler中，Scheduler可以将Trigger绑定到某一JobDetail中，这样当Trigger触发时，对应的Job就被执行。一个Job可以对应多个Trigger，但一个Trigger只能对应一个Job。

SchedulerContext：它类似于ServletContext，保存着Scheduler上下文信息.

JobDataMap : qrtz_job_details表JOB_DATA字段存放了相关数据

在前面部分，我们知道Job中定义了实际的业务逻辑，而JobDetail包含Job相关的配置信息。在Quartz中，每次Scheduler执行Job时，在调用其execute()方法之前，它需要先根据JobDetail提供的Job类型创建一个Job class的实例，在任务执行完以后，Job class的实例会被丢弃，Jvm的垃圾回收器会将它们回收。

因此编写Job的具体实现时，需要注意：(1) 它必须具有一个无参数的构造函数；(2) 它不应该有静态数据类型，因为每次Job执行完以后便被回收，因此在多次执行时静态数据没法被维护。

Keep moving，在JobDetail中有这么一个成员JobDataMap，JobDataMap是Java Map接口的具体实现，并添加了一些便利的方法用于存储与读取原生类型数据，里面包含了当Job实例运行时，你希望提供给它的所有数据对象。

可以借助JobDataMap为Job实例提供属性/配置，可以通过它来追踪Job的执行状态等等。对于第一种情况，可以在创建Job时，添加JobDataMap数据，在Job的execute()中获取数据，第二种，则可以在Listener中通过获取JobDataMap中存储的状态数据追踪Job的执行状态。

按例，一个简单的例子：

 // 创建Job的实例
JobDetail jobIns = JobBuilder.newJob(SimpleJob.class).withIdentity(
		"simpleJob", "group1").usingJobData("domain",
		"www.jmatrix.org").usingJobData("rank", "求别提~~~").build();

Job实现：

 public void execute(JobExecutionContext context)
			throws JobExecutionException {
	System.out.println("开始!");
 
	//……JobDataMap
	JobDataMap dataMap = context.getJobDetail().getJobDataMap();
	System.out.println("域名 : "+dataMap.getString("domain"));
	System.out.println("排名 : "+dataMap.getString("rank"));
 
	System.out.println("结束!");
}

完成了这些工作，还需决定如何存储Job的数据，Quartz提供了JobStore接口来做这件事，如果你决定将Job数据保存在内存中，则可以使用RAMJobStore，它的优点是速度快，缺点是一旦机器挂了，Job相关的数据也丢失了，如果要采用数据库来存储Job数据，可以使用JobStoreTX或JobStoreCMT，这取决于你采用的事务管理方式，使用RAMJobStore的话配置很简单，只需配置org.quartz.jobStore.class即可，如果使用数据库存储，则还需要配置driverDelegate，tablePrefix及dataSource，driverDelegate一般情况下使用StdJDBCDelegate（MySQL便可使用这个），特殊的可以使用Quartz提供的相关delegate，请查看jar包，一般命名就说明了一切。TablePrefix是你的数据库表前缀，创建数据库的sql文件可以在docs\dbTables目录下找到。最后的数据源dataSource就有点麻烦，Quartz为用户提供了三种创建dataSource的方式：

配置相关的数据库属性（driverClass，url，username，password等），让Quartz为你创建dataSource。
通过jndi使用你应用服务器管理的dataSource。
通过实现org.quartz.utils.ConnectionProvider定制自己的datasource。

前面两种都是依据datasource的名称为其配置相关的属性，具体有哪些属性可直接参考Quartz的文档。

quartz.properties 配置：

# Main Quartz configuration
#是否跳过联网检查更新
#默认会联网检查是否有更新
org.quartz.scheduler.skipUpdateCheck = true
#调度器的实例名
#可以是你喜欢的任何字符串。它用来在用到多个调度器区分特定的调度器实例
org.quartz.scheduler.instanceName = DatabaseScheduler
#调度器的实例ID
#也允许任何字符串。这个值必须是在所有调度器实例中是唯一的，尤其是在一个集群当中
#如果 Quartz 框架是运行在非集群环境中，那么自动产生的值将会是 NON_CLUSTERED
#假如是在集群环境下使用 Quartz，这个值将会是主机名加上当前的日期和时间。大多情况下，设置为 AUTO 即可
org.quartz.scheduler.instanceId = NON_CLUSTERED
#作业存储方式
#数据库存储
org.quartz.jobStore.class = org.quartz.impl.jdbcjobstore.JobStoreTX
org.quartz.jobStore.driverDelegateClass = org.quartz.impl.jdbcjobstore.StdJDBCDelegate
org.quartz.jobStore.dataSource = quartzDataSource
#org.quartz.dataSource.quartzDataSource.connectionProvider.class = cn.com.quartz.QuartzDataSource
#调度器数据库表前缀
org.quartz.jobStore.tablePrefix = QRTZ_
#线程管理类
#Quartz 自带的线程池实现类
org.quartz.threadPool.class = org.quartz.simpl.SimpleThreadPool
#处理的线程个数
org.quartz.threadPool.threadCount = 10

#这是项目启动自动到数据库加载调度任务的设置，但是我没加一样可以自动初始化，设置false无效
# org.quartz.threadPool.threadsInheritContextClassLoaderOfInitializingThread = true
# 作业存储数据库配置: JDBC jobStoreTX
#org.quartz.dataSource.quartzDataSource.driver = com.microsoft.sqlserver.jdbc.SQLServerDriver
#org.quartz.dataSource.quartzDataSource.URL = jdbc:sqlserver://192.168.1.69:1433;database=DGWEB
#org.quartz.dataSource.quartzDataSource.user = sa
#org.quartz.dataSource.quartzDataSource.password = matech
#org.quartz.dataSource.quartzDataSource.driver = oracle.jdbc.driver.OracleDriver
#org.quartz.dataSource.quartzDataSource.URL = jdbc:oracle:thin:@127.0.0.1:1521:MATECH
#org.quartz.dataSource.quartzDataSource.user = matech
#org.quartz.dataSource.quartzDataSource.password = matech

#org.quartz.dataSource.quartzDataSource.driver = com.mysql.jdbc.Driver
#org.quartz.dataSource.quartzDataSource.URL = jdbc:mysql://127.0.0.1:3306/asdb
#org.quartz.dataSource.quartzDataSource.user = root
#org.quartz.dataSource.quartzDataSource.password = 123

org.quartz.dataSource.quartzDataSource.driver = com.mysql.jdbc.Driver
org.quartz.dataSource.quartzDataSource.URL = jdbc:mysql://183.60.183.47:8098/asdb
org.quartz.dataSource.quartzDataSource.user = xoops_root
org.quartz.dataSource.quartzDataSource.password = 654321
# 最大的数据库链接数：推荐 threadCount size + 3
#org.quartz.dataSource.quartzDataSource.maxConnections = 8

#在超过它的下次触发时多少毫秒才算是错过触发
org.quartz.jobStore.misfireThreshold = 60000
#同一时刻能处理错过触发 Trigger 的最大数量
org.quartz.jobStore.maxMisfiresToHandleAtATime = 10