Activiti 框架介绍与使用
一、框架简介
Activiti 是基于 Apache 许可的开源 BPM 平台,由原 JBPM 架构师 Tom Baeyens 创建。作为符合 BPMN 2.0 标准的轻量级工作流引擎,它提供:
- 分层架构:支持 Spring/Spring Boot 集成
- 可视化设计:Eclipse 插件支持图形化流程设计
- 微服务支持:分 Activiti Core(核心引擎)和 Activiti Cloud(云原生方案)
- 数据库结构:
ACT_RE_*:流程定义资源表(存储 BPMN 文件)ACT_RU_*:运行时数据表(流程实例、任务等)ACT_HI_*:历史数据表(流程结束后归档)ACT_ID_*:身份认证表(用户、组信息)
适用场景:OA审批、订单处理、供应链管理等需要流程自动化的业务系统
二、快速入门教程
1. 环境准备
- JDK 1.8+(推荐 JDK 11)
- Maven 依赖:
<dependency> <groupId>org.activiti</groupId> <artifactId>activiti-spring-boot-starter</artifactId> <version>7.1.0.M6</version> </dependency>
2. 流程设计(Eclipse 插件)
- 安装 Activiti BPMN 2.0 Designer 插件
- 创建请假流程示例:
<process id="leaveProcess"> <startEvent id="start"/> <userTask id="applyTask" name="提交申请" activiti:assignee="${applicant}"/> <userTask id="approveTask" name="经理审批" activiti:candidateGroups="managers"/> <endEvent id="end"/> <sequenceFlow sourceRef="start" targetRef="applyTask"/> <sequenceFlow sourceRef="applyTask" targetRef="approveTask"/> <sequenceFlow sourceRef="approveTask" targetRef="end"/> </process>
3. Spring Boot 集成
# application.properties
spring.datasource.url=jdbc:mysql://localhost:3306/activiti_db
activiti.database-schema-update=true # 自动初始化表结构
4. 启动流程实例
@Autowired private RuntimeService runtimeService;
public void startLeaveProcess(String employeeName) {
Map<String, Object> vars = new HashMap<>();
vars.put("applicant", employeeName);
runtimeService.startProcessInstanceByKey("leaveProcess", vars);
}
三、核心功能实现
1. 会签(多审批人)
<userTask id="multiApprove">
<multiInstanceLoopCharacteristics
activiti:collection="${approvers}"
activiti:elementVariable="approver">
<completionCondition>${nrOfCompletedInstances >= 2}</completionCondition>
</multiInstanceLoopCharacteristics>
</userTask>
collection:审批人列表变量completionCondition:通过条件(示例:至少2人同意)
2. 任务超时处理
<boundaryEvent id="timeoutEvent" attachedToRef="approveTask">
<timerEventDefinition>
<timeDuration>PT24H</timeDuration> <!-- 24小时超时 -->
</timerEventDefinition>
</boundaryEvent>
超时后可连接自动处理节点或升级审批
3. 历史数据查询
historyService.createHistoricProcessInstanceQuery()
.finished() // 查询已结束流程
.variableValueEquals("applicant", "张三")
.list();
四、常见问题解决
| 问题现象 | 解决方案 |
|---|---|
| 数据库表未创建 | 检查配置:activiti.database-schema-update=true |
| 任务无法签收 | 调用 taskService.claim(taskId, userId) 显式签收 |
| 流程变量丢失 | 确保使用 runtimeService.setVariable() 持久化变量 |
| 性能瓶颈 | 启用异步执行器:activiti.async-executor-activate=true |
| 历史数据过大 | 定期清理 ACT_HI_* 表或配置历史级别 |
调试建议:使用
act_ge_bytearray表查看部署的 BPMN 文件源码
五、与 Camunda 对比
| 特性 | Activiti | Camunda |
|---|---|---|
| 起源 | Alfresco 团队创建 | Activiti 核心团队分支 |
| 社区生态 | 较大企业用户群 | 更活跃的开源社区 |
| 微服务支持 | 通过 Activiti Cloud 实现 | 原生支持更完善 |
| 流程监控 | 基础监控界面 | 提供更强大的 Cockpit 监控平台 |
思维导图

Activiti 工作流引擎技术解析
Activiti 是基于 BPMN 2.0 标准 的轻量级开源工作流引擎,其核心通过状态机模型驱动流程流转,结合持久化机制确保流程可靠性。以下是关键技术实现:
一、核心原理与算法
-
流程执行模型
- 有向图遍历:将 BPMN 流程抽象为节点(Node)和边(Transition)组成的有向图,使用深度优先搜索(DFS) 推进流程。
- Token 机制:每个流程实例生成虚拟 Token,沿序列流(Sequence Flow)移动触发节点行为。
- 异步执行器:通过
activiti.async-executor-activate=true启用,将耗时操作(如邮件通知)放入队列异步执行。
-
任务分配算法
- 静态分配:在 BPMN 中预定义
activiti:assignee="user1" - 动态分配:通过表达式或监听器动态计算责任人:
taskService.complete(taskId, variables); // 提交时传入动态参数 - 会签算法:多实例任务(Multi-Instance)使用
nrOfInstances(总实例数)和nrOfActiveInstances(活跃数)计算完成条件。
- 静态分配:在 BPMN 中预定义
二、数据结构设计
数据库表结构(关键表):
| 表前缀 | 作用 | 数据结构 |
|---|---|---|
ACT_RU_EXECUTION | 运行时流程实例 | 树形结构存储父子执行流 |
ACT_RU_TASK | 运行时任务 | 包含 ASSIGNEE_(负责人)、NAME_(任务名) |
ACT_HI_VARINST | 历史变量 | 存储流程变量键值对 |
ACT_GE_BYTEARRAY | 资源文件 | 存储 BPMN XML 的二进制数据 |
内存数据结构:
- DeploymentCache:缓存已部署的流程定义(
ProcessDefinition对象) - ExecutionEntity:运行时流程实例的 Java 对象表示
三、核心组件功能
| 组件 | 功能 | 关键 API |
|---|---|---|
| RepositoryService | 部署流程定义 | deploy() / createDeployment() |
| RuntimeService | 启动流程实例 | startProcessInstanceByKey() |
| TaskService | 管理任务 | complete() / claim() |
| HistoryService | 查询历史数据 | createHistoricProcessInstanceQuery() |
| IdentityService | 管理用户/组 | createUserQuery() |
四、优缺点分析
✅ 优势:
- 与 Spring 生态无缝集成,支持 Spring Boot 自动配置
- 轻量级设计,核心引擎仅依赖 MyBatis 和 JDBC
- 可视化监控:提供 Actuator 端点查看流程状态
❌ 劣势:
- 历史数据膨胀:
ACT_HI_*表需手动清理或配置归档策略 - 分布式事务弱:原生不支持 Saga 模式,微服务需额外封装
- 社区活跃度下降:部分企业转向 Camunda/Flowable(功能更强大)
五、Java 代码示例
// 1. 部署流程定义(带注释)
RepositoryService repositoryService = processEngine.getRepositoryService();
Deployment deployment = repositoryService.createDeployment()
.addClasspathResource("processes/leave.bpmn20.xml") // 加载BPMN文件
.name("请假流程")
.deploy(); // 部署到数据库
// 2. 启动流程实例
RuntimeService runtimeService = processEngine.getRuntimeService();
Map<String, Object> variables = new HashMap<>();
variables.put("applicant", "张三"); // 设置流程变量
ProcessInstance instance = runtimeService.startProcessInstanceByKey(
"leaveProcess", // 流程定义的key
variables // 动态参数
);
// 3. 查询并完成任务
TaskService taskService = processEngine.getTaskService();
Task task = taskService.createTaskQuery()
.processInstanceId(instance.getId()) // 按实例ID查询
.singleResult(); // 获取单个任务
taskService.complete(task.getId()); // 完成任务,推进到下一节点
关键注释:
startProcessInstanceByKey()触发流程时会创建ACT_RU_EXECUTION(执行流)和ACT_RU_TASK(任务)记录complete()方法内部会删除当前任务,并根据 BPMN 的流向生成新任务
总结
Activiti 通过 BPMN 2.0 解析器 将 XML 转化为可执行模型,依赖持久化状态机确保流程一致性,适合传统单体应用。但在微服务场景下,其分布式事务和历史数据管理需额外设计,此时可评估 Camunda 或 Flowable 等替代方案。
思维导图

Activiti 高级特性实现详解
针对会签流程、任务超时、动态分配、微服务部署及历史数据优化五大场景,结合 Activiti 技术原理进行深度解析:
一、多审批人会签流程实现
原理:基于 BPMN 2.0 多实例活动(Multi-Instance),通过 loopCardinality 或 collection 属性动态生成任务实例。
核心机制:
- 并行/串行控制:
isSequential属性决定审批顺序 - 完成条件:
completionCondition表达式(如nrOfCompletedInstances/nrOfInstances >= 0.6) - 内置变量:
nrOfInstances:总实例数nrOfActiveInstances:活跃实例数
BPMN 配置示例:
<userTask id="multiApproval" name="会签审批">
<multiInstanceLoopCharacteristics
isSequential="false"
activiti:collection="${approvers}" <!-- 动态审批人列表 -->
activiti:elementVariable="approver">
<completionCondition>${nrOfCompletedInstances >= 2}</completionCondition>
</multiInstanceLoopCharacteristics>
</userTask>
Java 代码启动:
List<String> approvers = Arrays.asList("user1", "user2", "user3");
Map<String, Object> vars = new HashMap<>();
vars.put("approvers", approvers); // 设置动态审批人集合
runtimeService.startProcessInstanceByKey("multiInstanceProcess", vars);
二、任务超时自动处理
实现方案:
- 边界定时事件(Boundary Timer Event)
<userTask id="task1">
<boundaryEvent id="timeoutEvent" attachedToRef="task1">
<timerEventDefinition>
<timeDuration>PT24H</timeDuration> <!-- 24小时后超时 -->
</timerEventDefinition>
</boundaryEvent>
</userTask>
- 异步作业监听器
public class TimeoutHandler implements JobListener {
@Override
public void notify(DelegateJob job) {
// 超时自动完成任务
taskService.complete(job.getExecutionId());
// 或触发升级处理
runtimeService.setVariable(job.getExecutionId(), "escalation", true);
}
}
配置:在 activiti.cfg.xml 启用异步执行器
<property name="asyncExecutorActivate" value="true" />
三、动态任务分配
三种实现方式:
- EL 表达式(BPMN 内嵌)
<userTask id="task1" activiti:assignee="${taskOwner}"/>
- 任务监听器动态分配(引用[3]方案)
public class DynamicAssignmentListener implements TaskListener {
@Override
public void notify(DelegateTask task) {
// 从数据库读取负责人
String assignee = userService.resolveAssignee(task.getProcessDefinitionId());
task.setAssignee(assignee);
// 或添加候选组
task.addCandidateGroup("deptLeader");
}
}
BPMN 关联监听器:
<extensionElements>
<activiti:taskListener event="create" class="com.example.DynamicAssignmentListener"/>
</extensionElements>
- API 运行时修改
taskService.setAssignee(taskId, "newOwner");
四、微服务部署方案
架构设计:
关键实现:
-
服务拆分:
- 独立部署流程微服务,提供 REST/gRPC 接口
- 其他服务通过事件触发流程(如
@EventListener)
-
分布式事务:
- 采用 Saga 模式 补偿事务
// 流程失败时触发补偿 runtimeService.suspendProcessInstanceById(piId); orderService.cancelOrder(orderId); // 调用原服务回滚 -
高可用部署:
- 数据库集群:MySQL Group Replication
- 引擎集群:多节点 + 共享 Job 队列
- 配置中心:动态更新流程定义(如 Apollo)
五、历史数据存储优化
性能瓶颈:ACT_HI_* 表占 70% 以上存储空间
优化策略:
- 历史级别降级
ProcessEngineConfiguration config = new StandaloneProcessEngineConfiguration()
.setHistory("audit"); // 仅记录关键事件(默认full)
- 定时归档清理
// Spring Boot 定时任务示例
@Scheduled(cron = "0 0 3 * * ?") // 每天凌晨3点执行
public void archiveHistory() {
historyService.createHistoricProcessInstanceQuery()
.finishedBefore(DateUtils.addMonths(new Date(), -3)) // 清理3月前数据
.list()
.forEach(pi -> historyService.deleteHistoricProcessInstance(pi.getId()));
}
-
分库分表方案:
数据类别 存储方案 运行时数据 主业务库(高频读写) 历史数据 ClickHouse 列式存储 二进制资源 对象存储(MinIO/S3) -
自定义历史处理器
public class CustomHistoryManager extends DefaultHistoryManager {
@Override
public void recordVariableUpdate(...) {
if(variableName.startsWith("temp_")) return; // 跳过临时变量
super.recordVariableUpdate(...);
}
}
总结对比
| 功能模块 | 实现方案 | 性能影响 |
|---|---|---|
| 多审批人会签 | 多实例活动+完成条件表达式 | 中(并行锁竞争) |
| 任务超时 | 边界定时器+异步作业 | 低 |
| 动态分配 | 监听器+运行时API | 低 |
| 微服务部署 | 独立流程服务+Saga事务 | 高(网络延迟) |
| 历史数据优化 | 分级存储+定时清理+分库 | 显著降低 I/O |
关键建议:
- 会签场景避免超大规模并行(>100实例)
- 历史数据采用
audit级别 + 按月分表- 微服务部署需封装流程启动/回调的幂等接口
思维导图

4614



被折叠的 条评论
为什么被折叠?



