流程编排框架LiteFlow详解
流程编排框架LiteFlow详解
- 1. 前言
- 2. 概述
- 3. 特点
- 4. LiteFlow框架的作用
- 5. LiteFlow的设计原则
- 6. LiteFlow不适用于场景
- 7. LiteFlow适用场景
- 8. LiteFlow相比于Flowable和Activiti
- 9. 实现验证
1. 前言
在每个公司的系统中，总有一些拥有复杂业务逻辑的系统，这些系统承载着核心业务逻辑，几乎每个需求都和这些核心业务有关，这些核心业务业务逻辑冗长，涉及内部逻辑运算，缓存操作，持久化操作，外部资源调取，内部其他系统RPC调用等等。时间一长，项目几经易手，维护的成本得就会越来越高。各种硬代码判断，分支条件越来越多。代码的抽象，复用率也越来越低，各个模块之间的耦合度很高。一小段逻辑的变动，会影响到其他模块，需要进行完整回归测试来验证。如要灵活改变业务流程的顺序，则要进行代码大改动进行抽象，重新写方法。实时热变更业务流程，几乎很难实现。
2. 概述
liteFlow是一个轻量，快速的组件式流程引擎框架/规则引擎，组件编排，组件复用，帮助解耦业务代码，让每一个业务片段都是一个优雅的组件，并支持热加载规则配置，实现即时修改。
项目主页请点击：项目主页
项目文档请点击：项目文档
示例工程请点击：示例工程
3. 特点
复杂业务的解耦编排利器，为所有组件提供统一化的实现方式
基于规则文件来编排流程，支持xml,json,yml三种规则文件写法方式
框架中提供本地文件配置源，zk配置源的实现
框架提供自定义配置源，只需实现一个接口，即可从任何地方加载配置源
支持SpringBoot的自动装配，也支持Spring的配置和非Spring的项目
提供串行和并行2种模式，提供常见常见的表达式语句
可以定义脚本语言节点，支持QLExpress和Groovy两种脚本
组件可以支持重试，每个组件均可自定义重试配置和指定异常
提供无级嵌套的显式子流程模式，隐式子流程模式
数据槽隔离机制，在多并发下上下文独立而稳定
支持优雅平滑热刷新特性
对系统损耗极低，可以稳定运行在核心业务大规模的微服务中
自带简单的监控，能够知道每个组件的运行耗时排行
4. LiteFlow框架的作用
LiteFlow就是为解耦复杂逻辑而生，如果你要对复杂业务逻辑进行新写或者重构，用LiteFlow最合适不过。它是一个轻量，快速的组件式流程引擎框架，组件编排，帮助解耦业务代码，让每一个业务片段都是一个组件，并支持热加载规则配置，实现即时修改。
使用LiteFlow，你需要去把复杂的业务逻辑按代码片段拆分成一个个小组件，并定义一个规则流程配置。这样，所有的组件，就能按照你的规则配置去进行复杂的流转。
5. LiteFlow的设计原则
LiteFlow是基于工作台模式进行设计的，何谓工作台模式？
n个工人按照一定顺序围着一张工作台，按顺序各自生产零件，生产的零件最终能组装成一个机器，每个工人只需要完成自己手中零件的生产，而无需知道其他工人生产的内容。每一个工人生产所需要的资源都从工作台上拿取，如果工作台上有生产所必须的资源，则就进行生产，若是没有，就等到有这个资源。每个工人所做好的零件，也都放在工作台上。
这个模式有几个好处：
每个工人无需和其他工人进行沟通。工人只需要关心自己的工作内容和工作台上的资源。这样就做到了每个工人之间的解耦和无差异性。
即便是工人之间调换位置，工人的工作内容和关心的资源没有任何变化。这样就保证了每个工人的稳定性。
如果是指派某个工人去其他的工作台，工人的工作内容和需要的资源依旧没有任何变化，这样就做到了工人的可复用性。
因为每个工人不需要和其他工人沟通，所以可以在生产任务进行时进行实时工位更改：替换，插入，撤掉一些工人，这样生产任务也能实时的被更改。这样就保证了整个生产任务的灵活性。
这个模式映射到LiteFlow框架里，工人就是组件，工人坐的顺序就是流程配置，工作台就是上下文，资源就是参数，最终组装的这个机器就是这个业务。正因为有这些特性，所以LiteFlow能做到统一解耦的组件和灵活的装配。
6. LiteFlow不适用于场景
LiteFlow自开源来，经常有一些小伙伴来问我，如何做角色任务之间的流转，类似于审批流，A审批完应该是B审批，然后再流转到C角色。
这里申明下，LiteFlow只做基于逻辑的流转，而不做基于角色任务的流转。如果你想做基于角色任务的流转，推荐使用flowable，activiti这2个框架。
7. LiteFlow适用场景
LiteFlow适用于拥有复杂逻辑的业务，比如说价格引擎，下单流程等，这些业务往往都拥有很多步骤，这些步骤完全可以按照业务粒度拆分成一个个独立的组件，进行装配复用变更。使用LiteFlow，你会得到一个灵活度高，扩展性很强的系统。因为组件之间相互独立，也也可以避免改一处而动全身的这样的风险。
8. LiteFlow相比于Flowable和Activiti
Flowable和Activiti都是极为优秀的流程引擎框架，其中Flowable的底层也是Activiti，他们除了能做基于任务角色的流程，也能做基于逻辑的流程，并且他们的基于BPM协议，很多基于BPM协议的编辑工具都能为他们可视化编辑流程。
LiteFlow和他们相比，虽然功能不如他们那么多，但是胜在轻量，高性能和极少学习成本上。而且这2款都是国外开源，集成起来比较重，而且文档本地化做的也不够好。LiteFlow拥有完善的本地化文档和使用范例。在大部分的场景可以帮助你改善你的系统。
9. 实现验证
案例基于liteflow-example实现
pom文件
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0modelVersion>
<parent>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-parentartifactId>
<version>2.5.6version>
<relativePath/>
parent>
<groupId>com.zrjgroupId>
<artifactId>liteflow-exampleartifactId>
<version>0.0.1-SNAPSHOTversion>
<name>liteflow-examplename>
<description>Demo project for Spring Bootdescription>
<properties>
<java.version>1.8java.version>
<commons.lang3.version>3.4commons.lang3.version>
<commons-collections.version>4.1commons-collections.version>
properties>
<dependencies>
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-webartifactId>
dependency>
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-testartifactId>
<scope>testscope>
dependency>
<dependency>
<groupId>org.apache.commonsgroupId>
<artifactId>commons-lang3artifactId>
<version>${commons.lang3.version}version>
dependency>
<dependency>
<groupId>org.apache.commonsgroupId>
<artifactId>commons-collections4artifactId>
<version>${commons-collections.version}version>
dependency>
<dependency>
<groupId>com.yomahubgroupId>
<artifactId>liteflow-spring-boot-starterartifactId>
<version>2.6.4version>
dependency>
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-thymeleafartifactId>
dependency>
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-testartifactId>
<scope>testscope>
<exclusions>
<exclusion>
<groupId>org.junit.vintagegroupId>
<artifactId>junit-vintage-engineartifactId>
exclusion>
exclusions>
dependency>
<dependency>
<groupId>org.projectlombokgroupId>
<artifactId>lombokartifactId>
<optional>trueoptional>
dependency>
<dependency>
<groupId>cn.hutoolgroupId>
<artifactId>hutool-allartifactId>
<version>5.5.4version>
<scope>compilescope>
dependency>
dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-maven-pluginartifactId>
plugin>
plugins>
build>
project>
application.properties
server.port=8580
liteflow.ruleSource=liteflow/*.xml
#-----------------以下非必须-----------------
##liteflow是否开启，默认为true
#liteflow.enable=true
##liteflow的banner是否开启，默认为true
#liteflow.print-banner=true
##zkNode的节点，只有使用zk作为配置源的时候才起作用
#liteflow.zk-node=/lite-flow/flow
##slot的数量，默认值为1024
#liteflow.slot-size=1024
##异步线程最长的等待时间秒(只用于when)，默认值为15
#liteflow.when-max-wait-second=15
##异步线程池最大线程数，默认为16
#liteflow.when-max-workers=16
##异步线程池等待队列数，默认为512
#liteflow.when-queue-limit=512
##是否在启动的时候就解析规则，默认为true
#liteflow.parse-on-start=true
##全局重试次数，默认为0
#liteflow.retry-count=0
##是否支持不同类型的加载方式混用，默认为false
#liteflow.support-multiple-type=false
##是否开启监控log打印，默认值为false
#liteflow.monitor.enable-log=true
##监控队列存储大小，默认值为200
#liteflow.monitor.queue-limit=300
##监控一开始延迟多少执行，默认值为300000毫秒，也就是5分钟
#liteflow.monitor.delay=10000
##监控日志打印每过多少时间执行一次，默认值为300000毫秒，也就是5分钟
#liteflow.monitor.period=10000
activityFlow.xml
<flow>
<chain name="activityFlow">
<then value="activitySlotInitCmp"/>
<then value="activityParamCheckCmp"/>
<then value="activityToolsCheckCmp"/>
chain>
flow>
ActivityReqVO
package com.zrj.liteflow.bean.activity;
import com.yomahub.liteflow.entity.data.AbsSlot;
import lombok.Builder;
import lombok.Data;
import java.util.Date;
import java.util.List;
/**
* 活动请求对象
*
* @author zrj
* @since 2021/11/15
**/
@Data
@Builder
public class ActivityReqVO extends AbsSlot {
/**
* 活动编码
*/
private String activityCode;
/**
* 活动名称
*/
private String activityName;
/**
* 活动开始时间
*/
private Date validStartTime;
/**
* 活动结束时间
*/
private Date validEndTime;
/**
* 活动工具
*/
private List<ActivityTools> activityToolsList;
}
ActivityTools
package com.zrj.liteflow.bean.activity;
import lombok.Builder;
import lombok.Data;
/**
* @author zrj
* @since 2021/11/15
**/
@Data
@Builder
public class ActivityTools {
/**
* 活动编码
*/
private String activityCode;
/**
* 活动工具编码
*/
private String actToolCode;
/**
* 活动工具名称
*/
private String actToolName;
}
ActivityParamCheckCmp
package com.zrj.liteflow.component.activity;
import com.yomahub.liteflow.core.NodeComponent;
import com.zrj.liteflow.slot.ActivitySlot;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Component;
/**
* 活动请求参数校验
*
* @author zrj
* @since 2021/11/15
**/
@Slf4j
@Component("activityParamCheckCmp")
public class ActivityParamCheckCmp extends NodeComponent {
@Override
public void process() throws Exception {
log.info("【活动请求参数校验】");
ActivitySlot activitySlot = this.getSlot();
if (!checkActParam(activitySlot.getActivityCode())) {
activitySlot.setPrintLog("活动编码为空异常");
throw new RuntimeException("活动编码为空异常");
}
}
/**
* 参数校验
*/
private boolean checkActParam(String code) {
if (code == null) {
return false;
}
return true;
}
}
ActivitySlotInitCmp
package com.zrj.liteflow.component.activity;
import com.yomahub.liteflow.core.NodeComponent;
import com.zrj.liteflow.bean.activity.ActivityReqVO;
import com.zrj.liteflow.slot.ActivitySlot;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Component;
/**
* 初始化活动数据槽
*
* @author zrj
* @since 2021/11/15
**/
@Slf4j
@Component("activitySlotInitCmp")
public class ActivitySlotInitCmp extends NodeComponent {
@Override
public void process() throws Exception {
log.info("【初始化活动数据槽】");
ActivityReqVO req = this.getSlot().getRequestData();
ActivitySlot activitySlot = this.getSlot();
activitySlot.setActivityCode(req.getActivityCode());
activitySlot.setActivityName(req.getActivityName());
activitySlot.setActivityToolsList(req.getActivityToolsList());
}
/**
* 是否进入该节点
*
* @return boolean
*/
@Override
public boolean isAccess() {
ActivityReqVO req = this.getSlot().getRequestData();
if (req != null) {
return true;
} else {
return false;
}
}
}
ActivityToolsCheckCmp
package com.zrj.liteflow.component.activity;
import com.yomahub.liteflow.core.NodeComponent;
import com.zrj.liteflow.bean.activity.ActivityTools;
import com.zrj.liteflow.slot.ActivitySlot;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Component;
import java.util.List;
/**
* 活动请求参数校验
*
* @author zrj
* @since 2021/11/15
**/
@Slf4j
@Component("activityToolsCheckCmp")
public class ActivityToolsCheckCmp extends NodeComponent {
@Override
public void process() throws Exception {
log.info("【活动工具校验】");
ActivitySlot activitySlot = this.getSlot();
List<ActivityTools> activityToolsList = activitySlot.getActivityToolsList();
activitySlot.setPrintLog("活动流程测试成功");
}
}
ActivitySlot
package com.zrj.liteflow.slot;
import com.yomahub.liteflow.entity.data.AbsSlot;
import com.zrj.liteflow.bean.activity.ActivityTools;
import lombok.Data;
import java.util.Date;
import java.util.List;
/**
* 活动数据槽
*
* @author zrj
* @since 2021/11/15
**/
@Data
public class ActivitySlot extends AbsSlot {
/**
* 活动编码
*/
private String activityCode;
/**
* 活动名称
*/
private String activityName;
/**
* 活动开始时间
*/
private Date validStartTime;
/**
* 活动结束时间
*/
private Date validEndTime;
/**
* 活动工具
*/
private List<ActivityTools> activityToolsList;
/**
* 步骤日志
*/
private String printLog;
}
ActivityController
package com.zrj.liteflow.controller;
import cn.hutool.core.date.DateUtil;
import com.yomahub.liteflow.core.FlowExecutor;
import com.yomahub.liteflow.entity.data.LiteflowResponse;
import com.zrj.liteflow.bean.activity.ActivityReqVO;
import com.zrj.liteflow.bean.activity.ActivityTools;
import com.zrj.liteflow.slot.ActivitySlot;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import javax.annotation.Resource;
import java.util.ArrayList;
import java.util.List;
/**
* @author zrj
* @since 2021/11/15
**/
@RestController
@RequestMapping("/activity")
public class ActivityController {
@Resource
private FlowExecutor flowExecutor;
@GetMapping("/liteflow")
public String liteflow() {
ActivityReqVO activityReqVO = builder();
//ActivityReqVO activityReqVO = null;
try {
LiteflowResponse<ActivitySlot> response = flowExecutor.execute2Resp("activityFlow", activityReqVO, ActivitySlot.class);
return response.getSlot().getPrintLog();
} catch (Throwable t) {
t.printStackTrace();
return "error";
}
}
/**
* 构建请求对象
*/
private ActivityReqVO builder() {
List<ActivityTools> activityToolsList = new ArrayList<>(10);
activityToolsList.add(ActivityTools.builder().activityCode("20211115001").actToolName("大转盘").build());
activityToolsList.add(ActivityTools.builder().activityCode("20211115001").actToolName("红包雨").build());
return ActivityReqVO.builder()
.activityCode("20211115001")
.activityName("双十一大促")
.validStartTime(DateUtil.date())
.validEndTime(DateUtil.date())
.activityToolsList(activityToolsList)
.build();
}
}
输出验证
http://localhost:8580/activity/liteflow
2021-11-15 19:05:26.017 INFO 6844 --- [nio-8580-exec-8] c.z.l.c.activity.ActivitySlotInitCmp : 【初始化活动数据槽】
2021-11-15 19:05:26.017 INFO 6844 --- [nio-8580-exec-8] com.yomahub.liteflow.core.NodeComponent : [33776573532900]:[O]start component[ActivityParamCheckCmp] execution
2021-11-15 19:05:26.017 INFO 6844 --- [nio-8580-exec-8] c.z.l.c.activity.ActivityParamCheckCmp : 【活动请求参数校验】
2021-11-15 19:05:26.017 INFO 6844 --- [nio-8580-exec-8] com.yomahub.liteflow.core.NodeComponent : [33776573532900]:[O]start component[ActivityToolsCheckCmp] execution
2021-11-15 19:05:26.017 INFO 6844 --- [nio-8580-exec-8] c.z.l.c.activity.ActivityToolsCheckCmp : 【活动工具校验】
2021-11-15 19:05:26.017 INFO 6844 --- [nio-8580-exec-8] com.yomahub.liteflow.entity.data.Slot : [33776573532900]:CHAIN_NAME[activityFlow]
activitySlotInitCmp==>activityParamCheckCmp==>activityToolsCheckCmp