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

孩子成长故事：记录宝贝的每一个重要时刻 #生活乐趣# #生活分享# #亲子分享#

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> 12345

入门例子

测试代码

//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); 12345678910111213 日志输出

根据 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 123

Trigger 触发器

cron

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

Triggers.cron(String cronExpression); 1

period

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

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

引导类

说明

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(); 1234567891011121314151617181920212223242526

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

属性说明

可配置的属性列表如下：

属性说明默认值appName应用名称envName环境名称machineIp机器IPmachinePort机器端口workPoolSize工作线程池大小waitTakeTimeSleepMills等待 takeTime 时，每一次循环的暂停时间triggerLockTryMillstrigger 锁尝试获取时间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> 12345

定时任务定义

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

@Service public class MyJobService { @PeriodSchedule(period = 2000) public void logTime() { System.out.println("---------------- TIME"); } @CronSchedule("*/5 * * * * ?") public void logName() { System.out.println("---------------- NAME"); } } 1234567891011121314

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

@PeriodSchedule 注解

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

可配置属性列表如下：

属性说明类型默认值value调度间隔long-timeUnit调度间隔时间单位TimeUnitTimeUnit.MILLISECONDSinitialDelay初始化延迟时间long0fixedRate是否固定速率booleanfalseallowConcurrentExecute是否允许并发执行booleantrueremark备注String空 @CronSchedule 注解

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

可配置属性列表如下：

属性说明类型默认值valuecron 表达式String-allowConcurrentExecute是否允许并发执行booleantrueremark备注String空

定时任务启用

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

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

注解其定义

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

可配置的属性列表如下：

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

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

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

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

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

springboot 整合

maven 引入

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

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

方法定义

同 spring 整合

模块介绍

子模块

sandglass 共计 5 个子模块：

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

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

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

产品矩阵

常言道，独木不成林。

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

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

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

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

拓展阅读

开源地址

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

https://github.com/houbb/sandglass

https://gitee.com/houbinbin/sandglass

文章

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

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

网址：开源分布式任务调度工具，和你一起记住生命中每一个重要的时刻 https://www.yuejiaxmz.com/news/view/855709

相关内容

关键时刻，能救命的20个生活常识，你记住了吗？
“即时生活”：最重要的是，过好每一天
出门在外，这31个“保命好习惯”你一定要记住！
切记！家里这6处一定要定期检查，关键时刻能救命！
推荐一款超实用的开源待办任务清单工具：Super Productivity
时间的智慧：如何高效利用生命的每一刻？
开源任务管理系统哪个好？对比9大任务管理工具
这组开心鸭，带你乐开花，享受人生每一刻
时间规划小技巧，源源和你一起学~
最全逃生自救指南，关键时刻能救你一命

随便看看