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


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

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

## 2. 丰富的执行控制策略
```java
@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. 执行历史记录
```java
private final Queue<TaskCondition> taskConditionHistory = EvictingQueue.create(30);
```
- 使用 Guava 的 `EvictingQueue` 保留最近 30 次执行记录，可用于监控、审计或自动重试决策。
- 每次执行完成后生成 `TaskCondition`（包含起止时间、错误信息等）并存入队列。

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

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

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

编程语言

架构设计

开发工具

RunnableDecorator实现Runnable和Trigger双接口，统一封装任务执行与调度控制。支持执行次数限制、失败重试、初始延迟、截止日期等策略，通过EvictingQueue记录执行历史。分离业务与控制逻辑，提升调度框架扩展性，符合开闭原则。

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

[056][调度模块]RunnableDecorator – 任务执行的增强装饰器-腾讯云开发者社区-腾讯云

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

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

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐