[056][调度模块]RunnableDecorator – 任务执行的增强装饰器

简介: `RunnableDecorator` 是调度模块中的增强装饰器,同时实现 `Runnable` 与 `Trigger` 接口,统一管理任务执行逻辑与触发策略,支持次数限制、失败重试、初始延迟、截止日期等高级控制,并自动记录执行历史,实现业务与调度逻辑解耦。(239字)

[056][调度模块]RunnableDecorator – 任务执行的增强装饰器

摘要

调度框架不仅要“按时执行”,还需支持执行次数限制、失败重试上限、初始延迟、截止日期等高级特性。本文分析 RunnableDecorator 如何同时实现 Runnable 和 Trigger 接口,统一封装执行控制与下一次执行时间计算。

1. 双重职责:执行逻辑 + 触发逻辑

public class RunnableDecorator implements Runnable, Trigger {
   
    private final Task task;
    private final TaskRunner runner;
    private CronTrigger cronTrigger;
    // 统计字段与回调函数...
}
  • 作为 Runnable:在 run() 中执行真正的业务逻辑,并记录开始/完成/失败事件。
  • 作为 Trigger:在 nextExecution(TriggerContext) 中根据 cron、最大执行次数、最大失败次数、截止日期等决定是否继续调度。

2. 丰富的执行控制策略

@Override
public Instant nextExecution(TriggerContext triggerContext) {
   
    // 超过最大执行次数
    if (maxExecutionCount != null && maxExecutionCount <= totalCount.get()) {
   
        stopEvent.accept(...);
        return null;
    }
    // 超过最大失败次数
    if (maxFailureCount != null && maxFailureCount <= totalFailureCount.get()) {
   
        stopEvent.accept(...);
        return null;
    }
    // 超过截止日期
    Instant dueDate = task.getDueDate();
    if (dueDate != null && dueDate.isBefore(next)) {
   
        stopEvent.accept(...);
        return null;
    }
    // 第一次执行增加 initialDelay
    if (totalCount.get() == 0) {
   
        return next.plusMillis(task.getInitialDelay().toMillis());
    }
    return next;
}
  • 失败计数:每次任务抛出异常时,failureEvent 回调自增 totalFailureCount。
  • 执行次数:每次 run() 开始前,startEvent 自增 totalCount。
  • 初始延迟:首次执行时在 cron 计算结果上额外延迟,避免任务一启动就立即运行。

3. 执行历史记录

private final Queue<TaskCondition> taskConditionHistory = EvictingQueue.create(30);
  • 使用 Guava 的 EvictingQueue 保留最近 30 次执行记录,可用于监控、审计或自动重试决策。
  • 每次执行完成后生成 TaskCondition(包含起止时间、错误信息等)并存入队列。

4. 设计价值

将控制逻辑与业务逻辑彻底分离,使得开发者只需关注 doRun() 实现,而执行策略(限流、延迟、截止)由框架统一管理,符合“开闭原则”。

目录
相关文章
|
3月前
|
人工智能 运维 自然语言处理
Geo专家于磊解析:GEO优化的基础、提升与突破
本文揭示生成式AI正重塑信息获取方式:用户不再点击链接,而是直接获取合成答案。GEO(生成式引擎优化)由此诞生——它不优化网页排名,而优化内容被AI采信、引用与复述的能力。Geo专家于磊提出“基础—提升—突破”三层框架,强调可信前提、可引用性、结构清晰是地基,数据支撑与答案岛是杠杆,实体网络与全域信任方达上限。
336 1
|
3月前
|
运维 Java 调度
XXL-JOB 分布式定时任务框架:任务分片、失败重试、调度中心一次讲透
单机 @Scheduled 扛不住分布式定时任务?拆解 XXL-JOB 调度中心与执行器架构、任务分片、失败重试机制,附 30 分钟接入示例。
536 0
XXL-JOB 分布式定时任务框架:任务分片、失败重试、调度中心一次讲透
|
3月前
|
Java Shell API
专为 Managed Agents 而生的 Harness 底座:AgentScope 2.0
基于 AgentScope 2.0 的 Harness 内核与 Sandbox 隔离能力,AgentScope 可以作为 Managed Agents 的底层运行时 Runtime,为其提供稳定可靠的执行环境。
836 20
|
3月前
|
人工智能 运维 Linux
凌晨告警不再慌!SysOM 巡检 Skill 一键锁定根因
凌晨两点被叫醒,还要花 40 分钟拼出根因?阿里云操作系统控制台发布的 SysOM 巡检 Skill,沉淀了内核专家的排查经验,37 秒即可生成报告,巡检发现问题后自动衔接诊断、精准定位根因。目前 SysOM 巡检 Skill 已开源,一行命令即可立即上手,欢迎体验。
421 27
|
3月前
|
人工智能 文字识别 JavaScript
AI 测试提效 | 脚本能跑但总挂?分享我的 ui-testscript-enhancer + Skill UI 自动化健壮性增强方案
本文介绍`ui-testscript-enhancer`技能:自动为AI生成的UI测试脚本注入六大健壮性能力——智能等待、弹窗处理、iframe/Shadow DOM穿透、异常重试、失败截图录屏及验证码识别(集成ddddocr),5分钟将“能跑”的脚本升级为CI-ready的“跑得稳”生产级脚本。
490 2
AI 测试提效 | 脚本能跑但总挂?分享我的 ui-testscript-enhancer + Skill UI 自动化健壮性增强方案
|
3月前
|
数据采集 存储 BI
数据目录、数据地图、数据资产目录还分不清?核心区别一次讲清
企业数据治理常陷“数据多、可用少”困境。本文厘清三大核心能力:**数据目录**(知有何数据)、**数据地图**(明数据关系与流转)、**数据资产目录**(识高价值数据并运营)。三者协同,推动数据从资源走向可复用、可管理、可增值的企业核心资产。(239字)
|
3月前
|
人工智能 Kubernetes 搜索推荐
4个机制解析:AI引擎如何选择引用内容
本文揭示AI引擎(如ChatGPT、Perplexity)引用机制与传统SEO的本质差异:非靠关键词排名,而重内容可解析性、权威信号与实时性。基于实测数据,从四层面提供可落地优化路径——理解引用逻辑、结构化内容(Schema/层级/FAQ)、构建权威背书、建立监测迭代闭环。
314 1
|
3月前
|
人工智能 自然语言处理 API
阿里云百炼Token Plan:AI 模型订阅计划,Qwen3.8-Max 首发尝鲜、上新deepseek-v4-flash,个人版39元起
阿里云推出的百炼Token Plan全新升级活动,是面向全类型AI生产力用户的重磅订阅服务升级,核心权益包含Qwen3.8-Max-Preview首发尝鲜限时加量10倍福利,覆盖文本、视觉、视频等全模态旗舰模型,支持个人版与企业版多档位灵活选择,早鸟优惠低至39元/月,每晚22点到次日8点夜间调用还可享qwen3.7系列低至2折起的超大折扣,同时开放多款组合购套餐将算力、工具、部署环境一站式配齐,帮助用户高效开启全链路AI生产力。
|
3月前
|
人工智能 数据可视化 数据挖掘
【免费领取Credit】Quick BI AIPro 全新发布,让数据成为企业增长引擎!
阿里云Quick BI AIPro正式发布!全新AI-native架构,支持对话式深度分析、业务语言理解、自动归因与行动建议。首月赠12.5万Credits,零门槛免费试用,存量客户无缝升级,新用户上传数据即用。
348 0
|
3月前
|
数据采集 人工智能 搜索推荐
AI 搜索时代的 Q4 备战手册:GEO 优化的底层逻辑与落地三步法
随着 ChatGPT、Google AI Overview 等生成式 AI 成为消费者购物决策的新入口,品牌能否出现在 AI 的推荐列表中,将直接影响 Q4 黑五的流量与转化。 本文从技术层面拆解了 GEO(生成式引擎优化)的核心逻辑:大模型存在 30–60 天的实体索引滞后期,这意味着 10 月才开始优化已为时过晚。