Quartz定时任务框架（一）

1.Quartz简介

1.1.什么是Quartz？

Quartz是一个开源的任务调度框架。它是OpenSymphony开源组织在Job scheduling领域又一个开源项目。

“任务进度管理器”就是一个在预先被纳入日程，当时间到达时，负责执行（或者通知）其他软件组件的系统。 简单来说就是实现“计划(或定时)任务”的系统，例如：订单下单后未付款，15分钟后自动撤消订单，并自动解锁锁定的商品。

官网：http://www.quartz-scheduler.org
参考：https://github.com/dufyun/quartz-core-learning

1.2. Quartz可以用来做什么？

Quartz是一个任务调度框架。比如你遇到这样的问题：

• 想每月11号自动提示信用卡还款金额；每月28号，信用卡自动还款。
• 订单下单后未付款，15分钟后自动撤消订单，并自动解锁锁定的商品。
• 想每年4月1日自己给当年暗恋女神发一封匿名贺卡。
• 想每隔1小时，备份一下自己的爱情动作片、学习笔记到云盘。
• 医院系统11点才能开放挂号。
• 企业中如每天凌晨2点触发数据同步、发送Email等操作。
• ……
  这些问题总结起来就是：在某一个有规律的时间点干某件事。并且时间的触发的条件可以非常复杂（比如每月最后一个工作日的17:50），复杂到需要一个专门的框架来干这个事。Quartz就是来干这样的事，你给它一个触发条件的定义，它负责到了时间点，触发相应的Job起来干活。

1.3. 同类型框架有哪些？

TimeTask： 在Quartz前还是显得过于简单、不完善，不能直接满足开发者的较为复杂的应用场景。
Elastic-Job： 当当网推出的分布式定时任务框架。
TBSchedule： Alibaba开发的分布式定时任务框架。

2. 入门案例

2.1. 导入依赖包

<dependency>
	<groupId>org.quartz-schedulergroupId>
	<artifactId>quartzartifactId>
	<version>2.3.0version>
dependency>
<dependency>
	<groupId>org.quartz-schedulergroupId>
	<artifactId>quartz-jobsartifactId>
	<version>2.3.0version>
dependency>

什么时候干什么事情

2.2. 创建自定义任务类，实现Job接口

创建任务类，实现Job接口，重写execute()方法。

public class HelloJob implements Job {
	@Override
	public void execute(JobExecutionContext context) throws JobExecutionException {
		//获取context上下文中的JobDetail对象
		JobDetail jobDetail = context.getJobDetail();
		//获取JobDetail对象中name属性的值
		String name = jobDetail.getJobDataMap().getString("name");
		System.out.println(name);
	}
}

注1：关注execute()方法中的context上下文参数。
注2：execute()方法主要用于根据业务需求编写业务逻辑代码，比如：发短信。

2.3. 编写测试类

编写JUnit单元测试类：

@Test
public void test1(){
    try {
        //1.定义JobDetail，将HelloJob类添加到JobDetail对象中（添加到Job清单）
        JobDetail jobDetail = JobBuilder.newJob(HelloJob.class)
                .withDescription("Job的描述")
                //定义JobDetail的JobDetail 'group1.job1':  jobClass: 'com.xr.quartz.HelloJob
                .withIdentity("helloJob", "jobGroup1")
                //定义JobDetail中的属性(可选)
                .usingJobData("name", "admin")
				.usingJobData("age",18)
                .build();

        //2.定义Trigger触发器，使用简单触发器，设置name/group
        //Date startTime = new Date(System.currentTimeMillis() + 3*1000L); 3秒后启动任务
        Trigger trigger = TriggerBuilder.newTrigger()
                .withDescription("触发器的描述")
				//触发器名，组名（与任务组group1不是一个）
                .withIdentity("trigger1", "TriggerGroup1")
                //立即启动（默认），如设为某一时间再启动使用：.startAt(statTime)
                .startNow()
                //.withSchedule(SimpleScheduleBuilder.simpleSchedule() //创建简单触发器，使用SimpleTrigger
                //.withIntervalInSeconds(5) //每隔5秒执行
                //.withRepeatCount(2))      //执行2次（加上第一次执行的会显示3次）
                //.repeatForever())         //一直执行，奔腾到老不停歇
                //.build();
                .withSchedule(CronScheduleBuilder.cronSchedule("0/5 * * * * ?"))
                .build();

        //3.创建scheduler调度器
        Scheduler scheduler = StdSchedulerFactory.getDefaultScheduler();
        scheduler.scheduleJob(jobDetail, trigger);
		//启动调度器
        scheduler.start(); 

        //运行一段时间后关闭
        Thread.sleep(20000);

        //4.关闭任务调度
        scheduler.shutdown(true);
    } catch (Exception e) {
        e.printStackTrace();
    }
}

上述例子很好的覆盖了Quartz最重要的3个基本要素：

• Scheduler： 调度器。所有的调度都是由它控制。
• Trigger：定义触发的条件。例子中，它的类型是SimpleTrigger，每隔1秒中执行一次（什么是SimpleTrigger下面会有详述）。
• JobDetail & Job： JobDetail 定义的是任务数据（清单），而真正的执行逻辑是在Job中，例子中是HelloJob。

为什么设计成JobDetail + Job，不直接使用Job？
这是因为任务是有可能并发执行，如果Scheduler直接使用Job，就会存在对同一个Job实例并发访问的问题。而JobDetail & Job 方式，sheduler每次执行，都会根据JobDetail创建一个新的Job实例，这样就可以规避并发访问的问题。