Activiti学习：初学者必备指南

本文将详细介绍Activiti学习的相关内容，包括Activiti的定义、应用场景、与其他工作流引擎的比较，以及环境搭建、流程定义和核心概念等。通过丰富的API接口和实战案例，帮助读者深入了解和应用Activiti。

Activiti定义

Activiti是一种开源的工作流和业务流程管理（BPM）平台。它基于BPMN 2.0标准，提供工作流引擎、流程定义、流程执行、监控等功能。Activiti主要由Java编写，提供了灵活的API来启动、监控和管理流程实例。

Activiti应用场景

Activiti广泛应用于各种业务场景，如企业资源规划（ERP）、客户关系管理（CRM）、人力资源管理（HRM）、财务管理系统（FMS）等。它可以帮助企业优化业务流程，提高工作效率，减少人工操作，并实现自动化处理。

Activiti与其他工作流引擎的比较

Activiti与其他工作流引擎相比，具有以下几个优势：

1. 轻量级：Activiti基于BPMN 2.0，能够简化流程定义，并且体积小、启动速度快。
2. 灵活度高：Activiti支持自定义扩展和插件，可以满足不同企业的需求。
3. 易于集成：Activiti提供了与各种数据库和应用系统的集成接口，方便与其他系统协同工作。
4. 强大的监控和管理功能：Activiti内置了强大的监控和管理工具，能够实时监控流程运行情况，并提供详细的统计分析报告。

开发环境搭建

为了开始使用Activiti，你需要搭建一个开发环境。以下是搭建步骤：

1. 安装JDK：确保你已经安装了一个Java开发工具包（JDK），如Java 8或更高版本。
2. 配置IDE：推荐使用Eclipse或IntelliJ IDEA等IDE，以便进行代码编辑和调试。
3. 下载Activiti依赖库：从Maven Central Repository中下载Activiti依赖库，或者将Activiti依赖项添加到你的Maven或Gradle项目中。

Maven配置示例

<dependencies>
    <dependency>
        <groupId>org.activiti</groupId>
        <artifactId>activiti-engine</artifactId>
        <version>6.0.0</version>
    </dependency>
    <dependency>
        <groupId>org.activiti</groupId>
        <artifactId>activiti-spring</artifactId>
        <version>6.0.0</version>
    </dependency>
</dependencies>

数据库配置

Activiti使用数据库来存储流程定义和实例数据。你需要在项目中配置数据库连接。以下是如何配置连接到MySQL数据库的示例：

1. 创建数据库：使用MySQL客户端工具创建一个新的数据库，例如activiti。
2. 创建数据库表：运行Activiti提供的数据库脚本以创建所需的表结构。脚本可以在Activiti的GitHub仓库中找到。

数据库配置示例

<bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource">
    <property name="driverClassName" value="com.mysql.jdbc.Driver"/>
    <property name="url" value="jdbc:mysql://localhost:3306/activiti"/>
    <property name="username" value="root"/>
    <property name="password" value="password"/>
</bean>

Activiti API介绍

Activiti引擎提供了丰富的API接口，用于启动和管理流程实例。主要的API接口包括：

• RepositoryService：用于管理流程定义。
• RuntimeService：用于启动流程实例、管理和查询流程实例。
• TaskService：用于管理和查询任务。
• HistoryService：用于查询历史流程实例和任务信息。

BPMN 2.0流程定义简介

BPMN 2.0是一种图形化的业务流程模型和表示法，它提供了一种标准的方式来描述业务流程。Activiti支持基于BPMN 2.0标准的流程定义。流程定义文件通常是XML格式，可以手动编写，也可以使用专门的设计器工具来创建。

使用XML定义流程

流程定义文件通常放在src/main/resources目录下。文件名格式为<process-id>.bpmn20.xml。以下是一个简单的流程定义示例：

<definitions xmlns="http://www.omg.org/spec/BPMN/20100301/BPMN20-MD" id="Definitions_1" targetNamespace="http://bpmn.io/schema/bpmn">
  <process id="leave" isExecutable="true">
    <startEvent id="startEvent_1" />
    <serviceTask id="serviceTask_1" name="Call Service" />
    <exclusiveGateway id="exclusiveGateway_1" />
    <userTask id="userTask_1" name="Manager Approval" />
    <endEvent id="endEvent_1" />
    <sequenceFlow id="sequenceFlow_1" sourceRef="startEvent_1" targetRef="serviceTask_1" />
    <sequenceFlow id="sequenceFlow_2" sourceRef="serviceTask_1" targetRef="exclusiveGateway_1" />
    <sequenceFlow id="sequenceFlow_3" sourceRef="exclusiveGateway_1" targetRef="userTask_1" />
    <sequenceFlow id="sequenceFlow_4" sourceRef="userTask_1" targetRef="endEvent_1" />
  </process>
</definitions>

使用设计器工具设计流程

Activiti提供了多种在线和离线的设计器工具，如Activiti Designer、BPMN.io等，可以图形化地编辑流程定义。以下是一个使用Activiti Designer创建流程定义的步骤：

1. 下载并安装设计器工具：可以从Activiti的GitHub仓库下载Activiti Designer。
2. 打开设计器工具：启动设计器工具，选择File -> New创建一个新的流程定义。
3. 拖拽流程元素：在设计器工具中，拖拽流程元素（如开始事件、服务任务、用户任务等）来构建流程。
4. 保存流程定义：完成流程设计后，保存流程定义文件到项目中。

流程实例与任务

流程实例是流程定义的具体运行实例。每个流程实例都会创建一个或多个任务。任务可以是用户任务（需要人工处理的任务），也可以是服务任务（由系统自动完成的任务）。

流程实例示例

RuntimeService runtimeService = processEngine.getRuntimeService();
ProcessInstance instance = runtimeService.startProcessInstanceByKey("leave");

任务示例

TaskService taskService = processEngine.getTaskService();
List<Task> tasks = taskService.createTaskQuery().list();

用户任务与服务任务

用户任务是由人工操作的任务，通常表示需要用户介入处理的步骤。服务任务是由系统自动完成的任务，通常表示需要调用服务或执行业务逻辑的步骤。

用户任务示例

Task task = taskService.createTaskQuery().taskName("Manager Approval").singleResult();
taskService.complete(task.getId());

服务任务示例

ServiceTask serviceTask = new ServiceTask();
serviceTask.setName("Call Service");
serviceTask.setAsync(true); // 异步执行

事件与监听器

事件是在流程执行期间触发的事件，如开始事件、结束事件等。监听器用于监听这些事件，可以实现特定的业务逻辑。

事件示例

<startEvent id="startEvent_1" />
<endEvent id="endEvent_1" />

监听器示例

public class MyEventListener implements StartEventListener {
    @Override
    public void notify(StartEvent event) {
        System.out.println("Start event triggered");
    }
}

启动流程实例

启动流程实例是指根据流程定义创建一个新的流程实例。可以使用RuntimeService接口来启动流程实例。

RuntimeService runtimeService = processEngine.getRuntimeService();
ProcessInstance instance = runtimeService.startProcessInstanceByKey("leave");

查询流程实例

查询流程实例是指获取流程实例的状态和信息。可以使用RuntimeService或HistoryService接口来查询流程实例。

ProcessInstance instance = runtimeService.createProcessInstanceQuery().processInstanceId("instanceId").singleResult();

完成任务与办理任务

完成任务是指处理用户任务并将其标记为已完成。可以使用TaskService接口来完成任务。

TaskService taskService = processEngine.getTaskService();
Task task = taskService.createTaskQuery().taskName("Manager Approval").singleResult();
taskService.complete(task.getId());

实战演练：请假流程

请假流程通常涉及员工提交请假申请、经理审批、HR确认等步骤。以下是如何实现一个简单的请假流程。

请假流程定义示例

<process id="leave" isExecutable="true">
  <startEvent id="startEvent_1" />
  <userTask id="userTask_1" name="Employee Request" />
  <exclusiveGateway id="exclusiveGateway_1" />
  <userTask id="userTask_2" name="Manager Approval" />
  <exclusiveGateway id="exclusiveGateway_2" />
  <userTask id="userTask_3" name="HR Approval" />
  <endEvent id="endEvent_1" />
  <sequenceFlow id="sequenceFlow_1" sourceRef="startEvent_1" targetRef="userTask_1" />
  <sequenceFlow id="sequenceFlow_2" sourceRef="userTask_1" targetRef="exclusiveGateway_1" />
  <sequenceFlow id="sequenceFlow_3" sourceRef="exclusiveGateway_1" targetRef="userTask_2" />
  <sequenceFlow id="sequenceFlow_4" sourceRef="userTask_2" targetRef="exclusiveGateway_2" />
  <sequenceFlow id="sequenceFlow_5" sourceRef="exclusiveGateway_2" targetRef="userTask_3" />
  <sequenceFlow id="sequenceFlow_6" sourceRef="userTask_3" targetRef="endEvent_1" />
</process>

启动请假流程示例代码

RuntimeService runtimeService = processEngine.getRuntimeService();
ProcessInstance instance = runtimeService.startProcessInstanceByKey("leave");

实战演练：报销流程

报销流程通常涉及员工提交报销申请、部门领导审批、财务部门审核等步骤。以下是如何实现一个简单的报销流程。

报销流程定义示例

<process id="reimbursement" isExecutable="true">
  <startEvent id="startEvent_1" />
  <userTask id="userTask_1" name="Employee Request" />
  <exclusiveGateway id="exclusiveGateway_1" />
  <userTask id="userTask_2" name="Department Approval" />
  <exclusiveGateway id="exclusiveGateway_2" />
  <userTask id="userTask_3" name="Finance Approval" />
  <endEvent id="endEvent_1" />
  <sequenceFlow id="sequenceFlow_1" sourceRef="startEvent_1" targetRef="userTask_1" />
  <sequenceFlow id="sequenceFlow_2" sourceRef="userTask_1" targetRef="exclusiveGateway_1" />
  <sequenceFlow id="sequenceFlow_3" sourceRef="exclusiveGateway_1" targetRef="userTask_2" />
  <sequenceFlow id="sequenceFlow_4" sourceRef="userTask_2" targetRef="exclusiveGateway_2" />
  <sequenceFlow id="sequenceFlow_5" sourceRef="exclusiveGateway_2" targetRef="userTask_3" />
  <sequenceFlow id="sequenceFlow_6" sourceRef="userTask_3" targetRef="endEvent_1" />
</process>

启动报销流程示例代码

RuntimeService runtimeService = processEngine.getRuntimeService();
ProcessInstance instance = runtimeService.startProcessInstanceByKey("reimbursement");

实战演练：审批流程

审批流程通常涉及提交申请、多个级别审批等步骤。以下是如何实现一个简单的审批流程。

审批流程定义示例

<process id="approval" isExecutable="true">
  <startEvent id="startEvent_1" />
  <userTask id="userTask_1" name="Employee Request" />
  <exclusiveGateway id="exclusiveGateway_1" />
  <userTask id="userTask_2" name="Manager Approval" />
  <exclusiveGateway id="exclusiveGateway_2" />
  <userTask id="userTask_3" name="Director Approval" />
  <exclusiveGateway id="exclusiveGateway_3" />
  <userTask id="userTask_4" name="HR Approval" />
  <endEvent id="endEvent_1" />
  <sequenceFlow id="sequenceFlow_1" sourceRef="startEvent_1" targetRef="userTask_1" />
  <sequenceFlow id="sequenceFlow_2" sourceRef="userTask_1" targetRef="exclusiveGateway_1" />
  <sequenceFlow id="sequenceFlow_3" sourceRef="exclusiveGateway_1" targetRef="userTask_2" />
  <sequenceFlow id="sequenceFlow_4" sourceRef="userTask_2" targetRef="exclusiveGateway_2" />
  <sequenceFlow id="sequenceFlow_5" sourceRef="exclusiveGateway_2" targetRef="userTask_3" />
  <sequenceFlow id="sequenceFlow_6" sourceRef="userTask_3" targetRef="exclusiveGateway_3" />
  <sequenceFlow id="sequenceFlow_7" sourceRef="exclusiveGateway_3" targetRef="userTask_4" />
  <sequenceFlow id="sequenceFlow_8" sourceRef="userTask_4" targetRef="endEvent_1" />
</process>

启动审批流程示例代码

RuntimeService runtimeService = processEngine.getRuntimeService();
ProcessInstance instance = runtimeService.startProcessInstanceByKey("approval");

通过以上内容，你已经了解了Activiti的基本概念和使用方法。Activiti是一个强大的工作流和业务流程管理工具，可以帮助企业优化流程、提高效率。建议通过更多的实践案例和项目开发来深入理解和应用Activiti。如果你希望进一步学习Activiti，可以参考其官方文档或参加在线课程，如慕课网提供的相关课程。