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

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 就是一个渐进式,满足上面各种应用场景的任务调度工具

开源分布式任务调度工具,和你一起记住生命中每一个重要的时刻_第1张图片

sandglass 的一点改进

  • sandglass 拥有 quartz 的强大功能,spring schedule 的使用便捷性。
  • sandglass 的实现简洁,便于系统学习调度系统的原理。
  • sandglass 基于分布式理念设计,便于作为分布式调度系统的实现基石。
  • sandglass 所有实现都是基于接口,用户可以自定义实现自己的策略。

特性

  • 高性能任务调度
  • 支持任务 MIS-FIRE 处理策略
  • 支持任务是否并发处理
  • 支持不依赖 spring,完全独立运行
  • 支持整合 spring
  • 支持整合 springboot
  • 支持用户高度自定义
  • 真正意义上的分布式任务调度系统
  • 从零开始纯自研调度框架,便于用户学习原理

快速开始

maven 引入


    com.github.houbb
    sandglass-core
    1.7.1

入门例子

测试代码

//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 引入


    com.github.houbb
    sandglass-spring
    1.7.1

定时任务定义

类似于 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 引入


    com.github.houbb
    sandglass-springboot-starter
    1.7.1

其他什么都不需要,就可以类似 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天写了一个网站

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

开源分布式任务调度工具,和你一起记住生命中每一个重要的时刻_第2张图片

你可能感兴趣的