Quartz实现定时任务（一）

深碍√TFBOYSˉ_ 2022-08-05 15:13 224阅读 0赞

# 前言 #

有段时间没写blog了，说来惭愧，最近一直在给公司做P2P项目的服务端，但这都不是借口，高尔基曾说过（不太确定T\_T），时间就像海绵里的水，只要愿意挤总是有的！所以写博客的节奏还是必须脉动回来，必须养成不断学习，不断记录，不断总结的好习惯。废话不多说，最近需要做一些服务器端的定时任务，决定使用Quartz去实现，之前也没接触过，所以就边学边做了，顺便把这个过程记录下来。

# 初识Quartz #

首先看一下百科中对Quartz的简介：Quartz是OpenSymphony开源组织在Job scheduling领域又一个开源项目，它可以与J2EE与J2SE应用程序相结合也可以单独使用。Quartz可以用来创建简单或为运行十个，百个，甚至是好几万个Jobs这样复杂的程序。Jobs可以做成标准的Java组件或 EJBs。Quartz的最新版本为Quartz 2.2.1。

没错，Quartz是一个由Java编写的开源的任务调度框架。目前已发布的最新版本是2.2.1，下载地址：

[http://www.quartz-scheduler.org/downloads][http_www.quartz-scheduler.org_downloads]

下载完成后可以看到如下的结构图，

![SouthEast][]

我们使用Quartz时需要在lib文件夹下拷出核心jar包（quartz-2.2.1.jar）添加到我们项目的classpath下，然后就可以使用Quartz的相关API了，下来我们根据官方的在线教程来快速的体验一下Quartz。但在使用之前首先我们需要了解关于Quartz的3个核心接口，分别是：Job、Trigger和Scheduler。简单的讲，Job就代表我们需要调度的任务，Trigger就是触发任务的触发器，而Scheduler就是用来绑定Job和Trigger并执行任务。首先，我们需要准备一个Job，

package com.test;
    
    import java.util.Date;
    
    import org.quartz.Job;
    import org.quartz.JobExecutionContext;
    import org.quartz.JobExecutionException;
    
    public class SimpleJob implements Job {
    
    	@Override
    	public void execute(JobExecutionContext jobCtx)
    			throws JobExecutionException {
    		// TODO Auto-generated method stub
    		System.out.println("Triggered. Time is " + new Date());
    	}
    
    }

让我们自己的Job类实现Job接口并重写execute方法，在这个方法中去写我们需要定时调用的业务逻辑代码，这里仅仅打印了当前时间。接下来我们就可以写一个测试类去执行这个Job了，当然还缺少2个关键的对象，我们需要一个Trigger去触发Job，还需要一个Scheduler去管理Job、Trigger并执行他们，参考一下官方教程中实例化Scheduler的方法，

SchedulerFactory schedFact = new org.quartz.impl.StdSchedulerFactory(); 
      Scheduler sched = schedFact.getScheduler(); 
      sched.start();

可以看到是通过SchedulerFactory去得到的Scheduler的实例，并通过start方法启动调度。接下来是实例化Job，依旧参考官方教程中的代码，

// define the job and tie it to our HelloJob class      
      JobDetail job = newJob(SimpleJob.class)      
          .withIdentity("myJob", "group1") // name "myJob", group "group1"      
          .build();

这里又见到了一个新的接口——JobDetail，其实Quartz在每次执行Job的时候都会重新创建一个Job实例，所以它不是直接接收一个Job的实例，而是接收一个Job的实现类，以便运行时通过newInstance方法的反射调用机制去实例化Job。在2.2.x的版本中不能直接使用构造方法，而是需要通过JobBuilder去实例化JobDetail对象，如上代码所示，通过静态导入引入了JobBuilder类并通过其静态方法newJob去实例化了JobDetail对象。现在还缺少一个Trigger去触发Job，那么继续参考教程中的代码，

// Trigger the job to run now, and then every 40 seconds      
      Trigger trigger = newTrigger()      
          .withIdentity("myTrigger", "group1")      
          .startNow()      
          .withSchedule(simpleSchedule()      
              .withIntervalInSeconds(5)      
              .repeatForever())                  
          .build();

可以看到写法上都很类似，通过TriggerBuilder.newTrigger()方法实例化Trigger对象，其实Trigger有2个子类，分别是SimpleTrigger和CronTrigger，SimpleTrigger适用于执行一次或者固定间隔周期性执行，而CronTrigger则可以通过Cron表达式定义出各种复杂的调用方案，例如每周周三执行、每天下午6点执行等等。我这里设置的5秒调用一次，repeatForever也就是无限调用了，万事俱备只欠东风，最后通过Scheduler绑定执行Job和Trigger即可，

// Tell quartz to schedule the job using our trigger 
      sched.scheduleJob(job, trigger);

最后看一下Test类中的完整代码并运行程序：

package com.test;
    
    import org.quartz.JobBuilder;
    import org.quartz.JobDetail;
    import org.quartz.Scheduler;
    import org.quartz.SchedulerException;
    import org.quartz.SimpleScheduleBuilder;
    import org.quartz.Trigger;
    import org.quartz.TriggerBuilder;
    import org.quartz.impl.StdSchedulerFactory;
    
    public class Test04 {
    
    	public static void main(String[] args) {
    		try {
    			// Grab the Scheduler instance from the Factory
    			Scheduler scheduler = StdSchedulerFactory.getDefaultScheduler();
    			scheduler.start();
    
    			// Job
    			JobDetail job = JobBuilder.newJob(SimpleJob.class)
    					.withIdentity("myTrigger", "group1").build();
    
    			// Trigger
    			Trigger trigger = TriggerBuilder
    					.newTrigger()
    					.withIdentity("trigger1", "group1")
    					.startNow()
    					.withSchedule(
    							SimpleScheduleBuilder.simpleSchedule()
    									.withIntervalInSeconds(5).repeatForever())
    					.build();
    			
    
    			scheduler.scheduleJob(job, trigger);
    		} catch (SchedulerException se) {
    			se.printStackTrace();
    		}
    	}
    }

运行之后可以看到控制台会每隔5S打印一次输出语句，

![SouthEast 1][]

# 总结 #

本篇blog算是对Quartz的入门，了解了三个关键性的基础概念：任务（Job）、触发器（Trigger）和调度器（Scheduler），在实际项目中一般我们都会在web项目中去执行一些定时任务，后序的blog会介绍Quartz整合到Spring中从而实现服务器端的定时任务以及关于Quartz的一些高级特性，敬请关注。

[http_www.quartz-scheduler.org_downloads]: http://www.quartz-scheduler.org/downloads
[SouthEast]: /images/20220805/1bcea2adbb76464cb950ba6a7ce83492.png
[SouthEast 1]: /images/20220805/195cd6578a894123af4358f6c98ab9bf.png