Quartz作业调度框架（简单实用）

一、Quartz是什么？

Quartz 是一个开源的作业调度框架，它完全由 Java 写成，并设计用于 J2SE 和 J2EE 应用中。它提供了巨大的灵 活性而不牺牲简单性。你能够用它来为执行一个作业而创建简单的或复杂的调度。Quartz是 OpenSymphony 开源组织在Job scheduling（工作调度/工作安排）领域又一个开源项目，Quartz可以用来创建简单或为运行十个，百个，甚至是好几万个Jobs这样复杂的程序。Jobs可以做成标准的Java组件或 EJBs。

二、Quartz 核心组成

• 调度器：Scheduler：代表一个 quartz 的独立运行容器。Trigger 和 JobDetail 可以注册到 Scheduler 中。Scheduler 可以将 Trigger 绑定到某一 JobDetail 上，这样当 Trigger 被触发时，对应的 Job 就会执行。一个 Job 可以对应多个 Trigger，但一个 Trigger 只能对应一个 Job 。
• 任务job：是一个接口，有一个方法 void execute()，可以通过实现该接口来定义需要执行的任务
• 触发器：Trigger，包括 SimpleTrigger 和 CronTrigger 描述触发 Job 执行的时间触发规则，实现类 SimpleTrigger 和 CronTrigger 可以通过crom 表达式定义出各种复杂的调度方案。

三、Springboot整合Quartz案例

1.添加依赖

<dependency>
  <groupId>org.quartz-scheduler</groupId>
  <artifactId>quartz</artifactId>
  <version>2.3.2</version>
</dependency>

2、实现Job接口

//Job中的任务有可能并发执行，例如任务的执行时间过长，而每次触发的时间间隔太短，则会导致任务会被并发执行。如果是并发执行，就需要一个数据库锁去避免一个数据被多次处理。
@DisallowConcurrentExecution
public class TestJob implements Job {

    @Override
    public void execute(JobExecutionContext jobExecutionContext) throws JobExecutionException {
        System.out.println("===========您已成功运行定时任务===========");
        System.out.println(jobExecutionContext.getJobDetail().getKey());
    }
}

如果需要实现业务逻辑的话，实在execute中去实现我们的业务逻辑

3、创建Controller

import com.example.bootquartz.config.QuartzJob;
import io.swagger.annotations.ApiOperation;
import org.quartz.*;
import org.quartz.impl.StdSchedulerFactory;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.bind.annotation.RestController;

import java.io.IOException;
import java.text.SimpleDateFormat;
import java.util.Date;

@RestController
public class QuartzHandler {
    SchedulerFactory schedulerFactory = null;
    Scheduler scheduler = null;

    public QuartzHandler() throws SchedulerException {
        schedulerFactory = new StdSchedulerFactory();
        scheduler = schedulerFactory.getScheduler();
    }

    @PostMapping("/quartz")
    @ApiOperation(value = "定时任务_创建", notes = "创建")
    @ResponseBody
    public Object quartz(@RequestParam("orderNo")  String orderNo) throws Exception {
        Date start=new Date(System.currentTimeMillis() + 7 * 1000);//当前时间7秒之后

        /**
       	 * 通过JobBuilder.newJob()方法获取到当前Job的具体实现(以下均为链式调用)
         * 这里是固定Job创建，所以代码写死XXX.class（本案例中是：TestJob .class）
         * 如果是动态的，根据不同的类来创建Job ，利用反射来创建，则 ((Job)Class.forName("com.chenxin.job.TestJob").newInstance()).getClass()
         * 即是 JobBuilder.newJob(((Job)Class.forName("com.chenxin.job.TestJob").newInstance()).getClass())
         * */
        //创建人物明细
        JobDetail jobDetail = JobBuilder.newJob(QuartzJob.class)
                /**给当前JobDetail添加参数，K V形式*/
                .usingJobData("name","zy")
                /**给当前JobDetail添加参数，K V形式，链式调用，可以传入多个参数，在Job实现类中，可以通过jobExecutionContext.getJobDetail().getJobDataMap().get("age")获取值*/
                .usingJobData("age",23)
                /**添加认证信息 ，进行触发器的命名分组，有3种重写的方法，这里是其中一种*/
                .withIdentity("job1","group1")
                .build();//执行
/**
 *		JobDetail jobDetail = JobBuilder.newJob(QuartzJob.class)
 *      			     /**给当前JobDetail添加参数，K V形式*/
 *        			    .usingJobData("name","zy")
 *       			    /**给当前JobDetail添加参数，K V形式，链式调用，可以传入多个参数，在Job实现类中，可以通过jobExecutionContext.getJobDetail().getJobDataMap().get("age")获取值*/
 *       				 .usingJobData("age",23)
 *     			  /**添加认证信息 ，进行触发器的命名分组，有3种重写的方法，这里是其中一种*/
 *    			  .withIdentity("job2","group2")
 *  			   .build();//执行
 *
 */

		//创建触发器
        Trigger trigger = TriggerBuilder.newTrigger()
                /**给当前JobDetail添加参数，K V形式，链式调用，可以传入多个参数，在Job实现类中，可以通过jobExecutionContext.getTrigger().getJobDataMap().get("orderNo")获取值*/
                .usingJobData("orderNo", orderNo)
                /**添加认证信息，进行触发器的命名分组，有3种重写的方法，我这里是其中一种，可以查看源码看其余2种*/
                .withIdentity("trigger1","group1")
                /**立即生效*/
//      .startNow()
                /**开始执行时间，此处在开头延迟七秒*/
                .startAt(start)
                /**结束执行时间*/
//        .endAt(start)
                /**添加执行规则，SimpleTrigger、CronTrigger的区别主要就在这里*/
                .withSchedule(
                        SimpleScheduleBuilder.simpleSchedule()
                                /**每3s执行一次*/
                                .withIntervalInSeconds(3)
                                /**一直执行，*/
                                .repeatForever()
                )
                .build();//执行

        /**添加定时任务*/
        scheduler.scheduleJob(jobDetail, trigger);
        if (!scheduler.isShutdown()) {
            /**启动*/
            scheduler.start();
        }
        System.err.println("--------定时任务启动成功 "+new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new Date())+" ------------");
        return "ok";
    }
 }

总结

提示：这里对文章进行总结：

这里面的cron的表达式可以通过此在线连接去生成：在线生成cron表达式的工具