当前位置：首页 > news >正文

LiteFlow规则引擎使用指南

news 2026/3/26 21:02:27

一、核心概念与适用场景

二、快速开始：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审批）。
需要将大块逻辑拆解，提高代码复用和可维护性。	跨多个系统的流程编排，协调难度大。
业务中存在明显的并行、选择、循环等结构。	团队对规则引擎和组件化设计缺乏了解，学习成本较高。