Activiti 核心類速查手冊：流程引擎、服務接口與運行時對象全解析

為什麼選擇 Activiti？

傳統硬編碼流程的弊端：業務屬性與流程屬性混雜、流程邏輯與業務邏輯耦合、流程變更需修改代碼重新部署。Activiti 作為 Apache 許可的開源 BPM 平台，將流程定義外部化（BPMN 2.0），實現流程與業務解耦。

核心引擎配置類

七大核心 Service 接口

關鍵運行時對象關係圖

ProcessInstance (流程實例)
    └─ Execution (執行對象/令牌) ── ActivityImpl (活動節點)
           ├─ 可並行分支（多 Execution）
           └─ Task (用戶任務) ── 身份鏈接

• ProcessInstance：流程實例根節點，對應 ACT_RU_EXECUTION 表 PARENT_ID_=NULL 記錄
• Execution：流程執行分支，支持並行網關產生多實例
• Task：用戶任務節點，擴展自 Execution，包含辦理人、創建時間、截止時間
• ActivityImpl：流程定義中的靜態節點元數據（類型、坐標、屬性）

典型業務操作代碼片段

部署流程

repositoryService.createDeployment()
    .addClasspathResource("processes/leave.bpmn20.xml")
    .addClasspathResource("processes/leave.png")
    .name("請假流程 v1.0")
    .deploy();

啟動流程並設置業務鍵

ProcessInstance pi = runtimeService.startProcessInstanceByKey(
    "leaveProcess", 
    "businessKey_123",  // 關聯業務表主鍵
    variables);

處理用戶任務

// 簽收
taskService.claim(taskId, userId);
// 完成並攜帶變量
taskService.complete(taskId, Map.of("approved", true, "comment", "同意"));

進階應用場景

• 動態指派：TaskListener + 表達式 ${userService.findApprover(execution)}
• 流程變更：RuntimeService.createChangeActivityStateBuilder() 實現節點跳轉/回退
• 多租戶：Schema 隔離 / 字段隔離 + TenantIdProvider
• 事件監聽：實現 ActivitiEventListener 監聽流程/任務/變量事件

掌握 Activiti 核心類體系，是構建靈活、可維護工作流應用的基礎。建議配合 act-*.sql 腳本深入理解 23 張核心表結構，事半功倍。