SpringBoot集成LiteFlow工作流引擎的完整指南

<!-- pom.xml 依赖 -->
<dependencies>
    <dependency>
        <groupId>com.yomahub</groupId>
        <artifactId>liteflow-spring-boot-starter</artifactId>
        <version>2.11.4.2</version>
    </dependency>
</dependencies>

// 普通组件示例
@Component("paymentAction")
public class PaymentAction extends NodeComponent {
    @Override
    public void process() {
        PaymentContext context = this.getContextBean(PaymentContext.class);
        // 执行支付逻辑
        System.out.println("处理支付, 订单:" + context.getOrderId());
    }
}

​​​​​​​// 条件组件示例（用于分支判断）
@Component("userCheck")
public class UserCheck extends NodeComponent {
    @Override
    public void process() {
        UserContext context = this.getContextBean(UserContext.class);
        if(context.isVip()) {
            this.setIsEnd(true);  // 终止流程
        }
    }
}

liteflow:
  rule-source: config/flow.el.xml

<?xml version="1.0" encoding="UTF-8"?>
<flow>
    <chain name="orderProcess">
        THEN(
            initOrder, 
            WHEN(
                checkInventory, 
                checkUserCredit
            ),
            SWITCH(choosePayWay).TO(
                CASE(aliPay).DO(aliPayAction),
                CASE(wechatPay).DO(wechatPayAction)
            ),
            AFTER(paymentAction).WHEN(userCheck)
        );
    </chain>
</flow>

@RestController
public class OrderController {

    @Resource
    private FlowExecutor flowExecutor;

    @PostMapping("/submitOrder")
    public String submitOrder(@RequestBody OrderDTO order) {
        OrderContext context = new OrderContext();
        context.setOrderId(order.getId());
        context.setAmount(order.getAmount());
        
        LiteflowResponse response = flowExecutor.execute2Resp(
            "orderProcess", 
            context, 
            OrderContext.class
        );
        
        return response.isSuccess() ? "订单成功" : "流程失败";
    }
}

<!-- 配置并行节点 -->
<chain name="parallelChain">
    THEN(
        a, 
        WHEN(b, c, d),  <!-- b,c,d并行执行 -->
        e
    );
</chain>

<chain name="mainFlow">
    THEN(prepare, SUB(orderProcess), notify);
</chain>

@Component("paymentAction")
public class PaymentAction extends NodeComponent {
    @Override
    public void process() {...}
    
    @Override
    public void onError() {
        // 支付失败时执行补偿逻辑
        fallbackService.compensate();
    }
}

// 动态添加规则
FlowBus.addChain("newChain", "THEN(a,b,c)");

// 监听规则变化
@Data
@Configuration
public class FlowConfig {
    @Bean
    public CommandLineRunner reloadRunner() {
        return args -> {
            FileWatcher.watch(Paths.get("config/flow"), 
                () -> FlowBus.reloadRule());
        };
    }
}

LiteflowResponse response = flowExecutor.execute2Resp(
    "orderProcess", 
    context, 
    OrderContext.class,
    // 开启执行链路跟踪
    SlotCallbackBuilder.builder().build()
);
System.out.println(response.getExecuteStepStr());

liteflow:
  monitor:
    enable-log: true
    queue-limit: 200
    delay: 30
    period: 120

// 从数据库加载规则
@Component
public class DBRuleLoader implements RuleSource {
    @Override
    public String loadRules() {
        return ruleMapper.selectByApp("order-service");
    }
}