Flowable基础入门学习(一)

已于 2022-05-15 12:09:48 修改
阅读量1.8k 收藏 18
点赞数 3
分类专栏： 工作流 文章标签： 学习 java flowable 流程引擎
于 2022-05-14 20:14:15 首次发布
本文为博主Huathy原创文章，遵循 CC 4.0 BY-NC-SA 版权协议。
未经许可不得转载！否则将依法追究相关责任。
本文链接：https://blog.csdn.net/qq_40366738/article/details/124721273
版权

Flowable基础入门学习笔记

一、发展历程与官方手册

  1. 发展介绍:在这里插入图片描述
  2. 官方手册
    https://tkjohn.github.io/flowable-userguide/#_getting_started

二、获取流程引擎对象

  1. 创建Maven工程并导入依赖
<dependencies>
    <dependency>
        <groupId>org.flowable</groupId>
        <artifactId>flowable-engine</artifactId>
        <version>6.3.0</version>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.26</version>
    </dependency>
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.13.2</version>
        <scope>test</scope>
    </dependency>
    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-api</artifactId>
      <version>1.7.32</version>
    </dependency>
    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-log4j12</artifactId>
      <version>1.7.32</version>
    </dependency>
</dependencies>
  1. 编写测试代码
package com.hx;

import static org.junit.Assert.assertTrue;

import org.flowable.engine.ProcessEngine;
import org.flowable.engine.ProcessEngineConfiguration;
import org.flowable.engine.impl.cfg.StandaloneInMemProcessEngineConfiguration;
import org.junit.Test;

public class AppTest {
    /**
     * 获取流程引擎对象
     */
    @Test
    public void testProcessEngine(){
        // 通过 ProcessEngineConfiguration 构建我们需要的 ProcessEngine
        ProcessEngineConfiguration configuration = new StandaloneInMemProcessEngineConfiguration();
        // 配置相关数据库连接
        configuration.setJdbcDriver("com.mysql.cj.jdbc.Driver");
        configuration.setJdbcUsername("root");
        configuration.setJdbcPassword("whx@2022");
        configuration.setJdbcUrl("jdbc:mysql://sh-cynosdbmysql-grp-cnmbmcfy.sql.tencentcdb.com:26384/flowable_learn?serverTimeZone=UTC");
        // 如果数据库中的表结构不存在则新建
        configuration.setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE);
        // 核心对象，类似于jdbcConnector
        ProcessEngine processEngine = configuration.buildProcessEngine();
    }
}

三、Flowable日志和表结构介绍

1. 日志

### 设置###
log4j.rootLogger = debug, CA

log4j.appender.CA = org.apache.log4j.ConsoleAppender
log4j.appender.CA.layout = org.apache.log4j.PatternLayout
log4j.appender.CA.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

2. 表结构

ACT_RE_* : ’RE’表示repository（存储）。RepositoryService接口操作的表。带此前缀的表包含的是静态信息，如，流程定义，流程的资源（图片，规则等）。
ACT_RU_* : ’RU’表示runtime。RuntimeService、TaskService等接口操作的表。这是运行时的表存储着流程变量，用户任务，变量，职责（job）等运行时的数据。flowable只存储实例执行期间的运行时数据，当流程实例结束时，将删除这些记录。这就保证了这些运行时的表小且快。
ACT_ID_* : ’ID’表示identity(组织机构)。IdentityService接口操作的表。这些表包含标识的信息，如用户，用户组，等等。
ACT_HI_* : ’HI’表示history。HistoryService接口操作的表。就是这些表包含着历史的相关数据，如结束的流程实例，变量，任务，等等。
ACT_GE_* : 普通数据，各种情况都使用的数据。

在这里插入图片描述

四、部署流程

1. 流程定义文件解析

对应的holiday-request.bpmn20.xml文件请参考官方文档的 2.3.2. 部署流程定义
在这里插入图片描述
在这里插入图片描述

2. 部署实现

package com.hx;

import org.flowable.engine.ProcessEngine;
import org.flowable.engine.ProcessEngineConfiguration;
import org.flowable.engine.RepositoryService;
import org.flowable.engine.impl.cfg.StandaloneInMemProcessEngineConfiguration;
import org.flowable.engine.repository.Deployment;
import org.junit.Before;
import org.junit.Test;

public class AppTest {
    ProcessEngineConfiguration configuration = null;

    @Before
    public void before(){
        // 通过 ProcessEngineConfiguration 构建我们需要的 ProcessEngine
        configuration = new StandaloneInMemProcessEngineConfiguration();
        // 配置相关数据库连接
        configuration.setJdbcDriver("com.mysql.cj.jdbc.Driver");
        configuration.setJdbcUsername("flowable");
        configuration.setJdbcPassword("whx@xxxx");
        configuration.setJdbcUrl("jdbc:mysql://sh-cynosdbmysql-grp-cnmbmcfy.sql.tencentcdb.com:26384/flowable_learn?serverTimeZone=UTC");
        // 如果数据库中的表结构不存在则新建
        configuration.setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE);
    }

    /**
     * 部署流程
     */
    @Test
    public void testDeploy(){
        // 1. 获取 ProcessEngine 对象
        ProcessEngine processEngine = configuration.buildProcessEngine();
        // 2. 获取 RepositoryService
        RepositoryService repositoryService = processEngine.getRepositoryService();
        // 3. 完成流程部署操作
        Deployment deploy = repositoryService.createDeployment()
                // 关联要部署的流程文件
                .addClasspathResource("holiday-request.bpmn20.xml")
                .name("请假流程")
                .deploy();
        System.out.println("deploy.getId() => " + deploy.getId());
        System.out.println("deploy.getName() => " + deploy.getName());
    }
}

运行结果分析

  1. 控制台输出
deploy.getId() => 1
deploy.getName() => 请假流程

  1. 查看表结构中的变动

    • ACT_RE_DEPLOYMENT部署数据表
      在这里插入图片描述
    • ACT_GE_BYTEARRAY资源表
      在这里插入图片描述
    • ACT_RE_PROCDEF流程定义表在这里插入图片描述

3. 查询和删除操作

查询

  1. 代码
/**
 * 查询定义的流程信息
 */
@Test
public void testDeployQuery(){
    ProcessEngine processEngine = configuration.buildProcessEngine();
    RepositoryService repositoryService = processEngine.getRepositoryService();
    ProcessDefinitionQuery processDefinitionQuery = repositoryService.createProcessDefinitionQuery();
    ProcessDefinition processDefinition = processDefinitionQuery.deploymentId("1").singleResult();
    System.out.println("getDeploymentId => " + processDefinition.getDeploymentId());
    System.out.println("getName => " + processDefinition.getName());
    System.out.println("getDescription => " + processDefinition.getDescription());
    System.out.println("getId => " + processDefinition.getId());
}
  1. 测试输出
getDeploymentId => 1
getName => 请假流程
getDescription => null
getId => holidayRequest:1:3

删除

/**
* 删除流程定义
*/
@Test
public void testDeleteDeploy(){
    ProcessEngine processEngine = configuration.buildProcessEngine();
    RepositoryService repositoryService = processEngine.getRepositoryService();
    // 通过ID删除部署流程，如果部署流程启动了，则不允许删除
//        repositoryService.deleteDeployment("1");
    // 级联删除。第二个参数为true时表示级联删除，如果流程启动了，则相关任务一并删除。
    repositoryService.deleteDeployment("1",true);
}

五、启动流程实例

  1. 编码
@Test
public void testRunProcess() {
    // 我们需要通过 RuntimeService 来自动实例
    RuntimeService runtimeService = processEngine.getRuntimeService();
    Map<String, Object> params = new HashMap<>();
    params.put("employee","Huathy");
    params.put("nrOfHolidays", 3);
    params.put("description","员工测试请假");
    // 启动流程实例
    ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("holidayRequest", params);
    // 获取流程定义ID
    System.out.println("processInstance.getProcessDefinitionId() = " + processInstance.getProcessDefinitionId());
    // 获取活跃的ID
    System.out.println("processInstance.getActivityId() = " + processInstance.getActivityId());
    System.out.println("processInstance.getId() = " + processInstance.getId());
}
  1. 测试输出
processInstance.getProcessDefinitionId() = holidayRequest:1:3
processInstance.getActivityId() = null
processInstance.getId() = 2501
  1. 查看数据库表结构变动
    • 变量表在这里插入图片描述
    • 任务表在这里插入图片描述
    • 执行表
      在这里插入图片描述

六、任务的查询、处理、历史任务查询

查询任务

  1. 在 holiday-request.bpmn20.xml 文件中的userTask中添加flowable:assignee="whx"来指定用户。并将原有流程删除后，重新部署流程！
<userTask id="approveTask" name="同意或者拒绝请假" flowable:assignee="whx"/>
  1. 编写测试
/**
 * 测试任务查询
 */
@Test
public void testQueryTask(){
    TaskService taskService = configuration.getTaskService();
    List<Task> list = taskService.createTaskQuery()
            // 指定查询流程编号
            .processDefinitionKey("holidayRequest")
            // 指定任务处理人
            .taskAssignee("whx").list();
    list.forEach( task -> {
        System.out.println("task.getProcessDefinitionId() = " + task.getProcessDefinitionId());
        System.out.println("task.getName() = " + task.getName());
        System.out.println("task.getAssignee() = " + task.getAssignee());
        System.out.println("task.getDescription() = " + task.getDescription());
        System.out.println("task.getId() = " + task.getId());
    });
}
  1. 测试输出
task.getProcessDefinitionId() = holidayRequest:1:5003
task.getName() = 同意或者拒绝请假
task.getAssignee() = whx
task.getDescription() = null
task.getId() = 7508

处理任务

  1. 编写测试类
/**
* 完成当前任务
*/
@Test
public void testCompleteTask() {
   TaskService taskService = configuration.getTaskService();
   Task task = taskService.createTaskQuery().processDefinitionKey("holidayRequest").taskAssignee("whx").singleResult();
   // 创建流程变量
   Map<String, Object> params = new HashMap<>();
   params.put("approved", false);
   taskService.complete(task.getId(), params);
}
  1. 编写 SendRejectionMail 处理类
package org.flowable;

import org.flowable.engine.delegate.DelegateExecution;
import org.flowable.engine.delegate.JavaDelegate;

/**
 * @author Huathy
 * @date 2022-05-14 17:04
 * @description 实现Java委托
 * 这是一个flowable的触发器
 */
public class SendRejectionMail implements JavaDelegate {
    @Override
    public void execute(DelegateExecution delegateExecution) {
        // 触发执行逻辑： 按照在流程中的定义，应该给拒绝的员工发送邮件通知
        System.out.println("=========================");
        System.out.println("抱歉，您的请假申请被拒绝……");
        System.out.println("=========================");
    }
}

查询历史流程

  1. 测试代码
@Test
public void testHistory(){
    HistoryService historyService = processEngine.getHistoryService();
    List<HistoricActivityInstance> list = historyService.createHistoricActivityInstanceQuery()
            // 这个流程ID在[act_hi_actinst历史表]中PROC_DEF_ID_
            .processDefinitionId("holidayRequest:1:5003")
            // 查询已完成的历史记录
            .finished()
            // 按照结束时间排序
            .orderByHistoricActivityInstanceEndTime().asc()
            .list();
    list.forEach( history -> {
        // 打印活动ID、名称、处理人、耗时
        System.out.println(history.getActivityId() + " : "
                + history.getActivityName() + " : "
                + history.getAssignee() + " : "
                + history.getDurationInMillis()+"毫秒");
    });
}
  1. 测试输出结果：
startEvent : null : null : 2
approveTask : 同意或者拒绝请假 : whx : 2358653
decision : null : null : 17
sendRejectionMail : Send out rejection email : null : 3
rejectEnd : null : null : 2
Huathy-雨落江南，浮生若梦
关注
  • 3
    点赞
  • 踩
  • 18
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 11
    评论
专栏目录
flowable学习手册
02-08
自己整理的flowable学习手册
flowable-7.0.0.M
08-10
Flowable是一款先进的业务流程管理（BPM）和工作流引擎，专为现代应用程序设计。Flowable 7.0.0.M版本是该引擎的一个里程碑，它包含了一系列的更新、改进和新特性，以提升性能、稳定性和用户体验。下面将详细讨论...
Flowable 之基础教程
qq15035899256的博客
09-06 4349
本文是对Flowable的学习，认识了工作流的用途，学习了flowable部署流程的操作，以及FlowableUI流程设计器的使用。之后的学习内容将持续更新！！！
【Flowable | 第一篇】Flowable介绍以及数据库表说明
最新发布
踢桃的成长之路
07-13 986
Flowable介绍以及数据库表说明
Flowable学习笔记（一、入门）
三分恶的博客
05-03 3659
一、Flowable简介 1、Flowable是什么 Flowable是一个使用Java编写的轻量级业务流程引擎。Flowable流程引擎可用于部署BPMN 2.0流程定义（用于定义流程的行业XML标准）， 创建这些流程定义的流程实例，进行查询，访问运行中或历史的流程实例与相关数据，等等。这个章节将用一个可以在你自己的开发环境中使用的例子，逐步介绍各种概念与API。 Flowable可以十分灵...
Flowable入门
u010074988的博客
04-04 1522
Flowable是一个使用Java编写的轻量级业务流程引擎。Flowable流程引擎可用于部署BPMN 2.0流程定义（用于定义流程的行业XML标准）， 创建这些流程定义的流程实例，进行查询，访问运行中或历史的流程实例与相关数据，等等。这个章节将用一个可以在你自己的开发环境中使用的例子，逐步介绍各种概念与API。Flowable可以十分灵活地加入你的应用/服务/构架。可以将JAR形式发布的Flowable库加入应用或服务，来嵌入引擎。
Flowable从入门到精通源码
05-20
从基础讲起，结合应用场景，由浅到深细化讲解BPMN和Flowable的相关组件，并结合具体实例，演示功能的使用和注意事项。最终结合Springboot搭建一套工作流系统，囊括一般项目中所需要的知识点，理论结合实际，让真正...
Flowable课件-基础篇.md
07-21
Flowable课件-基础篇.md
flowable-designer-5.2 两个demo 及学习文档
02-06
flowable-designer-5.2 插件 两个练习小demo 及学习文档
Flowable教程
tttalk的博客
12-28 5048
Flowable实战
Flowable 学习
weixin_42734359的博客
02-09 118
#Flowable 学习笔记
【学习笔记】Flowable - 01 - 工作流 快速上手
Xcong_Zhu的博客
01-15 1481
Flowable快速上手
flowable学习
qq_41490843的博客
12-18 1014
Flowable学习总结 Flowable 与 Activit 关系： Flowable是Activiti原班主创人员从Activiti分离出来的一套工作流引擎，是一个业务流程管理(BPM)和工作流系统，适用于开发人员和系统管理员。其核心是超快速、稳定的BPMN2流程引擎，易于与 Spring集成使用。   Flowable流程实现 1). 流程图         流程图为工作流主要构成，...
flowable 工作流从入门到精通
疯狂的毛毛虫-一个java后端爱好者
06-04 1061
flowable6&springboot2 工作流从入门到精通
Flowable工作流实战快速入门（一）
GalenGao
09-08 9297
实际生活中有一些例如办公类流程需要多个环节人员进行审批，以达到对整个工作流程的控制与掌握。为提高效率，借助计算机对业务流程自动化执行管理，而Flowable框架就可以帮助我们进行工作流程进行管理工作。而Flowable可以帮助我们即是业务流程发送了变更，我们的业务流程代码也无需进行更新。Flowable的资源管理类，提供了管理和控制流程发布包和流程定义的操作。除了部署定义流程之外，此服务还支持查询引擎的发布包和流程定义。Flowable的流程运行管理类，可以从这个服务类中获取很多关于流程执行的相关信息。
【flowable】二、flowable入门
return
10-22 3244
flowable入门 在这个初步教程中，将构建一个简单的例子，以展示如何创建一个Flowable流程引擎，介绍一些核心概念，并展示如何使用API。 截图时使用的是Eclipse，但实际上可以使用任何IDE。我们使用Maven获取Flowable依赖及管理构建，但是类似的任何其它方法也都可以使用（Gradle，Ivy，等等）。我们将构建的例子是一个简单的*请假(holiday request)*流程： 通过idea创建或者eclipse创建一个maven工程 需要添加两个依赖： 可以直接使用main方法测试，
flowable 入门
08-21
Flowable是一个开源的工作流引擎，用于设计、执行和管理工作流程。以下是Flowable入门的一些建议步骤： 1. 安装Flowable：你可以通过Maven或Gradle将Flowable引入到你的项目中。在pom.xml（或build.gradle）文件中添加Flowable的依赖项。 2. 创建Flowable引擎：在你的应用程序中，使用Flowable API创建一个Flowable引擎实例。这将是与Flowable进行交互的入口点。 3. 定义流程模型：使用Flowable的BPMN 2.0规范来设计和定义你的流程模型。你可以使用可视化工具（如Flowable Modeler）或直接编写BPMN XML文件。 4. 部署流程模型：将你的流程模型部署到Flowable引擎中，以便可以执行和管理这些流程。可以使用Flowable API来完成部署。 5. 执行流程实例：通过启动流程实例来执行你的流程模型。你可以使用Flowable API来启动流程实例，并跟踪流程的执行状态。 6. 处理任务：在流程实例中，任务是需要人工干预或处理的环节。你可以通过Flowable API查询和完成这些任务。 7. 监控和管理流程：Flowable提供了一套管理和监控工具，用于跟踪流程实例、任务和其他相关数据。你可以使用这些工具来监控流程的执行和性能。 这只是一个简单的Flowable入门指南，帮助你了解基本的概念和步骤。Flowable还提供了更多高级功能，如事件、表单、决策表等，你可以根据自己的需求进行深入学习和实践。建议你参考Flowable的官方文档和示例代码，以获得更详细的指导和帮助。
评论 11
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Huathy-雨落江南，浮生若梦

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值