Flowable 流程实例

最新推荐文章于 2025-03-26 10:48:46 发布
最新推荐文章于 2025-03-26 10:48:46 发布
阅读量1w 收藏 29
点赞数 6
分类专栏： flowable 文章标签： java flowable
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_37790902/article/details/108843525
版权
本文介绍Flowable流程引擎的核心组件RuntimeService的功能与使用方法，包括流程实例的启动、查询及状态判断，个人任务的查询与完成，历史流程实例的查询等。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

流程实例系列

RuntimeService 运行服务类

核心功能 启动实例、查询与实例相关的一些信息

是Flowable的流程执行服务类。可以从这个类中获取很多关于流程执行相关的信息。

实现类为RuntimeServiceImpl

提供了一系列根据自身业务场景启动流程实例的API

流程定义、执行实例、流程实例概念

  1. 流程定义类 可以从这里获得资源文件。类似于java类

  2. 流程实例 代表流程定义的执行实例，比如张三请了一天假，他就必须发出一个流程实例的申请

  3. 一个流程实例包括了所有的运行节点。 我们可以用这个对象来了解当前流程实例的进度信息等

  4. 流程实例就表示一个流程从开始到结束的最大流程分支，即一个流程中流程实例只有一个。

  5. 流程实例通常也可以叫做执行实例的根节点

执行实例.

  1. public interface ProcessInstance extends Execution

  2. 从源代码中可以看出 ProcessInstance就是Execution

  3. 启动流程的时候会首先创建流程实例，然后创键执行实例

  4. 流程运转的过程中永远执行的是自己对应的执行实例

  5. 当所有的执行实例按照规则执行完毕之后，这实例随之结束

  6. flowable用这个对象去描述流程执行的每一个节点

  7. 流程按照流程定义的规则执行一次的过程，就可以表示执行对象Execution

  8. 一个流程中，执行对象可以存在多个，但是流程实例只能有一个

  9. 执行实例的父级或者父级的父级为流程实例

  10. 执行实例可能会暂停到某一个活动节点，需要我们去通过特定的API去完成，然后执行实例继续往下走

流程实例启动

使用RuntimeService启动流程实例

操作的是act_ru_execution表，如果是用户任务节点，同时也会在act_ru_task添加一条记录

/**
 * 部署流程
 */
@Test
public void deploy() {
    DeploymentBuilder deploymentBuilder = repositoryService.createDeployment()
            .category("leave")
            .name("请假流程")
            .addClasspathResource("leave.bpmn");
    //流程部署
    Deployment deploy = deploymentBuilder.deploy();
    System.out.println(deploy.getId());
}

/**
 * 启动流程实例  根据key
 */
@Test
public void startProcessInstanceByKey() {
    String processDefinitionKey = "leave";
    ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(processDefinitionKey);
    System.out.println(processInstance.getId()+","+processInstance.getActivityId());
}

查询个人任务 TaskService（act_ru_task）

/**
 * 查询个人任务
 */

@Test
public void createTaskQuery() {
    String assignee = "张三";
    String processDefinitionKey = "leave";
    List<Task> list = taskService.createTaskQuery()
            .taskAssignee(assignee)
            .processDefinitionKey(processDefinitionKey).list();
    list.forEach(v -> System.out.println(v.getId() + " "
            + v.getName() + " " + v.getTaskDefinitionKey()
            + " " + v.getExecutionId() + " " + v.getProcessInstanceId() + " " + v.getCreateTime()));
}

  1. 从processEngine中应该得到TaskService

  2. 使用TaskService获取到任务查询对象TaskQuery

  3. 为查询对象添加过滤条件，使用taskAssignee指定任务的办理者（即查询指定用户的待办任务），同时可以添加分页排序等过滤条件

  4. 调用list方法进行查询

  5. 任务id、名称、办理人、创建时间可以从act_ru_task表中查到

    完成个人任务

    /**
 * 完成个人任务
 */

@Test
public void completeTask() {
    String taskId = "20006";
    taskService.complete(taskId);
}

    对于执行完的任务，Flowable将从act_ru_task表中删除该任务，下一个任务会被插入进来（这两个操作是在一个事物中）

    查询流程状态

    /**
 * 查询流程实例状态 判断流程正在执行还是结束
 */

@Test
public void createProcessInstanceQuery() {
    String processInstanceId = "30001";
    ProcessInstance processInstance = runtimeService.createProcessInstanceQuery()
            .processInstanceId(processInstanceId).singleResult();
    if (processInstance != null) {
        System.out.println("当前流程实例正在运行");
    } else {
        System.out.println("当前流程实例正在运行");
    }
}
  /**
     * 查询执行实例状态 判断流程正在执行还是结束
     */

    @Test
    public void createExecutionQuery() {
        List<Execution> list = runtimeService.createExecutionQuery().list();
        list.forEach(v-> System.out.println(v.getId()+","+v.getActivityId()));
    }

    历史流程实例查询historyService（act_hi_procinst）

    HistoryService 用于查询act_hi 开头的表

/**
 * 查询历史流程实例
 */

@Test
public void createHistoricProcessInstanceQuery() {
    String processInstanceId = "20001";
    HistoricProcessInstance historicProcessInstance = historyService.createHistoricProcessInstanceQuery().processInstanceId(processInstanceId).singleResult();
    System.out.println("流程实例id"+historicProcessInstance.getId());
    System.out.println("流程定义id"+historicProcessInstance.getProcessDefinitionId());
    System.out.println("开始时间"+historicProcessInstance.getStartTime());
    System.out.println("结束时间"+historicProcessInstance.getEndTime());
}

历史活动信息查询 （act_hi_actinst）

历史活动表 act_hi_actinst 活动节点的数据都会存储在这个表中

/**
 * 查询历史活动节点
 * select RES.*
 *  FROM ACT_HI_ACTINST RES order by RES.ID_ asc;
 */

@Test
public void createHistoricActivityInstanceQuery() {
    List<HistoricActivityInstance> list = historyService.createHistoricActivityInstanceQuery().list();
    list.forEach(v -> System.out.println(v.getId()));
}

历史任务查询（act_hi_taskinst）

/**
 * 查询历史任务
 * select distinct RES.*
 *  FROM ACT_HI_TASKINST RES order by RES.ID_ asc;
 */

@Test
public void createHistoricTaskInstanceQuery() {
    List<HistoricTaskInstance> list = historyService.createHistoricTaskInstanceQuery().list();
    list.forEach(v -> System.out.println(v.getId()));
}

act_hi_taskinst表中的end_time有值，说明任务完成了。为空则任务还在运行，没有结束

act_hi_taskinst表之后存储任务节点的数据，其他节点的数据不会存储在这个表中

流程实例涉及到的5张表

act_ru_execution：正在执行的信息

act_hi_procinst：已经执行完的历史流程实例信息

act_hi_actinst：存放历史所有完成的活动

act_ru_task： 正在执行的任务信息

act_hi_taskinst：已经执行完的历史任务信息

流程发起人设置

 

/**
 * 设置流程实例的启动人
 */
@Test
public void setAuthenticatedUserId() {
    String authenticatedUserId = "tyy";
    identityService.setAuthenticatedUserId(authenticatedUserId);
    String processDefinitionKey = "leave";
    ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(processDefinitionKey);
    System.out.println(processInstance.getId() + "," + processInstance.getActivityId());
}
/**
 * 设置流程实例的启动人
 */
@Test
public void setAuthenticatedUserId2() {
    String authenticatedUserId = "tyy2";
    Authentication.setAuthenticatedUserId(authenticatedUserId);
    String processDefinitionKey = "leave";
    ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(processDefinitionKey);
    System.out.println(processInstance.getId() + "," + processInstance.getActivityId());
}

开始节点 initator 跟启东人配合才有意义，否则没有意义

dataObject使用 （act_ru_variable）

flowable允许开发人员在流程文档中为流程或者子流程定义dataObject元素，该元素可以指定变量的id,名称，数据类型等，支持的数据类型有string、boolean、datetime、double、int、long等。流程实例启动时会将dataObject元素的信息自动转换为流程实例变量的存在，变量名称对应dataobject元素中定义的“name”值

/**
 * 获取dataObject
 * select *
 * FROM ACT_RU_VARIABLE
 * WHERE EXECUTION_ID_ = '40001' and NAME_= '天数' and TASK_ID_ is null;
 */
@Test
public void getDataObject() {
    String executionId = "40001";
    String dataObject = "天数";
    DataObject dataObject1 = runtimeService.getDataObject(executionId, dataObject);
    if (dataObject1 != null) {
        System.out.println(dataObject1.getDataObjectDefinitionKey());
        System.out.println(dataObject1.getDescription());
        System.out.println(dataObject1.getExecutionId());
        System.out.println(dataObject1.getName());
        System.out.println(dataObject1.getValue());
        System.out.println(dataObject1.getType());
    }

}

/**
 * select *
 * FROM ACT_RU_VARIABLE
 * WHERE EXECUTION_ID_ = '40001' and TASK_ID_ is null;
 */
@Test
public void getDataObject2() {
    String executionId = "40001";
    Map<String, DataObject> dataObjects = runtimeService.getDataObjects(executionId);
    dataObjects.forEach((s, dataObject) -> {
        System.out.println(dataObject.getDataObjectDefinitionKey());
        System.out.println(dataObject.getDescription());
        System.out.println(dataObject.getExecutionId());
        System.out.println(dataObject.getName());
        System.out.println(dataObject.getValue());
        System.out.println(dataObject.getType());
    });
}

流程实例删除

 

/**
 * 流程实例删除
 */
@Test
public void deleteProcessInstance() {
    String processInstanceId = "30001";
    String deleteReason = "测试删除";
    runtimeService.deleteProcessInstance(processInstanceId, deleteReason);

}



/**
*级联删除
*/

package com.webcreate.runtimeservicetest;

import org.flowable.common.engine.impl.AbstractEngineConfiguration;
import org.flowable.common.engine.impl.interceptor.Command;
import org.flowable.common.engine.impl.interceptor.CommandContext;
import org.flowable.engine.ProcessEngineConfiguration;
import org.flowable.engine.impl.cfg.ProcessEngineConfigurationImpl;

public class DeleteProcessInstanceIdCaCadeCmd implements Command<Void> {
    String processInstanceId = "";
    String deleteReason = "";

    public DeleteProcessInstanceIdCaCadeCmd(String processInstanceId, String deleteReason) {
        this.processInstanceId = processInstanceId;
        this.deleteReason = deleteReason;
    }

    @Override
    public Void execute(CommandContext commandContext) {
        AbstractEngineConfiguration currentEngineConfiguration = commandContext.getCurrentEngineConfiguration();
        if (currentEngineConfiguration != null) {
            ProcessEngineConfigurationImpl processEngineConfiguration = (ProcessEngineConfigurationImpl) currentEngineConfiguration;
            processEngineConfiguration.getExecutionEntityManager().deleteProcessInstance(processInstanceId, deleteReason, true);

        }

        return null;
    }
}



  /**
     * 流程实例删除  级联删除
     */
    @Test
    public void deleteProcessInstance2() {
        String processInstanceId = "32501";
        String deleteReason = "测试删除";
        managementService.executeCommand(new DeleteProcessInstanceIdCaCadeCmd(processInstanceId, deleteReason));
    }

流程实例获取运行的活动节点

/**
 * ### 流程实例获取运行的活动节点
 */
@Test
public void getActiveActivityIds() {
    String executionId = "35004";
    List<String> activeActivityIds = runtimeService.getActiveActivityIds(executionId);
    activeActivityIds.forEach(v -> System.out.println(v));
}

流程实例启动

/**
 * ### 根据流程定义ID启动流程
 */
@Test
public void startProcessInstanceById() {
    String processDefinitionId="dataobject:1:37504";
     runtimeService.startProcessInstanceById(processDefinitionId);
}
/**
 * 启动流程实例  根据key
 */
@Test
public void startProcessInstanceByKey() {
    String processDefinitionKey = "leave";
    ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(processDefinitionKey);
    System.out.println(processInstance.getId()+","+processInstance.getActivityId());
}

流程实例的挂起与激活

/**
 * 判断流程定义是否被挂起
 */
@Test
public void isProcessDefinitionSuspended() {
    String processDefinitionId = "leave:1:45004";
    boolean processDefinitionSuspended = repositoryService.isProcessDefinitionSuspended(processDefinitionId);
    System.out.println(processDefinitionSuspended);
}

/**
 * 流程定义挂起
 * SUSPENSION_STATE_ = 2 表示被挂起
 * SUSPENSION_STATE_ = 1 没有被挂起
 */
@Test
public void suspendProcessDefinitionById() {
    String processDefinitionId = "leave:1:45004";
    repositoryService.suspendProcessDefinitionById(processDefinitionId);
}

/**
 * 流程定义激活
 */
@Test
public void activateProcessDefinitionById() {
    String processDefinitionId = "leave:1:45004";
    repositoryService.activateProcessDefinitionById(processDefinitionId);
}


/**
 * 流程定义挂起 同时挂起流程实例
 */
@Test
public void activateProcessDefinitionById2() {
    String processDefinitionId = "leave:1:45004";
    repositoryService.suspendProcessDefinitionById(processDefinitionId, true, null);
}

通过runtimeService挂起流程实例

flowable查询流程实例信息和已处理任务
猿脑2.0的博客
08-21 2158
在Flowable中查询流程办理记录，通常指的是查询流程实例的历史活动（HistoricActivityInstance）和任务历史（HistoricTaskInstance）。这些记录包含了流程执行过程中的关键信息，如任务的执行人、执行时间、流程状态等。
springboot，Flowable 流程实例的激活与挂起（一）
weixin_40991408的博客
04-21 1415
springboot，Flowable 流程实例的激活与挂起（一）
[工作流引擎]如何判断流程实例是否运行完成
警警的博客
07-21 1557
flowable工作流引擎如何判断流程实例的所有任务是否运行完成在Flowable工作流引擎中，判断流程实例的所有任务是否运行完成，主要可以通过查询流程实例的历史状态或者监听流程执行过程中的相关事件来实现。
工作流引擎Flowable介绍及SpringBoot整合使用实例
最新发布
chengpei147的博客
03-26 885
和。
玩转 Flowable 流程实例
江南一点雨的专栏
09-26 4298
流程定义 ProcessDefinition 这个好说，其实就是我们。
Flowable 流程案例
m0_65037354的博客
04-24 687
addClasspathResource("flowableresourse/firstflow.bpmn20.xml") // 部署一个流程。// 根据流程定义Id启动 返回的是当前启动的流程实例 ProcessInstance。.taskAssignee("lisi") // 根据审批人来查询。// 任务查询这块我们可以通过 TaskService 来实现。// 查询的其实就是 act_ru_task 中的记录。// act_re_procdef 表中的id。// 需要审批的任务 Id。
flowable一个简单的例子
baicu7502的博客
06-28 327
holiday-request.bpmn20.xml： <?xml version="1.0" encoding="UTF-8"?> <definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:xsi="http://www.w3.org/2001/...
Flowable介绍及使用示例
记录并分享一些日常工作和学习笔记
10-17 2685
Flowable是一个开源的用于处理和管理业务流程的框架。它提供了一个用于建模、执行和监控业务流程的平台。Flowable支持BPMN 2.0规范，提供了基于流程引擎的各种功能，包括流程定义、流程实例、任务、事件等。
Activiti(Flowable) 流程实例克隆解决方案1
08-08
Activiti(Flowable) 流程实例克隆解决方案1
Flowable流程实例processInstance开启,中止,激活,删除,查询
Lance
03-26 5706
介绍 Flowable流程实例processInstance基本操作 流程开启 流程中止 流程激活 流程删除 流程查询 1. maven项目依赖 <dependency> <groupId>org.flowable</groupId> <artifactId>flowable-spring-boot-starter-process</artifactId> <version>6.7.2</version&gt
springboot，Flowable 流程实例的激活与挂起（二）
weixin_40991408的博客
04-23 678
springboot，Flowable 流程实例的激活与挂起（二）
flowable demo
05-22
开发工具：idea,环境：jdk、maven、rocketmq,技术：spring boot + flowable 实现简单的工作流程，希望能有所帮助。
Flowable深入浅出-14 Flowable-BPMN操作流程之任务完成
01-19
Flowable深入浅出-14 Flowable-BPMN操作流程之任务完成,欢迎进入我的专栏第14节查看，专栏地址:https://blog.csdn.net/houyj1986/column/info/31755
Flowable多实例流程
没有睡醒的狮子的博客
03-15 6793
应用场景 1、多人同时审核 2、多人审核时按照百分比通过节点 流程图 流程设计器参数说明 多实例类型：Parallel->并行多实例 指分配给多个用户之后，只要其中一个用户完成即可下一步 Sequential->串行多实例，值分配给多个用户之后，必须一个一个去完成才能进入下一步节点 配置信息： collection（集合）： 传入List参数,一般为用户ID集合 elem...
Flowable-多实例
liuwenjun05101的博客
08-08 4736
BPMN 中的多实例活动是实现循环的方式之一。虽然循环总是可以通过活动连接网关将后续顺序流指向自己或前面的活动来实现，但是多实例活动是可以在某些情况下实现起来更简单。如果想让某些特定的活动重复执行多次，我们可以将该活动设置为多实例，让其按照配置来执行相应的次数。
Flowable综合案例一
weixin_44150993的博客
06-10 2832
Flowable综合案例一 1.创建一个Maven工程，导入相关依赖： <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.0.5.RELEASE</version> <
Flowable工作流入门&完整SpringBoot案例
热门推荐
FBB360JAVA的博客
06-10 1万+
Flowable工作流是一款基于Java的轻量级开源工作流引擎，它支持BPMN2.0规范、CMMN规范，同时也提供REST API以及JavaAPI，支持Spring，Spring Boot等框架。借助Flowable工作流，企业可以快速构建出符合自己实际业务的工作流。
SpringBoot集成Flowable案例
weixin_39311781的博客
04-30 979
Flowable 是一个使用 Java 编写的轻量级业务流程引擎。Flowable 流程引擎可用于部署 BPMN2.0 流程定义（用于定义流程的行业 XML 标准），创建这些流程定义的流程实例，进行查询，访问运行中或历史的流程实例与相关数据，等等。
Flowable入门系列文章4 - 流程实例
分享牛
09-24 1377
flowable入门、flowable现状、flowable开源产品、flwoable入门系列、flowable课程、flowable与activiti区别 Flowable是用Java编写的轻量级业务流程引擎。Flowable流程引擎允许您部署BPMN 2.0流程定义（用于定义流程的行业XML标准），创建 流程定义的流程实例，运行查询，访问活动或历史流程实例以及相关数据等等。本节将逐步介绍各种概念和API，通过您可以在自己的开发 机器上进行的实例进行实现。
Flowable流程实例复活
05-26
在 Flowable 中，流程实例的“复活”通常指的是对已经挂起（suspended）的流程实例进行激活（activate）操作，使其能够继续执行流程。 在 Flowable 中，可以使用 `RuntimeService` 的 `activateProcessInstanceById` 方法来激活已经挂起的流程实例。该方法的参数是流程实例的 ID，流程实例 ID 可以通过查询历史记录或者正在运行的流程实例列表获取。 以下是一个示例代码： ```java @Resource private RuntimeService runtimeService; public void activateProcessInstanceById(String processInstanceId) { runtimeService.activateProcessInstanceById(processInstanceId); } ``` 该方法会将指定 ID 的流程实例从挂起状态激活，并使其能够继续执行流程。如果该流程实例已经处于激活状态，则该方法不会产生任何影响。 需要注意的是，如果该流程实例中有任何未完成的任务或者等待的事件，则在激活流程实例之前，这些任务或事件必须先得到解决。否则，激活流程实例可能会导致流程的异常行为。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值