【Java 开发日记】你会不会使用 SpringBoot 整合 Flowable 快速实现工作流呢？

当然会！Spring Boot 与 Flowable 的整合能够帮助我们快速实现工作流系统。Flowable 是一个轻量级的 BPMN引擎，它支持 业务流程建模与执行，并与 Spring Boot 很好地结合，使得我们可以快速构建基于 工作流 的应用。

Flowable 工作流简介

Flowable 是一个基于 BPMN 2.0（业务流程模型与符号）的工作流引擎，它可以帮助我们定义和执行业务流程。通过与 Spring Boot 的整合，我们可以非常便捷地将工作流引擎嵌入到业务应用中，支持流程定义、流程部署、流程执行等功能。

在本示例中，我将通过 Spring Boot 与 Flowable 的整合，展示如何实现一个简单的工作流。

步骤 1：项目依赖

首先，我们需要在 Spring Boot 项目中加入 Flowable 的相关依赖。

在 pom.xml 中添加以下依赖：

<dependencies>
    <!-- Spring Boot Starter Web -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <!-- Spring Boot Starter Thymeleaf -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-thymeleaf</artifactId>
    </dependency>

    <!-- Flowable Spring Boot Starter -->
    <dependency>
        <groupId>org.flowable</groupId>
        <artifactId>flowable-spring-boot-starter-rest</artifactId>
        <version>6.7.0</version>
    </dependency>

    <!-- Flowable Spring Boot Starter (includes DB support) -->
    <dependency>
        <groupId>org.flowable</groupId>
        <artifactId>flowable-spring-boot-starter</artifactId>
        <version>6.7.0</version>
    </dependency>

    <!-- Spring Boot Starter JDBC (For DB support) -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-jdbc</artifactId>
    </dependency>

    <!-- H2 Database (For testing) -->
    <dependency>
        <groupId>com.h2database</groupId>
        <artifactId>h2</artifactId>
        <scope>runtime</scope>
    </dependency>

    <!-- Spring Boot Starter Test (For testing) -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

这里我们使用了 Flowable Spring Boot Starter，它可以帮助我们快速将 Flowable 集成到 Spring Boot 项目中，并自动配置相关服务。

步骤 2：配置数据库（可选）

Flowable 引擎需要数据库支持，可以使用 H2 数据库进行开发测试。

在 application.properties 中进行如下配置：

# Flowable Database Configuration
spring.datasource.url=jdbc:h2:mem:flowable;DB_CLOSE_DELAY=-1;DB_CLOSE_ON_EXIT=FALSE
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=password
spring.jpa.hibernate.ddl-auto=update
spring.jpa.database-platform=org.hibernate.dialect.H2Dialect

# Enable Flowable (it is enabled by default)
flowable.id-generator-provider=db
flowable.async-executor-activate=false
flowable.async-executor-enabled=false

步骤 3：创建 BPMN 流程定义

创建一个 BPMN 2.0 流程模型，定义我们需要的工作流。我们可以通过 Flowable Modeler（一个可视化的 BPMN 设计工具）来定义工作流。

假设我们定义了一个简单的流程 holidayRequest.bpmn，其中包含了以下步骤：

• 提交申请：用户填写申请表单并提交。
• 经理审批：经理审批是否批准休假。
• 审批结果通知：根据经理审批结果，通知员工。

<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://www.omg.org/spec/BPMN/20100524/MODEL BPMN20.xsd"
             targetNamespace="Examples">
    <process id="holidayRequest" name="Holiday Request Process" isExecutable="true">
        <startEvent id="start" name="Start" />
        <sequenceFlow id="flow1" sourceRef="start" targetRef="task1" />
        <userTask id="task1" name="Request Holiday" />
        <sequenceFlow id="flow2" sourceRef="task1" targetRef="task2" />
        <userTask id="task2" name="Approve Holiday" />
        <sequenceFlow id="flow3" sourceRef="task2" targetRef="end" />
        <endEvent id="end" name="End" />
    </process>
</definitions>

该流程非常简单，包含了 开始事件、用户任务 和 结束事件，用户任务用于接收用户输入，审批任务用于经理审批。

步骤 4：流程部署

Flowable 支持从文件系统或通过 API 部署流程定义。在应用启动时，可以通过以下代码自动部署流程：

import org.flowable.engine.RepositoryService;
import org.flowable.engine.ProcessEngine;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class ProcessDeploymentService {

    @Autowired
    private ProcessEngine processEngine;

    public void deploy() {
        RepositoryService repositoryService = processEngine.getRepositoryService();
        repositoryService.createDeployment()
            .addClasspathResource("holidayRequest.bpmn20.xml")
            .deploy();
    }
}

步骤 5：启动流程实例

一旦流程被部署，可以启动一个流程实例，并在流程中执行用户任务。下面是启动流程并执行任务的代码：

import org.flowable.engine.RuntimeService;
import org.flowable.engine.TaskService;
import org.flowable.engine.task.Task;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HolidayRequestController {

    @Autowired
    private RuntimeService runtimeService;

    @Autowired
    private TaskService taskService;

    @GetMapping("/start")
    public String startProcess() {
        // 启动流程实例
        runtimeService.startProcessInstanceByKey("holidayRequest");
        return "Process started!";
    }

    @GetMapping("/complete")
    public String completeTask() {
        // 查询当前任务
        Task task = taskService.createTaskQuery().singleResult();
        if (task != null) {
            taskService.complete(task.getId());
            return "Task completed!";
        } else {
            return "No tasks available!";
        }
    }
}

步骤 6：运行与测试

启动应用程序后，我们可以通过访问以下 URL 来启动流程并完成任务：

• http://localhost:8080/start：启动一个新的流程实例。
• http://localhost:8080/complete：完成当前任务。

在此过程中，Flowable 会自动管理工作流的状态、任务分配、流程推进等。

总结

通过整合 Spring Boot 与 Flowable，我们能够快速实现一个简单的工作流系统。在实际应用中，你可以根据业务需求进行更复杂的流程定义、任务管理、流程监听等操作。Flowable 提供了非常强大的功能，能够帮助我们在应用中实现灵活的工作流解决方案。

这只是一个入门示例，Flowable 还支持 多种任务类型（如服务任务、脚本任务等），流程变量的管理，以及与 外部系统的集成 等高级功能，可以根据需求进一步拓展。