Activiti7工作流引擎：实战篇(一) ServiceTask自动化决策

1. ServiceTask在Activiti7中的核心作用

工作流引擎的核心价值在于将业务流程中的重复性操作标准化，而ServiceTask正是实现自动化决策的关键组件。与传统UserTask不同，ServiceTask不需要人工干预，它能够在流程执行时自动调用预先定义好的业务逻辑。想象一下公司请假流程：当员工提交申请后，系统需要自动判断申请人的职级，如果是部门经理则直接跳转到总经理审批，普通员工则需要经过部门经理审批。这种智能路由正是ServiceTask的典型应用场景。

在实际项目中，我发现很多团队还在用人工审批节点做条件判断，这不仅增加了不必要的操作步骤，还容易产生人为错误。通过ServiceTask配合表达式语言，我们可以将这类业务规则抽象为可复用的自动化服务。比如判断用户角色、计算审批阈值、验证数据完整性等场景，都是ServiceTask大显身手的地方。

2. 构建自动化决策的三大要素

2.1 流程定义配置要点

在.bpmn文件中配置ServiceTask时，这几个参数需要特别注意：

• Type属性必须设置为Expression
• Expression表达式的格式为${beanId.methodName(execution)}
• 异步属性根据业务需求决定是否开启

这里有个实际配置示例：

xml复制<serviceTask id="judgeManagerTask" 
           name="判断申请人职级"
           activiti:expression="${leaveService.checkPosition(execution)}"/>

我曾经遇到过表达式配置错误导致流程卡死的情况，后来总结出几个排查要点：

1. beanId必须与Spring容器中的bean名称完全一致
2. 方法参数必须是DelegateExecution类型
3. 方法返回值建议使用void，通过execution设置流程变量

2.2 业务逻辑实现技巧

对应的Spring Bean实现需要遵循特定规范：

java复制@Service("leaveService")
public class LeaveApprovalService {
    
    public void checkPosition(DelegateExecution execution) {
        String applicant = (String) execution.getVariable("applicant");
        String department = getDepartment(applicant);
        
        // 判断是否部门负责人
        boolean isManager = departmentManagerService.isDepartmentManager(applicant);
        execution.setVariable("isManager", isManager);
        
        // 设置下一节点审批人
        if(isManager){
            execution.setVariable("nextApprover", "generalManager");
        }else{
            execution.setVariable("nextApprover", department+"Manager");
        }
    }
}

这段代码展示了几个最佳实践：

1. 从execution中获取流程变量时要做类型转换
2. 复杂的业务判断可以委托给专门的service处理
3. 通过setVariable方法输出决策结果
4. 变量命名要有明确业务含义

2.3 流程变量传递机制

流程变量是连接ServiceTask与网关决策的桥梁。在请假流程示例中，我们通过isManager变量控制流程走向。这里特别要注意变量作用域的问题：

• 流程实例变量：在整个流程实例中有效
• 任务局部变量：仅在当前任务范围内有效
• 临时变量：不会持久化到数据库

我曾经踩过一个坑：在并行网关分支中修改了同名变量，导致流程状态混乱。后来通过给变量添加分支前缀解决了这个问题。比如：

java复制execution.setVariable("branchA_isManager", true);

3. 实战：智能请假审批系统

3.1 完整流程设计

让我们通过一个端到端的例子来串联所有知识点。假设要实现这样的请假流程：

1. 员工提交申请
2. 系统自动判断：
   • 普通员工 → 部门经理审批 → 人事备案
   • 部门经理 → 直接到总经理审批
3. 最终归档

对应的BPMN主要结构应该是：

code复制开始事件 → 提交申请(UserTask) → 职级判断(ServiceTask) → 
    [是经理?] → 排他网关 → 
        (是)总经理审批(UserTask)
        (否)部门经理审批(UserTask) 
    → 人事归档 → 结束事件

3.2 关键代码实现

流程启动时需要初始化申请人信息：

java复制public void startLeaveProcess(String applicant) {
    Map<String, Object> vars = new HashMap<>();
    vars.put("applicant", applicant);
    vars.put("applyTime", new Date());
    
    runtimeService.startProcessInstanceByKey(
        "smartLeaveProcess", 
        vars
    );
}

测试用例要覆盖各种职级场景：

java复制@Test
void testManagerFlow() {
    // 模拟部门经理申请
    startLeaveProcess("managerZhang");
    
    Task currentTask = taskService.createTaskQuery()
        .taskAssignee("generalManager")
        .singleResult();
    assertNotNull("总经理应有审批任务", currentTask);
}

@Test
void testEmployeeFlow() {
    // 模拟普通员工申请
    startLeaveProcess("staffLi");
    
    Task currentTask = taskService.createTaskQuery()
        .taskAssignee("devManager")
        .singleResult();
    assertNotNull("部门经理应有审批任务", currentTask);
}

3.3 性能优化建议

当审批量较大时，ServiceTask的实现要注意：

1. 避免在ServiceTask中执行耗时操作（如远程调用）
2. 考虑启用异步特性：

xml复制<serviceTask id="asyncTask" 
           activiti:async="true"
           activiti:expression="${longRunningService.process(execution)}"/>

3. 对频繁调用的判断逻辑添加缓存
4. 流程变量尽量使用简单类型

4. 常见问题排查指南

4.1 Bean找不到的解决方案

这是新手最常遇到的问题，表现是流程执行时报错"Unable to find bean"。可以从这几个方面检查：

1. Spring扫描路径是否包含Service类
2. bean名称是否与表达式中的完全匹配（注意大小写）
3. 是否在正确的Spring上下文中运行

有个小技巧：在测试类中注入该bean试试能否成功：

java复制@Autowired
private LeaveApprovalService leaveService; // 应该能正常注入

4.2 变量传递失效分析

当发现流程变量没有按预期传递时：

1. 先用historyService查历史变量记录

java复制HistoricVariableInstance variable = historyService
    .createHistoricVariableInstanceQuery()
    .processInstanceId(processInstanceId)
    .variableName("isManager")
    .singleResult();

2. 检查setVariable和getVariable的key是否一致
3. 确认变量作用域是否符合预期

4.3 事务管理要点

ServiceTask执行过程中如果抛出异常，会导致流程回滚。建议：

1. 对不可逆操作放在ServiceTask之后
2. 重要的业务状态变更要有补偿机制
3. 使用try-catch处理非关键异常

我曾经遇到过一个生产问题：因为邮件发送失败导致整个审批流程回滚。后来将通知类操作改为异步处理解决了这个问题。

5. 进阶应用场景

5.1 动态服务调用

通过表达式可以实现更灵活的调用方式：

xml复制<serviceTask activiti:expression="${beanMap[serviceName].handle(execution)}"/>

对应的Java代码：

java复制@Autowired
private Map<String, ApprovalHandler> beanMap;

// 根据流程变量决定使用哪个handler
execution.setVariable("serviceName", "financeApproval");

5.2 多条件组合判断

复杂决策可以组合多个ServiceTask：

code复制ServiceTask1(计算考勤) → 
ServiceTask2(计算剩余假期) → 
ServiceTask3(综合评估) → 
排他网关

每个Task专注于单一职责，最后通过流程变量汇总结果。

5.3 与规则引擎集成

对于特别复杂的业务规则，可以集成Drools等规则引擎：

java复制public void complexDecision(DelegateExecution execution) {
    KieSession kieSession = kieContainer.newKieSession();
    kieSession.insert(execution.getVariables());
    kieSession.fireAllRules();
    Map<String, Object> results = ...;
    execution.setVariables(results);
}

这种架构将易变的业务规则从流程定义中解耦出来，当审批规则变化时只需要更新规则文件，不需要修改流程定义。