首页手记 Quartz任务调度资料：新手入门教程

Quartz任务调度资料：新手入门教程

标签：

Java 架构运维

概述

Quartz是一个开源的任务调度框架，支持多种触发器类型并具有高灵活性和可靠性。本文将详细介绍Quartz任务调度的功能、应用场景以及如何使用Quartz进行任务调度和持久化。此外，文章还将探讨Quartz在分布式环境下的部署和常见问题的解决方案。

Quartz简介

Quartz是什么

Quartz是一个开源的、灵活的、强大的作业调度框架，它使用Java编写，可以在任何有JVM的环境中运行。Quartz可以用来创建定期执行的任务，支持多种触发器类型，如简单触发器、日历触发器以及基于Cron表达式的触发器。Quartz还是一个轻量级的库，可以无缝集成到任何Java应用程序中，无论是Web应用、桌面应用还是嵌入式系统。

Quartz的作用和应用场景

Quartz在多种应用场景中发挥重要作用。例如：

定时任务：可以定期执行数据库备份任务、发送定时邮件、统计访问日志等。
周期性任务：例如每日一次的任务，如数据清理、数据归档等。
时间敏感任务：如股票交易系统中的高频交易任务。
分布式任务：在分布式系统中，Quartz可以实现任务的分布式调度，提高系统的灵活性和可靠性。

Quartz与其他任务调度框架的比较

Quartz和其他任务调度框架相比，有以下几个特点：

灵活性：Quartz提供了多种触发器类型，能够满足不同应用场景的需求。
可靠性：Quartz支持任务持久化，即使在系统重启后也能恢复任务调度。
可扩展性：Quartz能够很容易地集成到各种Java应用程序中，支持集群部署。

相比之下，例如Spring Task或Java自带的Timer类，它们的功能相对简单，灵活性和可靠性不如Quartz。

Quartz快速入门

安装与环境配置

首先，需要在项目中引入Quartz的依赖。这里以Maven为例，需要在项目的pom.xml文件中添加Quartz的依赖：

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

安装完成后，可以创建简单的Java项目，并在项目中引入上述依赖。

创建第一个Quartz任务

首先，定义一个实现了org.quartz.Job接口的任务类：

import org.quartz.Job;
import org.quartz.JobExecutionContext;
import org.quartz.JobExecutionException;

public class HelloJob implements Job {
    @Override
    public void execute(JobExecutionContext context) throws JobExecutionException {
        System.out.println("Hello, Quartz!");
    }
}

然后，定义触发器和调度器来启动任务：

import org.quartz.JobBuilder;
import org.quartz.JobDetail;
import org.quartz.Scheduler;
import org.quartz.SchedulerFactory;
import org.quartz.TriggerBuilder;
import org.quartz.Trigger;

public class QuartzExample {
    public static void main(String[] args) throws Exception {
        // 创建作业详情
        JobDetail job = JobBuilder.newJob(HelloJob.class)
                .withIdentity("myJob")
                .build();

        // 创建触发器
        Trigger trigger = TriggerBuilder.newTrigger()
                .withIdentity("myTrigger")
                .startNow()
                .withSchedule(SimpleScheduleBuilder.simpleSchedule()
                        .withIntervalInSeconds(5)
                        .repeatForever())
                .build();

        // 创建调度器工厂并获取调度器实例
        SchedulerFactory factory = new StdSchedulerFactory();
        Scheduler scheduler = factory.getScheduler();
        scheduler.start();
        scheduler.scheduleJob(job, trigger);
    }
}

运行与调试

运行上述代码，可以在控制台看到“Hello, Quartz!”的信息。每5秒钟输出一次，直到程序结束。

Quartz任务的触发器与调度器

触发器的类型

Quartz提供了多种触发器类型，每种类型都有其特定的用途和功能：

SimpleTrigger：用于执行一次或多次重复执行的任务。例如，要执行一个每5秒钟运行一次的任务，可以使用SimpleScheduleBuilder配置：

Trigger trigger = TriggerBuilder.newTrigger()
      .withIdentity("myTrigger")
      .startNow()
      .withSchedule(SimpleScheduleBuilder.simpleSchedule()
              .withIntervalInSeconds(5)
              .repeatForever())
      .build();

CronTrigger：基于Cron表达式的触发器，可以用于更复杂的调度需求。例如，要每天凌晨执行一次任务，可以使用如下配置：

Trigger trigger = TriggerBuilder.newTrigger()
      .withIdentity("myTrigger")
      .withSchedule(CronScheduleBuilder.cronSchedule("0 0 0 * * ?"))
      .build();

CalendarIntervalTrigger：基于间隔时间的触发器，可以指定任务执行的时间间隔。例如，要每10分钟执行一次任务，可以使用如下配置：

Trigger trigger = TriggerBuilder.newTrigger()
      .withIdentity("myTrigger")
      .startNow()
      .withSchedule(CalendarIntervalScheduleBuilder.calendarIntervalSchedule()
              .withIntervalInMinutes(10))
      .build();

任务调度的触发规则

任务调度的触发规则可以很灵活，可以通过不同的触发器类型和配置来实现。例如，使用SimpleScheduleBuilder来定义任务的执行时间和频率：

Trigger trigger = TriggerBuilder.newTrigger()
        .withIdentity("myTrigger")
        .startNow()
        .withSchedule(SimpleScheduleBuilder.simpleSchedule()
                .withIntervalInSeconds(5)
                .repeatForever())
        .build();

通过上述代码，任务将在启动后每5秒钟执行一次。

调度器的使用方法

调度器是Quartz框架的核心部分，它负责管理和执行任务。通过调度器，可以启动、停止、暂停和恢复任务。

import org.quartz.JobBuilder;
import org.quartz.JobDetail;
import org.quartz.Scheduler;
import org.quartz.SchedulerFactory;
import org.quartz.Trigger;
import org.quartz.TriggerBuilder;

public class SchedulerExample {
    public static void main(String[] args) throws Exception {
        SchedulerFactory factory = new StdSchedulerFactory();
        Scheduler scheduler = factory.getScheduler();
        scheduler.start();

        JobDetail job = JobBuilder.newJob(HelloJob.class)
                .withIdentity("myJob")
                .build();

        Trigger trigger = TriggerBuilder.newTrigger()
                .withIdentity("myTrigger")
                .startNow()
                .withSchedule(SimpleScheduleBuilder.simpleSchedule()
                        .withIntervalInSeconds(5)
                        .repeatForever())
                .build();

        scheduler.scheduleJob(job, trigger);
    }
}

Quartz任务的持久化

任务持久化的必要性

任务持久化是任务调度框架中的一个重要特性。持久化可以确保在系统重启或故障后，任务仍然可以按照预期执行。持久化任务的状态可以存储在数据库中，确保任务的状态可以被恢复。

使用数据库存储任务和触发器

为了实现任务持久化，需要配置Quartz使用数据库来存储任务和触发器信息。首先在项目中引入数据库驱动依赖，这里以MySQL为例：

<dependencies>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.23</version>
    </dependency>
</dependencies>

接下来，配置Quartz使用数据库：

import org.quartz.Scheduler;
import org.quartz.SchedulerFactory;
import org.quartz.impl.StdSchedulerFactory;

public class DatabasePersistenceExample {
    public static void main(String[] args) throws Exception {
        Properties props = new Properties();
        props.setProperty("org.quartz.scheduler.instanceName", "MyScheduler");
        props.setProperty("org.quartz.threadPool.threadCount", "5");
        props.setProperty("org.quartz.jobStore.class", "org.quartz.impl.jdbcjobstore.JobStoreTX");
        props.setProperty("org.quartz.jobStore.driverDelegateClass", "org.quartz.impl.jdbcjobstore.StdJDBCDelegate");
        props.setProperty("org.quartz.jobStore.useProperties", "true");
        props.setProperty("org.quartz.jobStore.misfireThreshold", "60000");
        props.setProperty("org.quartz.jobStore.tablePrefix", "QRTZ_");
        props.setProperty("org.quartz.jobStore.isClustered", "true");
        props.setProperty("org.quartz.jobStore.clusterCheckinInterval", "15000");
        props.setProperty("org.quartz.jobStore.maxMisfiresToCheck", "50");
        props.setProperty("org.quartz.jobStore.selectWithLockSQL", "SELECT * FROM {0} WHERE SCHED_NAME = ? FOR UPDATE");
        props.setProperty("org.quartz.jobStore.txIsolationLevelName", "READ_COMMITTED");
        props.setProperty("org.quartz.jobStore.useSerializedColumns", "false");
        props.setProperty("org.quartz.scheduler.instanceId", "AUTO");
        props.setProperty("org.quartz.scheduler.instanceName", "MyScheduler");
        props.setProperty("org.quartz.scheduler.timeZone", "Asia/Shanghai");
        props.setProperty("org.quartz.threadPool.class", "org.quartz.simpl.SimpleThreadPool");
        props.setProperty("org.quartz.threadPool.threadCount", "5");
        props.setProperty("org.quartz.threadPool.threadPriority", "5");
        props.setProperty("org.quartz.threadPool.threadsInPool", "5");
        props.setProperty("org.quartz.jobStore.class", "org.quartz.impl.jdbcjobstore.JobStoreTX");
        props.setProperty("org.quartz.jobStore.driverDelegateClass", "org.quartz.impl.jdbcjobstore.StdJDBCDelegate");
        props.setProperty("org.quartz.jobStore.useProperties", "true");
        props.setProperty("org.quartz.jobStore.misfireThreshold", "60000");
        props.setProperty("org.quartz.jobStore.tablePrefix", "QRTZ_");
        props.setProperty("org.quartz.jobStore.isClustered", "true");
        props.setProperty("org.quartz.jobStore.clusterCheckinInterval", "15000");
        props.setProperty("org.quartz.jobStore.maxMisfiresToCheck", "50");
        props.setProperty("org.quartz.jobStore.selectWithLockSQL", "SELECT * FROM {0} WHERE SCHED_NAME = ? FOR UPDATE");
        props.setProperty("org.quartz.jobStore.txIsolationLevelName", "READ_COMMITTED");
        props.setProperty("org.quartz.jobStore.useSerializedColumns", "false");
        props.setProperty("org.quartz.scheduler.instanceId", "AUTO");
        props.setProperty("org.quartz.scheduler.instanceName", "MyScheduler");
        props.setProperty("org.quartz.scheduler.timeZone", "Asia/Shanghai");
        props.setProperty("org.quartz.threadPool.class", "org.quartz.simpl.SimpleThreadPool");
        props.setProperty("org.quartz.threadPool.threadCount", "5");
        props.setProperty("org.quartz.threadPool.threadPriority", "5");
        props.setProperty("org.quartz.threadPool.threadsInPool", "5");
        props.setProperty("org.quartz.jobStore.class", "org.quartz.impl.jdbcjobstore.JobStoreTX");
        props.setProperty("org.quartz.jobStore.driverDelegateClass", "org.quartz.impl.jdbcjobstore.StdJDBCDelegate");
        props.setProperty("org.quartz.jobStore.useProperties", "true");
        props.setProperty("org.quartz.jobStore.misfireThreshold", "60000");
        props.setProperty("org.quartz.jobStore.tablePrefix", "QRTZ_");
        props.setProperty("org.quartz.jobStore.isClustered", "true");
        props.setProperty("org.quartz.jobStore.clusterCheckinInterval", "15000");
        props.setProperty("org.quartz.jobStore.maxMisfiresToCheck", "50");
        props.setProperty("org.quartz.jobStore.selectWithLockSQL", "SELECT * FROM {0} WHERE SCHED_NAME = ? FOR UPDATE");
        props.setProperty("org.quartz.jobStore.txIsolationLevelName", "READ_COMMITTED");
        props.setProperty("org.quartz.jobStore.useSerializedColumns", "false");
        props.setProperty("org.quartz.scheduler.instanceId", "AUTO");
        props.setProperty("org.quartz.scheduler.instanceName", "MyScheduler");
        props.setProperty("org.quartz.scheduler.timeZone", "Asia/Shanghai");
        props.setProperty("org.quartz.threadPool.class", "org.quartz.simpl.SimpleThreadPool");
        props.setProperty("org.quartz.threadPool.threadCount", "5");
        props.setProperty("org.quartz.threadPool.threadPriority", "5");
        props.setProperty("org.quartz.threadPool.threadsInPool", "5");

        SchedulerFactory factory = new StdSchedulerFactory(props);
        Scheduler scheduler = factory.getScheduler();
        scheduler.start();
    }
}

动态添加和删除任务

动态添加和删除任务是通过调度器的API来实现的。例如，添加一个任务：

JobDetail job = JobBuilder.newJob(HelloJob.class)
        .withIdentity("myJob")
        .build();

Trigger trigger = TriggerBuilder.newTrigger()
        .withIdentity("myTrigger")
        .startNow()
        .withSchedule(SimpleScheduleBuilder.simpleSchedule()
                .withIntervalInSeconds(5)
                .repeatForever())
        .build();

scheduler.scheduleJob(job, trigger);

删除一个任务：

scheduler.deleteJob(new JobKey("myJob", "group1"));

Quartz任务的集群部署

分布式环境下的任务调度

在分布式环境中，任务调度需要考虑任务的唯一性和任务的重复执行问题。Quartz支持集群部署，可以确保任务在多个节点上合理地执行。

集群部署的配置方法

集群配置需要在调度器的配置中启用集群模式，并指定相关的配置项，如数据库配置和集群检查间隔等。

props.setProperty("org.quartz.jobStore.isClustered", "true");
props.setProperty("org.quartz.jobStore.clusterCheckinInterval", "15000");

处理集群中的并发任务

在集群环境中，需要处理任务的并发执行问题，确保任务不会在多个节点上同时执行。Quartz通过共享数据库存储任务状态，确保任务的唯一性和一致性。

常见问题与解决方案

常见的Quartz任务调度错误

任务未执行：检查调度器是否已经启动。
任务重复执行：检查任务的触发器配置是否正确。
任务执行失败：检查任务实现类中是否存在异常。

解决任务调度问题的基本方法

查看日志：任务调度框架通常会记录详细的日志，通过日志可以定位问题。
配置检查：检查调度器配置是否正确，如任务持久化配置、集群配置等。
代码调试：通过代码调试工具，检查任务实现类中的问题。

日志分析与监控

Quartz的运行日志可以帮助定位问题，可以通过配置日志级别来控制日志的详细程度。例如，使用SLF4J结合Logback配置详细的日志输出：

<configuration>
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

    <logger name="org.quartz" level="DEBUG"/>

    <root level="info">
        <appender-ref ref="STDOUT" />
    </root>
</configuration>

通过上述配置，可以详细记录Quartz的运行日志，便于问题的定位和解决。

点击查看更多内容

为 TA 点赞

若觉得本文不错，就分享一下吧！

评论

评论

共同学习，写下你的评论

评论加载中...

展开查看更多评论

作者其他优质文章

正在加载中

陪伴而非守候

手记
篇

粉丝

62

获赞与收藏

285

关注作者，订阅最新文章

阅读免费教程

Java并发工具

23个小节 19367 315

Java 并发原理入门教程

26个小节 39106 568

Java 入门教程

50个小节 342495 3164

推荐

评论

收藏

共同学习，写下你的评论



感谢您的支持，我会继续努力的～

扫码打赏，你说多少就多少

赞赏金额会直接到老师账户

支付方式

打开微信扫一扫，即可进行扫码打赏哦

今天注册有机会得

100积分直接送

付费专栏免费学

大额优惠券免费领

立即参与放弃机会

点击
抽奖

慕课手记新用户专享福利

恭喜你，你的运气太好了，居然抽中了 100个积分！

恭喜你，抽中了价值元的专栏！

太棒了，直接落到你账户里！

积分商城里的罗技鼠标、机械键盘、
Kindle 阅读器、小米平衡车
Apple iPad （10.2英寸）、大额优惠券
在等着你去兑换了噢

作者：

免费赠送

兑换码：1111222211 复制

优惠券可用于购买实战课、体系课
无门槛使用

先去看看，有什么好东西马上兑换我爱学习，选课去


热搜

最近搜索清空