目录
一、核心概念与适用场景
二、快速开始：Spring Boot 集成
三、核心组件与规则语法
四、进阶特性与最佳实践
五、总结：何时考虑使用LiteFlow？
LiteFlow是一款国产轻量级规则引擎和流程编排框架，主要用于将复杂的业务逻辑拆解为独立的组件，并通过规则文件（DSL）进行灵活编排。它的核心价值在于实现逻辑解耦、任意编排和规则热更新。
一、核心概念与适用场景
理解LiteFlow，首先要区分规则引擎和流程引擎。
规则引擎：专注于将核心决策逻辑从代码中抽离，并用特定语言（DSL）定义，支持热更新。它不处理角色分派，解决的是“怎么走”的问题。
流程引擎：专注于流程定义和角色任务分派（如审批流），解决的是“谁来做”和“下一步是什么”的问题。
LiteFlow是“规则引擎+编排引擎”的结合体。它擅长处理复杂的、可拆解的业务逻辑块，比如订单处理、风控规则等，通过编排组件顺序来完成业务。但它不适用于以角色驱动为主的审批流，或跨多系统的流程协调。
二、快速开始：Spring Boot 集成
以下是整合LiteFlow到Spring Boot项目的基本步骤：
添加依赖
在pom.xml中添加：<dependency> <groupId>com.yomahub</groupId> <artifactId>liteflow-spring-boot-starter</artifactId> <version>2.15.0</version> <!-- 建议使用最新版本 --> </dependency>
编写业务组件
创建一个普通组件，继承NodeComponent：@LiteflowComponent("componentA") // 组件ID public class ComponentA extends NodeComponent { @Override public void process() { // 1. 获取数据上下文 YourContext context = this.getContextBean(YourContext.class); // 2. 执行业务逻辑 System.out.println("执行组件A逻辑，订单号：" + context.getOrderNo()); } }定义流程规则
在resources下创建规则文件（如liteflow-rules.xml）：<?xml version="1.0" encoding="UTF-8"?> <flow> <chain name="orderProcessChain"> <!-- 规则链名称 --> <!-- 串行执行: THEN(A, B) --> <!-- 并行执行: WHEN(A, B) --> THEN( componentA, WHEN(componentB, componentC), <!-- B和C并行执行 --> IF(conditionComponent, componentD, componentE) <!-- 条件选择 --> ); </chain> </flow>
执行流程
通过FlowExecutor触发规则执行：@RestController public class TestController { @Autowired private FlowExecutor flowExecutor; @GetMapping("/testOrder") public String testFlow() { // 初始化上下文，传递参数 YourContext context = new YourContext(); context.setOrderNo("SO20250122001"); // 执行规则链 LiteflowResponse response = flowExecutor.execute2Resp("orderProcessChain", null, context); return response.isSuccess() ? "成功" : "失败"; } }
三、核心组件与规则语法
LiteFlow提供了多种组件类型和丰富的规则语法来编排复杂逻辑：
| 组件类型 | 继承类/接口 | 关键字 | 说明 |
|---|---|---|---|
| 普通组件 | NodeComponent | THEN,WHEN | 基础业务单元。 |
| 选择组件 | NodeSwitchComponent | SWITCH | 根据返回值路由到不同分支。 |
| 条件组件 | NodeBooleanComponent | IF,ELIF,ELSE | 根据布尔值决定执行路径。 |
| 循环组件 | NodeForComponent,NodeIteratorComponent | FOR,WHILE,ITERATOR | 用于循环执行。 |
常用规则语法示例：
串行与并行：
THEN(a, b, c)串行执行；WHEN(a, b, c)并行执行。条件判断：
IF(x, a, b)如果x组件返回true执行a，否则执行b。选择路由：
SWITCH(s).to(a, b, c)根据s组件的返回值，跳转到a、b、c之一。循环：
FOR(f).DO(a)循环执行a。嵌套：规则可以任意嵌套，例如
THEN(a, WHEN(b, c))。
四、进阶特性与最佳实践
数据上下文
上下文是组件间共享数据的唯一媒介，不同请求的上下文完全隔离。建议为不同的业务流程自定义上下文类。规则热更新
LiteFlow支持规则文件、数据库、Nacos等多种配置源，并能在运行时平滑热刷新规则，无需重启应用。脚本组件
对于需要频繁变动的逻辑，可以使用脚本组件（支持Groovy、JavaScript、Python等）。脚本可以与Java组件混编，并同样支持热更新。使用LiteFlowX插件
强烈建议在IDEA中安装LiteFlowX插件。它可以提供规则文件的语法高亮、组件智能提示、跳转等功能，极大提升开发效率。
五、总结：何时考虑使用LiteFlow？
在决定引入LiteFlow前，可以参考以下判断：
| 推荐使用LiteFlow的场景 | 不推荐或需谨慎的场景 |
|---|---|
业务逻辑复杂，存在大量if-else或缩进过深。 | 简单的、线性的、稳定的业务。 |
| 逻辑经常变动，需要快速响应或热更新。 | 标准的、以角色审批为核心的工作流（如OA审批）。 |
| 需要将大块逻辑拆解，提高代码复用和可维护性。 | 跨多个系统的流程编排，协调难度大。 |
| 业务中存在明显的并行、选择、循环等结构。 | 团队对规则引擎和组件化设计缺乏了解，学习成本较高。 |
简单来说，如果你的系统核心业务复杂、臃肿且变动频繁，LiteFlow能帮你解耦、编排并实现灵活变更，是一个强有力的工具。但如果业务本身简单稳定，或属于标准的审批流程，引入它可能反而增加复杂度。
)
