Activiti 实战教程：快速上手工作流自动化工具

Activiti 实战教程引领您快速上手工作流自动化工具，深入了解其在企业级应用开发中的关键作用。作为一款基于Java的高性能、灵活且易于集成的工作流和业务流程管理引擎，Activiti 提供了完整的执行框架，支持多样的流程定义方式、执行策略与可视化设计，是构建复杂流程系统的理想选择。

安装与配置步骤

1. 下载Activiti相关依赖，包括Activiti Engine、Activiti BPMN Modeler（图形化设计工具）等。

# 下载Activiti Engine
wget https://repo1.maven.org/maven2/org/activiti/engine/8.5.6/activiti-engine-8.5.6.jar

# 下载Activiti BPMN Modeler
wget https://repo1.maven.org/maven2/org/activiti/designer/8.5.6/activiti-bpmn-modeler-8.5.6.jar

2. 配置Java环境，确保Java 8或更高版本安装。

3. 创建一个Java项目，使用Maven或Gradle作为构建工具。

在pom.xml或build.gradle文件中添加Activiti依赖：

<!-- Maven -->
<dependencies>
    <dependency>
        <groupId>org.activiti.engine</groupId>
        <artifactId>activiti-engine</artifactId>
        <version>8.5.6</version>
    </dependency>
</dependencies>

<!-- Gradle -->
dependencies {
    implementation 'org.activiti.engine:activiti-engine:8.5.6'
}

流程的概念与类型

流程通常被定义为一组有序的活动，这些活动按照特定的逻辑和规则进行执行，直到完成某些目标。在Activiti中，流程可以通过 BPMN（Business Process Model and Notation）语言来描述。

使用 Activiti 设计简单流程

首先，我们需要定义流程的起点和终点，以及流程内部的活动节点。

// 导入 Activiti 工具类
import org.activiti.engine.ProcessEngine;
import org.activiti.engine.ProcessEngines;
import org.activiti.engine.repository.Deployment;
import org.activiti.engine.repository.ProcessDefinition;
import org.activiti.engine.runtime.ProcessInstance;

public class SimpleWorkflow {

    public static void main(String[] args) {
        ProcessEngine engine = ProcessEngines.getDefaultProcessEngine();

        // 部署流程定义
        Deployment deployment = engine.getRepositoryService()
                .createDeployment()
                .addClasspathResource("myProcess.bpmn20.xml")
                .name("My Simple Workflow")
                .deploy();

        // 启动流程实例
        ProcessInstance processInstance = engine.getRuntimeService()
                .startProcessInstanceByKey("myProcess");

        System.out.println("流程实例ID: " + processInstance.getId());
    }
}

这里的 myProcess.bpmn20.xml 是一个BPMN描述文件，包含流程定义。文件可能如下所示：

<?xml version="1.0" encoding="UTF-8"?>
<process id="myProcess" name="My Simple Workflow">
    <startEvent id="startEvent">
        <messageEventDefinition message="myMessage"/>
    </startEvent>
    <sequenceFlow id="startToTask1" source="startEvent" target="task1"/>
    <task id="task1" name="Task 1">
        <messageEventDefinition message="myMessage"/>
        <exclusiveGateway id="gate1" default="false"/>
    </task>
    <sequenceFlow id="task1ToEnd" source="gate1" target="endEvent"/>
    <endEvent id="endEvent">
        <messageEventDefinition message="myMessage"/>
    </endEvent>
</process>

创建流程定义

定义流程时，可以使用 BPMN 标签来描述流程的结构和功能，如活动、连接、网关等。

添加工作项与任务

在流程中添加任务时，可以指派特定的用户或角色来执行。

// 定义任务分配
public void assignTask(TaskService taskService) {
    Task task = taskService.createTaskQuery()
            .taskCandidateUser("John")
            .singleResult();

    taskService.tasks().assign(task.getId(), "Jane"); // 分配任务给Jane
    taskService.tasks().complete(task.getId());       // 完成任务
}

设置流程执行规则

规则可以涉及用户权限、任务优先级、活动的自动处理等。

// 设置活动的执行策略（并发或顺序）
engine.getProcessEngineConfiguration().setActivityInstanceTokenReuse(false);

运行流程实例

启动流程实例后，Activiti 会跟踪流程的执行状态，并记录流程日志。

public static void main(String[] args) {
    ProcessEngine engine = ProcessEngines.getDefaultProcessEngine();

    // 启动流程实例
    ProcessInstance processInstance = engine.getRuntimeService()
            .startProcessInstanceByKey("myProcess");

    // 打印流程实例ID
    System.out.println("流程实例ID: " + processInstance.getId());

    // 监听流程事件
    ProcessEventListener listener = new ProcessEventListener() {
        @Override
        public void notify(ActivitiEvent event) {
            if (event instanceof ProcessInstanceEvent) {
                ProcessInstanceEvent processInstanceEvent = (ProcessInstanceEvent) event;
                if (processInstanceEvent.getState() == ProcessInstance.STATE_TERMINATED) {
                    System.out.println("流程结束: " + processInstanceEvent.getProcessInstanceId());
                }
            }
        }
    };
    engine.getProcessEngineConfiguration().getEventDispatcher().addEventListener(listener);
}

使用监控工具跟踪流程状态

Activiti 提供了监控界面，可以实时查看流程实例的执行情况和历史数据。

// 监控流程实例
ProcessEngineConfiguration config = engine.getProcessEngineConfiguration();
MonitoringService monitoringService = config.getMonitoringService();
ProcessInstance processInstance = engine.getRuntimeService().createProcessInstanceQuery()
        .active()
        .singleResult();

monitoringService.executeCommand(new Command<Long>() {
    @Override
    public Long execute(CommandContext commandContext) {
        return commandContext.getHistoryManager().getProcessInstanceHistory(processInstance.getId()).size();
    }
});

用户权限管理

Activiti 支持基于角色的访问控制（RBAC），允许定义不同的用户组和权限。

任务分配与协作

任务可以自动分配给具有特定权限的用户，或者通过工作流逻辑自动流转。

故障恢复与异常处理技巧

处理流程异常时，可以使用异常捕获和恢复机制，确保流程的稳定性和可靠性。

通过这些实践和技巧，您将能够更高效地利用 Activiti 工具，构建复杂且健壮的工作流系统。