开源分布式任务调度工具，和你一起记住生命中每一个重要的时刻

SandGlass

⏳ SandGlass 是一款为 java 设计的分布式任务调度工具。

创作目的

定时任务是业务需求中非常常见的

比如：

（1）每天给自己爱人发晚安

什么你还是单身？，那看完本篇文章就有了。

（2）每个月通知自己要还信用卡

可能还有其他的手机费、生活费之类的，反正又是一个没钱的一个月。

（3）每个月 14 日都是情人节

这个扯远了……

有了场景，那我们如何实现呢？

java 已有的实现任务调度的主流工具如下：

名称	多线程执行	cron 表达式	使用难度	可独立 spring 运行	任务执行等持久化	分布式支持
Timer	否	否	简单	是	需自己实现	否
ScheduledExecutor	是	否	一般	是	需自己实现	否
Quartz	是	是	麻烦	是	是	较差
Spring Schedule	是	是	简单	否	否	否
Sandglass	是	是	简单	是	是	是

为什么需要重新实现一个任务调度框架呢？

老马的日常开发中，简单的调度任务会使用 jdk 中的 ScheduledExecutor 实现。

当涉及到 cron 表达式时，一般会使用 quartz，毕竟老牌调度框架，功能非常完善。

但是对比 spring schedule，quartz 的使用就显得有些麻烦，需要开发者指定较多的配置。

那直接使用 spring schedule 不就好了吗？

spring schedule 的缺点也很明显，不支持数据的持久化，不支持分布式调度。

那直接引入一个分布式任务调度系统呢？

有时候就显得杀鸡用牛刀，而且维护成本比较高。

读到这里，肯定会有聪明的小伙伴们发问了：“难道就不能写一个可以独立于 spring 使用，又可以整合 spring 使用，可以单机调度，又可以分布式调度的任务调度工具吗？”

是的，sandglass 就是一个渐进式，满足上面各种应用场景的任务调度工具。

sandglass 的一点改进

• sandglass 拥有 quartz 的强大功能，spring schedule 的使用便捷性。

• sandglass 的实现简洁，便于系统学习调度系统的原理。

• sandglass 基于分布式理念设计，便于作为分布式调度系统的实现基石。

• sandglass 所有实现都是基于接口，用户可以自定义实现自己的策略。

特性

• 高性能任务调度

• 支持任务 MIS-FIRE 处理策略

• 支持任务是否并发处理

• 支持不依赖 spring，完全独立运行

• 支持整合 spring

• 支持整合 springboot

• 支持用户高度自定义

• 真正意义上的分布式任务调度系统

• 从零开始纯自研调度框架，便于用户学习原理

快速开始

maven 引入

<dependency>
    <groupId>com.github.houbb</groupId>
    <artifactId>sandglass-core</artifactId>
    <version>1.7.1</version>
</dependency>

入门例子

测试代码

//1.1 定义任务
IJob job = new AbstractJob() {
    @Override
    public void execute(IJobContext context) {
        LOG.info("HELLO");
    }
};

//1.2 定义触发器
ITrigger trigger = new CronTrigger("*/5 * * * * ?");

//2. 执行
SandGlassHelper.schedule(job, trigger);

日志输出

根据 cron 表达式，5s 执行一次任务。

[INFO] [2021-12-07 21:47:40.008] [pool-1-thread-1] [c.g.h.s.c.u.SandGlassHelperTest.doExecute] - HELLO
[INFO] [2021-12-07 21:47:45.003] [pool-1-thread-2] [c.g.h.s.c.u.SandGlassHelperTest.doExecute] - HELLO
[INFO] [2021-12-07 21:47:50.005] [pool-1-thread-3] [c.g.h.s.c.u.SandGlassHelperTest.doExecute] - HELLO

Trigger 触发器

cron

通过 cron 表达式创建 trigger，可以通过方法：

Triggers.cron(String cronExpression);

period

通过指定时间间隔创建 trigger，使用方法：

Triggers.period(long period);
Triggers.period(long period, TimeUnit timeUnit);

引导类

说明

SandGlass 也支持引导类自定义，默认配置等价于：

SandGlassBs.newInstance()
        .appName(SandGlassConst.DEFAULT_APP_NAME)
        .envName(SandGlassConst.DEFAULT_ENV_NAME)
        .machineIp(SandGlassConst.DEFAULT_MACHINE_IP)
        .machinePort(SandGlassConst.DEFAULT_MACHINE_PORT)
        .workPoolSize(SandGlassConst.DEFAULT_WORKER_POOL_SIZE)
        .waitTakeTimeSleepMills(SandGlassConst.WAIT_TAKE_TIME_SLEEP_MILLS)
        .triggerLockTryMills(SandGlassConst.TRIGGER_LOCK_TRY_MILLS)
        .triggerStore(new TriggerStore())
        .triggerDetailStore(new TriggerDetailStore())
        .triggerListener(new TriggerListener())
        .triggerLock(Locks.none())
        .triggerIdGenerator(IdGenerators.classSlim())
        .triggerLockKeyGenerator(new TriggerLockKeyGenerator())
        .jobStore(new JobStore())
        .jobDetailStore(new JobDetailStore())
        .jobListener(new JobListener())
        .jobTriggerStore(new JobTriggerStore())
        .jobTriggerStoreListener(new JobTriggerStoreListener())
        .jobTriggerMappingStore(new JobTriggerMappingStore())
        .jobTriggerNextTakeTimeStore(new JobTriggerNextTakeTimeStore())
        .jobIdGenerator(IdGenerators.classSlim())
        .taskLogStore(new TaskLogStore())
        .timer(SystemTimer.getInstance())
        .scheduleListener(new ScheduleListener())
        .start();

所有实现都是基于接口，用于可以根据实际业务进行调整。

属性说明

可配置的属性列表如下：

属性	说明	默认值
appName	应用名称
envName	环境名称
machineIp	机器IP
machinePort	机器端口
workPoolSize	工作线程池大小
waitTakeTimeSleepMills	等待 takeTime 时，每一次循环的暂停时间
triggerLockTryMills	trigger 锁尝试获取时间
triggerStore	触发器持久化
triggerDetailStore	触发器详情信息持久化
triggerListener	触发器监听器
triggerLock	触发器锁
triggerLockKeyGenerator	触发调度锁 key 生成策略
triggerIdGenerator	触发器标识生成策略
jobStore	任务持久化
jobDetailStore	任务详情持久化
jobListener	任务执行监听器
jobIdGenerator	任务标识生成策略
jobTriggerStore	任务触发器持久化
jobTriggerStoreListener	任务出发持久化监听器
jobTriggerMappingStore	任务触发器映射关系持久化
jobTriggerNextTakeTimeStore	任务触发下一次获取时间持久化
taskLogStore	任务执行日志持久化
timer	时间策略
scheduleListener	任务调度监听器

spring 整合

maven 引入

<dependency>
    <groupId>com.github.houbb</groupId>
    <artifactId>sandglass-spring</artifactId>
    <version>1.7.1</version>
</dependency>

定时任务定义

类似于 spring 的任务调度，我们可以通过注解指定方法。

@Service
public class MyJobService {

    @PeriodSchedule(period = 2000)
    public void logTime() {
        System.out.println("---------------- TIME");
    }

    @CronSchedule("*/5 * * * * ?")
    public void logName() {
        System.out.println("---------------- NAME");
    }

}

@PeriodSchedule 用于指定 period 执行的任务，@CronSchedule 用于指定 cron 表达式对应的任务。

@PeriodSchedule 注解

用于指定基于 period 执行的任务方法。

可配置属性列表如下：

属性	说明	类型	默认值
value	调度间隔	long	-
timeUnit	调度间隔时间单位	TimeUnit	TimeUnit.MILLISECONDS
initialDelay	初始化延迟时间	long	0
fixedRate	是否固定速率	boolean	false
allowConcurrentExecute	是否允许并发执行	boolean	true
remark	备注	String	空

@CronSchedule 注解

用于指定基于 cron 表达式 执行的任务方法。

可配置属性列表如下：

属性	说明	类型	默认值
value	cron 表达式	String	-
allowConcurrentExecute	是否允许并发执行	boolean	true
remark	备注	String	空

定时任务启用

直接指定 @EnableSandGlass 注解即可，无需额外配置。

@Configurable
@ComponentScan(basePackages = "com.github.houbb.sandglass.test.spring")
@EnableSandGlass
public class SpringConfig {
}

注解其定义

@EnableSandGlass 允许用户进行自定义。

可配置的属性列表如下：

属性	说明	默认值
appName	应用名称
workPoolSize	工作线程池大小
waitTakeTimeSleepMills	等待 takeTime 时，每一次循环的暂停时间
triggerLockTryMills	trigger 锁尝试获取时间
triggerStore	触发器持久化
triggerDetailStore	触发器详情信息持久化
triggerListener	触发器监听器
triggerLock	触发器锁
triggerLockKeyGenerator	触发调度锁 key 生成策略
triggerIdGenerator	触发器标识生成策略
jobStore	任务持久化
jobDetailStore	任务详情持久化
jobListener	任务执行监听器
jobIdGenerator	任务标识生成策略
jobTriggerStore	任务触发器持久化
jobTriggerStoreListener	任务出发持久化监听器
jobTriggerMappingStore	任务触发器映射关系持久化
jobTriggerNextTakeTimeStore	任务触发下一次获取时间持久化
taskLogStore	任务执行日志持久化
timer	时间策略
scheduleListener	任务调度监听器

默认的策略和 SandglassBs 引导类保持一致。

自定义方式：实现对应接口，在注解中对应对应的 bean 名称即可。

说明：下面 3 个属性和业务无关，只和执行的环境的配置有关，所以不支持注解指定。可以通过配置自定义。

属性	配置属性名称	说明
envName	sandglass-envName	配置指定环境信息
machineIp	sandglass-machineIp	配置指定机器IP信息
machinePort	sandglass-machinePort	配置指定机器端口信息

springboot 整合

maven 引入

<dependency>
    <groupId>com.github.houbb</groupId>
    <artifactId>sandglass-springboot-starter</artifactId>
    <version>1.7.1</version>
</dependency>

其他什么都不需要，就可以类似 spring 整合一样使用定时任务了。

方法定义

同 spring 整合

模块介绍

子模块

sandglass 共计 5 个子模块：

名称	说明	作用
sandglass-api	接口模块	定义标准
sandglass-core	核心模块	核心实现，可完全独立 spring 运行
sandglass-spring	spring 模块	整合 spring，便于使用
sandglass-springboot-starter	springboot 模块	整合 springboot，便于使用
sandglass-test	测试模块	功能测试，便于用户编写用例参考

采用渐进式的 MVP 设计理念，基本可以满足日常开发中的常见场景。

当然，分布式的任务调度服务会复杂的多，将会以 sandglass 为基础进行拓展实现。

产品矩阵

常言道，独木不成林。

sandglass 作为一个任务调度核心实现，只是分布式任务调度的基石。

若要实现一个完整的分布式调度系统，还需要如下的工具支撑。

名称	说明	状态
sandglass	核心实现	已开源
sandglass-socket	底层通讯协议	未开源
sandglass-client	任务调度客户端	未开源
sandglass-web	任务调度控台	未开源

目前经历几十个迭代和几十个不眠的夜晚，基本功能实现完成，后续考虑陆续开源。

拓展阅读

开源地址

为了便于大家共同学习，开源地址如下：

https://github.com/houbb/sandglass

https://gitee.com/houbinbin/sandglass

文章

为了吃瓜通宵7天写了一个网站

开源分布式任务调度工具，和你一起记住生命中每一个重要的时刻