# [059][调度模块]配置驱动的任务仓库 – 从 YAML 加载任务

本文章代码: [gitee](https://gitee.com/yunjiao-source/tutorials4j) , [gitcode](https://gitcode.com/yun-jiao/tutorials4j) , [github](https://github.com/yunjiao-source/tutorials4j)

## 摘要
为了方便运维和快速配置，框架支持通过 `application.yml` 定义定时任务。`YamlTaskRepository` 将配置解析为 `YamlTask` 对象，并暴露增删改查接口。本文解析配置结构、加载流程及与 `ScheduleTaskManager` 的集成。

## 1. 配置结构
```yaml
tutorials4j:
  schedule:
    default-execution:
      initial-delay: 30s   # 默认初始延迟
      max-failure-count: 3 # 默认最大失败次数
    tasks:
      syncOrderTask:
        class-simple-name: orderSyncRunner
        cron: "0 0/5 * * * ?"
        enabled: true
        description: "同步订单"
        metadata:
          source: "mysql"
        execution:
          max-execution-count: 100
          due-date: "2025-12-31T23:59:59Z"
      # 更多任务...
```
- `TaskOptions` 映射单个任务配置，`TaskExecutionOptions` 可覆盖全局默认值。
- `YamlTask.of(TaskOptions)` 负责转换为领域对象 `YamlTask`。

## 2. YamlTaskRepository 初始化
```java
public YamlTaskRepository(ScheduleProperties properties) {
    properties.getTasks().forEach((name, opts) -> {
        if (!opts.validate()) throw new IllegalArgumentException(...);
        YamlTask task = YamlTask.of(opts);
        task.setName(name);
        taskMap.put(name, task);
    });
}
```
- 构造函数中完成解析，存入 `ConcurrentHashMap`。
- 支持后续运行时增删改（`create`、`update`、`delete`），但默认实现仅做内存操作，可被替换为数据库版本。

## 3. 与调度器的集成
```java
@Configuration
public class ScheduleConfiguration {
    @Bean
    @ConditionalOnMissingBean
    TaskRepository<?> yamlTaskRepository(ScheduleProperties properties) {
        return new YamlTaskRepository(properties);
    }

    @Bean
    ScheduleTaskManager scheduleTaskManager(
            TaskRepository<?> repository,
            ObjectProvider<ChangeStatusEventConsumer> consumers) {
        return new ScheduleTaskManager(repository, consumers.orderedStream().collect(Collectors.toList()));
    }
}
```
- Spring Boot 自动配置将 `YamlTaskRepository` 作为默认 `TaskRepository`。
- `ScheduleTaskManager` 初始化时会调用 `taskRepository.findAll()` 加载所有任务并逐一 `addTask`。

## 4. 运维价值
- **声明式配置**：无需代码修改即可调整任务 cron、开关状态、限流参数。
- **可替换性**：通过 `@ConditionalOnMissingBean` 允许用户自定义 `TaskRepository`（如从数据库或配置中心读取）。

为了方便运维和快速配置，框架支持通过 application.yml 定义定时任务。YamlTaskRepository 将配置解析为 YamlTask 对象，并暴露增删改查接口。本文解析配置结构、加载流程及与 ScheduleTaskManager 的集成。

[059][调度模块]配置驱动的任务仓库 – 从 YAML 加载任务

后端

开发工具

架构设计

本文介绍配置驱动的任务仓库实现，通过application.yml定义定时任务，YamlTaskRepository解析配置并支持增删改查，与ScheduleTaskManager集成实现声明式运维，可替换为数据库版本。

代码解释

Spring Boot

数据库

Java

2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

[059][调度模块]配置驱动的任务仓库 – 从 YAML 加载任务-腾讯云开发者社区-腾讯云

[059][调度模块]配置驱动的任务仓库 – 从 YAML 加载任务

[059][调度模块]配置驱动的任务仓库 – 从 YAML 加载任务

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐