Quartz使用记录总结

Quartz是一个任务调度框架，最近在项目中有用到，所以做个记录总结。

一、主要元素

Scheduler：调度器，控制任务的调度，将JobDetail和Trigger注册到Scheduler加以控制。
Job：任务，是一个接口且只有一个方法void execute(JobExecutionContext context)，实现该接口定义任务的执行逻辑。
JobDetail：Job实例，一个Job可以创建多个Job实例，每一个实例有自己的属性。
Trigger：触发器，定义触发规则。

二、简单使用

　　我是在Spring Boot项目中使用的，这个Demo也是基于Spring Boot，实际上还可以更简洁。Quartz版本为2.3.0。

增加pom依赖

<dependency>

      <groupId>org.quartz-scheduler</groupId>

      <artifactId>quartz</artifactId>

      <version>2.3.0</version>

</dependency>

编写配置文件

# quartz.properties

org.quartz.scheduler.instanceName=TaskScheduler

org.quartz.threadPool.threadCount=5

org.quartz.jobStore.class=org.quartz.impl.jdbcjobstore.JobStoreTX # 数据保存到数据库，使用JobStoreTX作为JobStore来管理事务

org.quartz.jobStore.driverDelegateClass=org.quartz.impl.jdbcjobstore.StdJDBCDelegate # 数据库代理

org.quartz.jobStore.tablePrefix=QRTZ_ # 表前缀，默认为QRTZ_。主要可用于多个服务数据存储到同一数据库，可以创建多组不同的表供不同服务使用。

org.quartz.jobStore.dataSource=quartzDataSource # 数据源，在下面定义数据源信息的时候需要用到

org.quartz.dataSource.quartzDataSource.driver=com.mysql.jdbc.Driver

org.quartz.dataSource.quartzDataSource.URL=jdbc:mysql://127.0.0.1:3306/test?autoReconnect=true&autoReconnectForPools=true&useUnicode=true&allowMultiQueries=true&characterEncoding=UTF-8&useSSL=false

org.quartz.dataSource.quartzDataSource.user=root

org.quartz.dataSource.quartzDataSource.password=123456

org.quartz.dataSource.quartzDataSource.maxConnections=5

org.quartz.dataSource.quartzDataSource.validationQuery=select 1

定义配置类

@Configuration

public class QuartzConfig {

    @Autowired

    private SpringJobFactory springJobFactory;

    // 配置文件，在application.yml文件中配置

    @Value("${quartz.config}")

    private String quartzConfig;

    @Bean(name = "schedulerFactory")

    public SchedulerFactoryBean schedulerFactoryBean() throws IOException {

        SchedulerFactoryBean factory = new SchedulerFactoryBean();

        factory.setAutoStartup(true);

        // 延时5秒启动

        factory.setStartupDelay(5);
　　　　 // 设置配置信息

        factory.setQuartzProperties(quartzProperties());

        factory.setJobFactory(springJobFactory);

        return factory;

    }

    @Bean

    public Properties quartzProperties() throws IOException {

        PropertiesFactoryBean propertiesFactoryBean = new PropertiesFactoryBean();

        propertiesFactoryBean.setLocation(new ClassPathResource(quartzConfig));

        propertiesFactoryBean.afterPropertiesSet();

        return propertiesFactoryBean.getObject();

    }

    /**

     * Quartz初始化监听器

     *

     * @return

     */

    @Bean

    public QuartzInitializerListener executorListener() {

        return new QuartzInitializerListener();

    }

    /**

     * 将Scheduler添加到Spring管理

     *

     * @return

     * @throws IOException

     */

    @Bean(name = "scheduler")

    public Scheduler scheduler() throws IOException {

        return schedulerFactoryBean().getScheduler();

    }

}

数据库增加对应表，可以到Quartz发行版的“docs / dbTables”目录中找到表创建SQL脚本。

定义Job

public class TestJob implements Job, Serializable {

    private static final Logger LOGGER = LoggerFactory.getLogger(TestJob.class);

    private static final long serialVersionUID = 1L;

    @Override

    public void execute(JobExecutionContext arg0) throws JobExecutionException {

        LOGGER.info("-------------- 执行Quartz测试任务 --------------");

        // Do something ...

    }

}

创建JobDetail和Trigger并加入调度器(这部分建议写成接口)

Class cls = Class.forName("com.xiaoliu.job.TestJob");

cls.newInstance();

// 创建JobDetail

JobDetail job = JobBuilder.newJob(cls).withIdentity("test1",

                    "test")

                    .withDescription("测试任务1").build();

// 创建触发器

CronScheduleBuilder cronScheduleBuilder = CronScheduleBuilder.cronSchedule("0/10 * * * * ? ")

// 立即触发一次，然后按照正常的规则执行下一个周期的任务。

    .withMisfireHandlingInstructionFireAndProceed();

Trigger trigger = TriggerBuilder.newTrigger().withIdentity("trigger" + "test1", "test").startNow().withSchedule(cronScheduleBuilder).build();

 // 注册到scheduler

scheduler.scheduleJob(job, trigger);

　　最后运行项目，查看效果。

三、关于Trigger

　　使用Quartz的过程需要了解清楚Trigger，它关系到任务触发规则的定义，以及触发过程可能遇到的问题处理。在这里只涉及最常用的两种Trigger：SimpleTrigger和CronTrigger。

　　先看一下TriggerBuilder这个构造类，里面有各种Trigger的一些公共属性，主要列举几个说明：

jobKey：trigger触发时被执行的job的key。
startTime：trigger生效的时间点。
endTime：trigger失效的时间点。trigger只在startTime和endTime之间才会被触发。
priority：优先级，默认为5，priority的值可以是任意整数。假设同时执行的trigger有很多，但是Quartz线程池的工作线程很少（没有足够的资源同时触发这些trigger），这个时候会按照优先级高的先触发。
misfire Instructions：错过触发策略，trigger定义了一个触发阀值，在阀值时间范围内会重新触发，超过阀值范围则认为是misfire。因为某种原因，trigger在应该触发的时候未触发且错过了触发的时机，就需要一定策略来处理misfire，不同的trigger有不同的策略集。所有trigger的默认触发策略都是MISFIRE_INSTRUCTION_SMART_POLICY，值为0。

　　①　SimpleTrigger

　　可以满足的调度需求：在具体的时间点执行一次，或者在具体的时间点执行，并且以指定的间隔重复执行若干次。简单的调度需求可以使用SimpleTrigger。

　　SimpleTrigger的主要属性有：

- repeatCount：重复间隔
- repeatInterval：重复次数

例：

SimpleScheduleBuilder.simpleSchedule()

        .withIntervalInSeconds(10) // 10s执行一次

        .repeatForever() // 次数不限

SimpleScheduleBuilder.simpleSchedule()

         .withIntervalInMinutes(1) // 1分钟执行一次

         .withRepeatCount(10) // 次数为10次

Misfire策略

　　SimpleTrigger的misfire策略有以下几种：

MISFIRE_INSTRUCTION_SMART_POLICY：0,默认策略。会根据实例的配置及状态，在所有MISFIRE策略中动态选择一种Misfire策略。

MISFIRE_INSTRUCTION_IGNORE_MISFIRE_POLICY：-1,忽略所有的超时状态，按照触发器的策略执行。

MISFIRE_INSTRUCTION_FIRE_NOW：1，立即执行

MISFIRE_INSTRUCTION_RESCHEDULE_NOW_WITH_EXISTING_REPEAT_COUNT：2,立即执行，并重复到指定的次数。

MISFIRE_INSTRUCTION_RESCHEDULE_NOW_WITH_REMAINING_REPEAT_COUNT：3,立即执行，且超时期内错过的执行机会作废。

MISFIRE_INSTRUCTION_RESCHEDULE_NEXT_WITH_REMAINING_COUNT：4，以现在为基准，以repeatInterval为周期，延时到下一个激活点执行。

MISFIRE_INSTRUCTION_RESCHEDULE_NEXT_WITH_EXISTING_COUNT：5,在下一个激活点执行，并重复到指定的次数。

Misfire策略设置方式如下：

SimpleScheduleBuilder.simpleSchedule()

          .withIntervalInSeconds(10)

          .repeatForever()

          .withMisfireHandlingInstructionFireNow()

　　②　CronTrigger

CronTrigger能支持更复杂的调度需求，通常比SimpleTrigger更有用，CronTrigger的属性只有Cron Expressions，但Cron表达式的功能非常强大。Cron Expressions是由七个子表达式组成的字符串，用于描述日程表的各个细节。这些子表达式用空格分隔，分别是秒/分/时/日/月/周/年，年不是必须的。

表达式	是否必须	允许值	允许的特殊字符
秒	是	0-59	, - * /
分	是	0-59	, - * /
时	是	0-23	, - * /
日	是	1-31	, - * ? / L W C
月	是	1-12 或 JAN-DEC	, - * /
周	是	1-7 或 SUN-SAT	, - * ? / L C #
年	否	空或 1970-2099	, - * /

比如上面例子中的表达式：0/10 * * * * ? ，表示每10s执行一次。cron的具体规则网上很多，不是本文的重点。

Misfire策略

　　CronTrigger的misfire策略有以下几种：

MISFIRE_INSTRUCTION_SMART_POLICY：0,默认策略。在CronTrigger中解释为MISFIRE_INSTRUCTION_FIRE_ONCE_NOW。
MISFIRE_INSTRUCTION_IGNORE_MISFIRE_POLICY：-1,忽略所有的超时状态，按照触发器的策略执行。

MISFIRE_INSTRUCTION_DO_NOTHING：2，什么都不做，然后就按照正常的计划执行。

MISFIRE_INSTRUCTION_FIRE_ONCE_NOW：1，立即触发一次，触发后恢复正常的频率。

Misfire策略设置方式如下：

CronScheduleBuilder.cronSchedule("0/10 * * * * ? ")
.withMisfireHandlingInstructionFireAndProceed();

四、问题记录

　　在项目中使用时遇到了一个问题，也是我后面进一步了解Quartz的原因，在此记录。

　　Job本地运行正常，但部署到Linux服务器后，观察业务发现Job未执行，也找不到相关错误日志。

　　最开始的思考问题的原因可能是：Linux和Windows系统或其他环境问题，调度策略或者其他配置问题。通过接口手动触发Job是正常的，修改触发策略等等配置后依然无法解决。第二天发现测试系统部分任务成功执行了，查看日志发现有ClassNotFoundException，原因是执行了一个不属于当前服务的Job。问题好像有点苗头了，查看qrtz_triggers表的记录，失败Job对应的trigger记录trigger_state的值为ERROR，那么原因找到了：多个服务中的Quartz使用同一组表，维护同一组数据。当服务触发了一个不属于本服务的Job后（ClassNotFoundException，业务处理失败），会修改触发记录，其他服务就不会重复触发该任务，也不会产生错误日志。

trigger_state的值有：

WAITING：等待
PAUSED：暂停
ACQUIRED：正常执行
BLOCKED：阻塞
ERROR：错误

解决方案：

任务调度整合在一个服务里，其他服务开放业务处理接口。（服务有多节点时不可行）
每个服务创建一组数据库表，通过在配置文件配置org.quartz.jobStore.tablePrefix属性指定到对应的表。