如何使用SpringBoot整合Activiti6工作流

如何使用SpringBoot整合Activiti6工作流

引言

Activiti 是一個輕量級的工作流和業務流程管理（BPM）平臺，它基于 Java 開發，支持 BPMN 2.0 標準。Spring Boot 是一個快速開發框架，能夠簡化 Spring 應用的初始搭建和開發過程。將 Activiti 與 Spring Boot 整合，可以快速構建基于工作流的應用程序。本文將詳細介紹如何使用 Spring Boot 整合 Activiti 6 工作流。

1. 環境準備

在開始之前，確保你已經安裝了以下工具：

• JDK 1.8 或更高版本
• Maven 3.x
• IntelliJ IDEA 或 Eclipse IDE

2. 創建 Spring Boot 項目

首先，使用 Spring Initializr 創建一個新的 Spring Boot 項目。選擇以下依賴：

• Spring Web
• Spring Data JPA
• H2 Database (用于測試)
• Activiti

生成項目后，解壓并導入到你的 IDE 中。

3. 配置 Activiti

在 application.properties 文件中，添加以下配置：

# 數據源配置
spring.datasource.url=jdbc:h2:mem:testdb
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=password

# H2 控制臺配置
spring.h2.console.enabled=true
spring.h2.console.path=/h2-console

# Activiti 配置
spring.activiti.database-schema-update=true
spring.activiti.check-process-definitions=false

4. 創建流程定義

在 src/main/resources 目錄下創建一個新的文件夾 processes，并在其中創建一個 BPMN 文件 myProcess.bpmn20.xml。以下是一個簡單的流程定義示例：

<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:activiti="http://activiti.org/bpmn"
             targetNamespace="http://www.activiti.org/test">

    <process id="myProcess" name="My Process">
        <startEvent id="startEvent" name="Start"/>
        <sequenceFlow id="flow1" sourceRef="startEvent" targetRef="task1"/>
        <userTask id="task1" name="Task 1"/>
        <sequenceFlow id="flow2" sourceRef="task1" targetRef="endEvent"/>
        <endEvent id="endEvent" name="End"/>
    </process>

</definitions>

5. 創建服務類

創建一個服務類 MyProcessService，用于啟動和管理流程實例：

@Service
public class MyProcessService {

    @Autowired
    private RuntimeService runtimeService;

    @Autowired
    private TaskService taskService;

    public void startProcess() {
        runtimeService.startProcessInstanceByKey("myProcess");
    }

    public List<Task> getTasks(String assignee) {
        return taskService.createTaskQuery().taskAssignee(assignee).list();
    }

    public void completeTask(String taskId) {
        taskService.complete(taskId);
    }
}

6. 創建控制器

創建一個控制器 MyProcessController，用于處理 HTTP 請求：

@RestController
@RequestMapping("/process")
public class MyProcessController {

    @Autowired
    private MyProcessService myProcessService;

    @PostMapping("/start")
    public String startProcess() {
        myProcessService.startProcess();
        return "Process started";
    }

    @GetMapping("/tasks")
    public List<Task> getTasks(@RequestParam String assignee) {
        return myProcessService.getTasks(assignee);
    }

    @PostMapping("/complete")
    public String completeTask(@RequestParam String taskId) {
        myProcessService.completeTask(taskId);
        return "Task completed";
    }
}

7. 運行和測試

啟動 Spring Boot 應用程序，訪問 http://localhost:8080/process/start 啟動流程。然后，你可以通過 http://localhost:8080/process/tasks?assignee=user1 獲取任務列表，并通過 http://localhost:8080/process/complete?taskId=taskId 完成任務。

8. 總結

通過以上步驟，你已經成功地將 Activiti 6 工作流整合到 Spring Boot 項目中。你可以在此基礎上進一步擴展和優化，例如添加更多的流程定義、任務監聽器、事件監聽器等。希望本文對你有所幫助，祝你在使用 Activiti 和 Spring Boot 開發工作流應用時取得成功！

參考文檔

• Activiti 官方文檔
• Spring Boot 官方文檔
• BPMN 2.0 規范