springboot如何集成camunda

# SpringBoot如何集成Camunda

## 一、Camunda簡介

Camunda是一個輕量級的開源工作流和業務流程管理(BPM)平臺，基于BPMN 2.0標準實現。它提供了以下核心功能：

- **流程建模**：通過BPMN 2.0標準設計業務流程
- **流程執行**：部署和執行BPMN流程定義
- **任務管理**：處理用戶任務和服務任務
- **監控運維**：提供流程實例監控和運維管理

## 二、環境準備

在開始集成前，請確保已安裝以下環境：

1. JDK 1.8+
2. Maven 3.5+
3. SpringBoot 2.3+
4. 數據庫（支持H2、MySQL、PostgreSQL等）

## 三、創建SpringBoot項目

使用Spring Initializr創建基礎項目：

```bash
https://start.spring.io/

選擇依賴： - Spring Web - Spring Data JPA - H2 Database（開發環境推薦）

四、添加Camunda依賴

在pom.xml中添加Camunda相關依賴：

<!-- Camunda核心依賴 -->
<dependency>
    <groupId>org.camunda.bpm.springboot</groupId>
    <artifactId>camunda-bpm-spring-boot-starter</artifactId>
    <version>7.18.0</version>
</dependency>

<!-- Web應用支持 -->
<dependency>
    <groupId>org.camunda.bpm.springboot</groupId>
    <artifactId>camunda-bpm-spring-boot-starter-webapp</artifactId>
    <version>7.18.0</version>
</dependency>

<!-- REST API支持（可選） -->
<dependency>
    <groupId>org.camunda.bpm.springboot</groupId>
    <artifactId>camunda-bpm-spring-boot-starter-rest</artifactId>
    <version>7.18.0</version>
</dependency>

五、配置Camunda

1. 基本配置

在application.yml中添加配置：

camunda:
  bpm:
    admin-user:
      id: admin
      password: admin
      firstName: Admin
    filter:
      create: All tasks
    database:
      schema-update: true
    auto-deployment-enabled: true

2. 數據庫配置

對于生產環境，建議使用MySQL等數據庫：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/camunda?useSSL=false
    username: root
    password: root
    driver-class-name: com.mysql.cj.jdbc.Driver

六、創建第一個BPMN流程

1. 在resources目錄下創建processes文件夾
2. 添加一個簡單的審批流程sample.bpmn：

<?xml version="1.0" encoding="UTF-8"?>
<bpmn:definitions xmlns:bpmn="http://www.omg.org/spec/BPMN/20100524/MODEL"
                  xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI"
                  xmlns:dc="http://www.omg.org/spec/DD/20100524/DC"
                  xmlns:di="http://www.omg.org/spec/DD/20100524/DI"
                  id="Definitions_1"
                  targetNamespace="http://bpmn.io/schema/bpmn">
  <bpmn:process id="Process_1" isExecutable="true">
    <bpmn:startEvent id="StartEvent_1"/>
    <bpmn:userTask id="UserTask_1" name="審批申請"/>
    <bpmn:endEvent id="EndEvent_1"/>
    <bpmn:sequenceFlow id="Flow_1" sourceRef="StartEvent_1" targetRef="UserTask_1"/>
    <bpmn:sequenceFlow id="Flow_2" sourceRef="UserTask_1" targetRef="EndEvent_1"/>
  </bpmn:process>
  <bpmndi:BPMNDiagram id="BPMNDiagram_1">
    <!-- 省略圖形布局信息 -->
  </bpmndi:BPMNDiagram>
</bpmn:definitions>

七、實現流程服務

1. 創建流程服務類

@Service
public class ProcessService {
    
    @Autowired
    private RuntimeService runtimeService;
    
    @Autowired
    private TaskService taskService;
    
    public String startProcess() {
        ProcessInstance instance = runtimeService.startProcessInstanceByKey("Process_1");
        return instance.getId();
    }
    
    public List<Task> getTasks(String assignee) {
        return taskService.createTaskQuery()
                .taskAssignee(assignee)
                .list();
    }
    
    public void completeTask(String taskId) {
        taskService.complete(taskId);
    }
}

2. 創建REST控制器

@RestController
@RequestMapping("/api/process")
public class ProcessController {
    
    @Autowired
    private ProcessService processService;
    
    @PostMapping("/start")
    public String startProcess() {
        return processService.startProcess();
    }
    
    @GetMapping("/tasks")
    public List<Task> getTasks(@RequestParam String assignee) {
        return processService.getTasks(assignee);
    }
    
    @PostMapping("/complete")
    public void completeTask(@RequestParam String taskId) {
        processService.completeTask(taskId);
    }
}

八、自定義任務監聽器

@Component
public class ApprovalTaskListener implements TaskListener {
    
    @Override
    public void notify(DelegateTask delegateTask) {
        if ("UserTask_1".equals(delegateTask.getTaskDefinitionKey())) {
            delegateTask.setAssignee("demoUser");
            delegateTask.setVariable("approvalComment", "請審批");
        }
    }
}

九、訪問Camunda Web控制臺

啟動應用后，訪問以下URL： - 控制臺：http://localhost:8080/camunda/app/ - REST API：http://localhost:8080/engine-rest/

使用配置的用戶名密碼登錄（默認admin/admin）

十、高級配置

1. 多租戶配置

camunda:
  bpm:
    multi-tenancy:
      enabled: true
      tenant-id-provider: org.camunda.bpm.engine.impl.cfg.DefaultTenantIdProvider

2. 歷史級別配置

camunda:
  bpm:
    history-level: full

3. 郵件服務配置

camunda:
  bpm:
    mail-server:
      default-from: noreply@company.com
      host: mail.company.com
      port: 587
      username: user
      password: pass

十一、常見問題解決

1. 數據庫連接問題：

   • 確保數據庫用戶有足夠權限
   • 檢查數據庫驅動版本

2. 流程部署失敗：

   • 檢查BPMN文件是否符合規范
   • 查看日志中的詳細錯誤信息

3. 任務無法分配：

   • 確認監聽器是否正確配置
   • 檢查用戶是否存在

十二、最佳實踐建議

1. 流程版本控制：

   • 使用Camunda的版本控制功能
   • 為每個流程定義明確的版本號

2. 異常處理：

   • 實現邊界錯誤事件處理異常
   • 使用重試機制處理服務任務

3. 性能優化：

   • 合理設置歷史級別
   • 對高頻流程考慮異步執行

十三、總結

本文詳細介紹了如何在SpringBoot項目中集成Camunda工作流引擎，包括： - 環境準備和依賴配置 - 基本流程定義和部署 - 核心服務接口的使用 - 常見配置和優化建議

通過Camunda的集成，可以輕松實現復雜的業務流程管理，提高系統的靈活性和可維護性。

十四、擴展閱讀

1. Camunda官方文檔
2. BPMN 2.0規范
3. SpringBoot集成最佳實踐

”`

這篇文章提供了從環境準備到高級配置的完整指南，涵蓋了Camunda與SpringBoot集成的主要方面。您可以根據實際需求調整配置細節和流程設計。