业务流程组件之Activity的说明与使用

最新推荐文章于 2024-05-01 22:29:25 发布

five-five

最新推荐文章于 2024-05-01 22:29:25 发布

阅读量573

点赞数 5

分类专栏： java 微服务文章标签： junit java 开发语言 spring 后端数据库

本文链接：https://blog.csdn.net/qq_45074341/article/details/137814532

版权

java 同时被 2 个专栏收录

46 篇文章 3 订阅

订阅专栏

微服务

19 篇文章 0 订阅

订阅专栏

什么是Activity流程引擎？

Activity流程引擎是一种用于管理和执行业务流程的软件。它可以帮助企业自动化业务流程，提高工作效率和降低人为错误。

如何使用Activity流程引擎？

使用Activity流程引擎通常包括以下几个步骤：

流程设计
流程部署
流程实例启动
任务处理
流程监控

1. 流程设计

流程设计是指使用可视化工具，如Activiti Designer或Camunda Modeler等，绘制业务流程图。在流程图中，可以定义各种任务节点、网关节点和连接线等元素，以及设置各种属性和规则。

例如，以下是一个简单的请假流程图：

                   +----------------+
                   |    提交申请    |
                   +----------------+
                          |
                          |
                          v
                   +----------------+
                   |    审批申请    |
                   +----------------+
                          |
                          |
                          v
+-------------------+    |    +-------------------+
|    同意（是）     |----+----|    处理请假    |
+-------------------+         +-------------------+
|    拒绝（否）     |---------+    重新提交申请   |
+-------------------+         +-------------------+

2. 流程部署

流程部署是指将流程图部署到Activity流程引擎中，使其可以被执行。通常需要将流程图和相关资源打包成一个流程文件，然后上传到流程引擎中。

例如，以下是使用Activiti部署流程的代码：

RepositoryService repositoryService = processEngine.getRepositoryService();
Deployment deployment = repositoryService.createDeployment()
        .addClasspathResource("processes/leave.bpmn20.xml")
        .deploy();

3. 流程实例启动

流程实例启动是指创建一个新的流程实例，并执行流程中的第一个任务节点。可以通过流程引擎提供的API来启动流程实例，并为其设置变量等参数。

例如，以下是使用Activiti启动请假流程的代码：

RuntimeService runtimeService = processEngine.getRuntimeService();
Map<String, Object> variables = new HashMap<>();
variables.put("days", 3); // 请假天数
variables.put("reason", "去旅游"); // 请假原因
runtimeService.startProcessInstanceByKey("leave", variables);

4. 任务处理

任务处理是指执行流程中的任务节点，通常需要由人工或系统来完成。可以通过流程引擎提供的API来查询任务列表，并为其设置处理人、处理时间、处理结果等参数。

例如，以下是使用Activiti处理审批任务的代码：

TaskService taskService = processEngine.getTaskService();
Task task = taskService.createTaskQuery()
        .taskAssignee("张三") // 任务处理人
        .singleResult();
Map<String, Object> variables = new HashMap<>();
variables.put("approved", true); // 审批结果
taskService.complete(task.getId(), variables);

5. 流程监控

流程监控是指查看流程实例的执行情况，包括已完成的任务节点、当前正在执行的任务节点、流程变量等信息。可以通过流程引擎提供的API来查询流程实例的状态，并进行可视化展示。

例如，以下是使用Activiti查询流程实例的代码：

RuntimeService runtimeService = processEngine.getRuntimeService();
ProcessInstance processInstance = runtimeService.createProcessInstanceQuery()
        .processInstanceId("123") // 流程实例ID
        .singleResult();

结论

Activity流程引擎是一种非常实用的工具，可以帮助企业自动化业务流程，提高工作效率和降低人为错误。使用Activity流程引擎通常包括流程设计、流程部署、流程实例启动、任务处理和流程监控等步骤。通过结合实际例子，希望能够帮助大家更好地理解和使用Activity流程引擎。

实际案例

现在我来具体介绍一下如何使用Activity流程引擎来实现一个简单的工作流程，希望能够帮助您更好地理解和使用它。

首先，我们需要在项目中引入Activiti的依赖。在Maven项目中，可以在pom.xml文件中添加以下依赖：

<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>

接下来，我们需要创建一个工作流程定义文件，这个文件是一个XML文件，用于描述工作流程的各个节点和流程路径。Activiti提供了一个可视化工具Activiti Designer，可以用它来创建工作流程定义文件。这里我们手动创建一个简单的工作流程定义文件，如下所示：

<?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"
             xmlns:activiti="http://activiti.org/bpmn"
             xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI"
             xmlns:omgdc="http://www.omg.org/spec/DD/20100524/DC"
             xmlns:omgdi="http://www.omg.org/spec/DD/20100524/DI"
             typeLanguage="http://www.w3.org/2001/XMLSchema"
             expressionLanguage="http://www.w3.org/1999/XPath"
             targetNamespace="http://www.activiti.org/processdef">

    <process id="leaveProcess" name="请假流程" isExecutable="true">
        <startEvent id="startEvent" name="开始"></startEvent>
        <userTask id="applyLeave" name="申请请假" activiti:assignee="张三"></userTask>
        <userTask id="approveLeave" name="审批请假" activiti:assignee="李四"></userTask>
        <sequenceFlow id="flow1" sourceRef="startEvent" targetRef="applyLeave"></sequenceFlow>
        <sequenceFlow id="flow2" sourceRef="applyLeave" targetRef="approveLeave"></sequenceFlow>
        <endEvent id="endEvent" name="结束"></endEvent>
        <sequenceFlow id="flow3" sourceRef="approveLeave" targetRef="endEvent"></sequenceFlow>
    </process>

</definitions>

这个工作流程定义了一个请假流程，包含了开始节点、申请请假节点、审批请假节点和结束节点，以及节点之间的流程路径。

接下来，我们需要在Spring配置文件中配置Activiti的数据源和事务管理器，以及创建ProcessEngine对象。在Spring Boot项目中，可以在application.yml文件中添加以下配置：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/activiti?useUnicode=true&characterEncoding=utf8&useSSL=false
    username: root
    password: 123456
    driver-class-name: com.mysql.jdbc.Driver

activiti:
  database-schema-update: true
  job-executor-activate: true
  history-level: audit

在Spring配置文件中，我们还需要创建ProcessEngine对象，如下所示：

@Bean
public ProcessEngine processEngine() throws Exception {
    ProcessEngineConfiguration config = ProcessEngineConfiguration.createStandaloneProcessEngineConfiguration();
    config.setJdbcUrl("jdbc:mysql://localhost:3306/activiti?useUnicode=true&characterEncoding=utf8&useSSL=false");
    config.setJdbcDriver("com.mysql.jdbc.Driver");
    config.setJdbcUsername("root");
    config.setJdbcPassword("123456");
    config.setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE);
    config.setJobExecutorActivate(true);
    config.setHistoryLevel(HistoryLevel.AUDIT);
    return config.buildProcessEngine();
}

接下来，我们需要部署工作流程定义文件，并启动一个工作流程实例。在Spring Boot项目中，可以在启动类中添加以下代码：

@SpringBootApplication
public class Application {

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);

        // 部署工作流程定义文件
        ProcessEngine processEngine = ContextLoader.getCurrentWebApplicationContext().getBean(ProcessEngine.class);
        RepositoryService repositoryService = processEngine.getRepositoryService();
        Deployment deployment = repositoryService.createDeployment()
                .addClasspathResource("processes/leaveProcess.bpmn20.xml")
                .deploy();
        System.out.println("部署成功，部署ID：" + deployment.getId());

        // 启动工作流程实例
        RuntimeService runtimeService = processEngine.getRuntimeService();
        Map<String, Object> variables = new HashMap<>();
        variables.put("days", 3);
        variables.put("reason", "去旅游");
        ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("leaveProcess", variables);
        System.out.println("启动成功，流程实例ID：" + processInstance.getId());
    }

}

这里我们使用ProcessEngine对象的RepositoryService部署了工作流程定义文件，并使用RuntimeService启动了一个工作流程实例。

最后，我们需要处理工作流程中的任务。在这个例子中，我们需要处理申请请假和审批请假两个任务。在Spring Boot项目中，可以创建两个Service类来处理这两个任务，如下所示：

@Service
public class LeaveApplyService {

    @Autowired
    private TaskService taskService;

    public void applyLeave(String taskId, String assignee) {
        taskService.setAssignee(taskId, assignee);
        taskService.complete(taskId);
    }

}

@Service
public class LeaveApproveService {

    @Autowired
    private TaskService taskService;

    public void approveLeave(String taskId, boolean approved) {
        Map<String, Object> variables = new HashMap<>();
        variables.put("approved", approved);
        taskService.complete(taskId, variables);
    }

}