如何使用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 规范