首页
/ EasyScheduler子工作流任务的高可用设计与实现

EasyScheduler子工作流任务的高可用设计与实现

2025-05-17 01:51:11作者:宣海椒Queenly

背景与现状

在分布式任务调度系统EasyScheduler中,子工作流(SubWorkflow)作为一种特殊的任务类型,允许用户将一个完整的工作流作为另一个工作流的子任务来执行。这种设计模式在复杂业务流程编排中非常有用,可以实现工作流的模块化和复用。

然而,当前版本的EasyScheduler对子工作流任务的支持存在一些功能上的不足,特别是在故障恢复、重复执行、暂停、终止和恢复等操作方面缺乏完善的实现机制。这导致在实际生产环境中,当需要对包含子工作流的父工作流进行管理操作时,无法有效地将操作传递到子工作流实例。

核心问题分析

子工作流任务本质上是对另一个工作流实例的封装和引用。当父工作流执行到子工作流任务时,系统需要:

  1. 创建并启动对应的子工作流实例
  2. 跟踪子工作流实例的执行状态
  3. 将父工作流的控制操作(如暂停、终止)传递到子工作流
  4. 在故障恢复时正确处理父子工作流的关系

当前实现的主要不足在于缺乏一个统一的状态管理机制,导致无法有效跟踪子工作流实例的状态,也无法将父工作流的控制操作正确传递到子工作流实例。

解决方案设计

子工作流运行时上下文

为了解决状态管理问题,我们引入了SubWorkflowLogicTaskRuntimeContext类,专门用于存储和管理子工作流任务的运行时信息:

public class SubWorkflowLogicTaskRuntimeContext {
    private Integer subWorkflowInstanceId;  // 子工作流实例ID
}

这个上下文对象会在子工作流任务执行时被创建并维护,保存了关键的子工作流实例ID,使得系统能够通过这个ID追踪和管理对应的子工作流实例。

子工作流实例的初始化

子工作流任务的执行首先需要初始化子工作流实例。根据不同的操作类型,初始化过程会有所区别:

private SubWorkflowLogicTaskRuntimeContext initializeSubWorkflowInstance() {
    if (subWorkflowLogicTaskRuntimeContext == null) {
        return triggerNewSubWorkflow();  // 新建子工作流实例
    }

    switch (workflowExecutionRunnable.getWorkflowInstance().getCommandType()) {
        case RECOVER_SUSPENDED_PROCESS:
            return recoverFromSuspendTasks();  // 从暂停状态恢复
        case START_FAILURE_TASK_PROCESS:
            return recoverFromFailedTasks();   // 从失败状态恢复
        default:
            return triggerNewSubWorkflow();  // 默认新建实例
    }
}

这种设计确保了在不同操作场景下,子工作流实例都能被正确地初始化或恢复。

控制操作传递机制

为了实现父工作流操作对子工作流的传递,我们实现了以下关键控制方法:

  1. 暂停操作:当父工作流被暂停时,会调用子工作流任务的pause()方法,该方法会通过子工作流控制客户端暂停对应的子工作流实例。
@Override
public void pause() throws MasterTaskExecuteException {
    if (subWorkflowLogicTaskRuntimeContext == null) {
        log.info("subWorkflowLogicTaskRuntimeContext is null cannot pause");
        return;
    }
    Integer subWorkflowInstanceId = subWorkflowLogicTaskRuntimeContext.getSubWorkflowInstanceId();
    WorkflowInstancePauseResponse pauseResponse = applicationContext
            .getBean(SubWorkflowControlClient.class)
            .pauseWorkflowInstance(new WorkflowInstancePauseRequest(subWorkflowInstanceId));
    // 处理暂停响应...
}
  1. 终止操作:类似地,终止操作会通过子工作流控制客户端停止子工作流实例。
@Override
public void kill() throws MasterTaskExecuteException {
    if (subWorkflowLogicTaskRuntimeContext == null) {
        log.info("subWorkflowLogicTaskRuntimeContext is null cannot kill");
        return;
    }
    Integer subWorkflowInstanceId = subWorkflowLogicTaskRuntimeContext.getSubWorkflowInstanceId();
    WorkflowInstanceStopResponse stopResponse = applicationContext
            .getBean(SubWorkflowControlClient.class)
            .stopWorkflowInstance(new WorkflowInstanceStopRequest(subWorkflowInstanceId));
    // 处理终止响应...
}

实现优势

  1. 状态一致性:通过运行时上下文维护子工作流实例ID,确保了父子工作流状态的一致性。
  2. 操作传递性:所有对父工作流的控制操作都能正确传递到子工作流实例。
  3. 故障恢复能力:支持从暂停、失败等异常状态中恢复执行。
  4. 可扩展性:设计上预留了进一步扩展的空间,可以方便地添加新的控制操作或状态管理功能。

实际应用场景

假设有一个电商订单处理工作流,其中包含以下步骤:

  1. 订单验证
  2. 支付处理(子工作流)
  3. 库存扣减
  4. 物流调度

在这个场景中,"支付处理"作为一个子工作流,可能包含多个复杂的支付相关步骤。通过本文介绍的实现方案:

  • 当需要暂停整个订单处理时,支付子工作流也会被正确暂停
  • 如果支付子工作流失败,可以从失败点恢复执行
  • 终止订单处理时,支付子工作流也会被终止
  • 系统故障恢复后,可以继续跟踪支付子工作流的状态

总结

EasyScheduler通过引入子工作流运行时上下文和完善的控制操作传递机制,显著提升了子工作流任务的管理能力和可靠性。这一改进使得复杂工作流的编排和执行更加稳定和可控,为业务系统提供了更强大的流程管理能力。未来还可以在此基础上进一步优化,如增加子工作流执行结果的详细反馈、支持更细粒度的控制操作等。

登录后查看全文
热门项目推荐

热门内容推荐

最新内容推荐

项目优选

收起
openHiTLS-examplesopenHiTLS-examples
本仓将为广大高校开发者提供开源实践和创新开发平台,收集和展示openHiTLS示例代码及创新应用,欢迎大家投稿,让全世界看到您的精巧密码实现设计,也让更多人通过您的优秀成果,理解、喜爱上密码技术。
C
53
465
kernelkernel
deepin linux kernel
C
22
5
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
349
381
nop-entropynop-entropy
Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台,包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分,采用java语言实现,可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用
Java
7
0
openGauss-serveropenGauss-server
openGauss kernel ~ openGauss is an open source relational database management system
C++
132
185
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
876
517
Cangjie-ExamplesCangjie-Examples
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
336
1.1 K
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
179
264
cherry-studiocherry-studio
🍒 Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端
TypeScript
610
59
note-gennote-gen
一款跨平台的 Markdown AI 笔记软件,致力于使用 AI 建立记录和写作的桥梁。
TSX
83
4