Flowable官方 on 随记

Flowable-05-spring-boot

Fri, 29 Apr 2022 15:31:15 +0000

入门#

需要两个依赖

<properties>

 <flowable.version>6.7.2</flowable.version>
 </properties>
 <dependencies>
 <dependency>
 <groupId>org.flowable</groupId>
 <artifactId>flowable-spring-boot-starter</artifactId>
 <version>${flowable.version}</version>
 </dependency>

 <!-- https://mvnrepository.com/artifact/com.h2database/h2 -->
 <dependency>
 <groupId>com.h2database</groupId>
 <artifactId>h2</artifactId>
 <version>2.1.212</version>
 </dependency>

 </dependencies>

结合Spring：

只需将依赖项添加到类路径并使用*@SpringBootApplication*注释，幕后就会发生很多事情：

自动创建内存数据源（因为 H2 驱动程序位于类路径中）并传递给 Flowable 流程引擎配置
已创建并公开了 Flowable ProcessEngine、CmmnEngine、DmnEngine、FormEngine、ContentEngine 和 IdmEngine bean
所有 Flowable 服务都暴露为 Spring bean
Spring Job Executor 已创建

将自动部署流程文件夹中的任何 BPMN 2.0 流程定义。创建一个文件夹processes并将一个虚拟进程定义（名为one-task-process.bpmn20.xml）添加到此文件夹。该文件的内容如下所示。

<?xml version="1.0" encoding="UTF-8"?>
<definitions
 xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL"
 xmlns:flowable="http://flowable.org/bpmn"
 targetNamespace="Examples">

 <process id="oneTaskProcess" name="The One Task Process">
 <startEvent id="theStart" />
 <sequenceFlow id="flow1" sourceRef="theStart" targetRef="theTask" />
 <userTask id="theTask" name="my task" flowable:assignee="kermit" />
 <sequenceFlow id="flow2" sourceRef="theTask" targetRef="theEnd" />
 <endEvent id="theEnd" />
 </process>

</definitions>

案例文件夹中的任何 CMMN 1.1 案例定义都将自动部署。

Flowable-04-spring

Fri, 29 Apr 2022 14:57:32 +0000

ProcessEngineFactoryBean#

将ProcessEngine配置为常规的SpringBean

<bean id="processEngineConfiguration" class="org.flowable.spring.SpringProcessEngineConfiguration">
 ...
</bean>

<bean id="processEngine" class="org.flowable.spring.ProcessEngineFactoryBean">
 <property name="processEngineConfiguration" ref="processEngineConfiguration" />
</bean>

使用transaction

<beans xmlns="http://www.springframework.org/schema/beans"
 xmlns:context="http://www.springframework.org/schema/context"
 xmlns:tx="http://www.springframework.org/schema/tx"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://www.springframework.org/schema/beans
 http://www.springframework.org/schema/beans/spring-beans.xsd
 http://www.springframework.org/schema/context
 http://www.springframework.org/schema/context/spring-context-2.5.xsd
 http://www.springframework.org/schema/tx
 http://www.springframework.org/schema/tx/spring-tx-3.0.xsd">

 <bean id="dataSource" class="org.springframework.jdbc.datasource.SimpleDriverDataSource">
 <property name="driverClass" value="org.h2.Driver" />
 <property name="url" value="jdbc:h2:mem:flowable;DB_CLOSE_DELAY=1000" />
 <property name="username" value="sa" />
 <property name="password" value="" />
 </bean>

 <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
 <property name="dataSource" ref="dataSource" />
 </bean>

 <bean id="processEngineConfiguration" class="org.flowable.spring.SpringProcessEngineConfiguration">
 <property name="dataSource" ref="dataSource" />
 <property name="transactionManager" ref="transactionManager" />
 <property name="databaseSchemaUpdate" value="true" />
 <property name="asyncExecutorActivate" value="false" />
 </bean>

 <bean id="processEngine" class="org.flowable.spring.ProcessEngineFactoryBean">
 <property name="processEngineConfiguration" ref="processEngineConfiguration" />
 </bean>

 <bean id="repositoryService" factory-bean="processEngine" factory-method="getRepositoryService" />
 <bean id="runtimeService" factory-bean="processEngine" factory-method="getRuntimeService" />
 <bean id="taskService" factory-bean="processEngine" factory-method="getTaskService" />
 <bean id="historyService" factory-bean="processEngine" factory-method="getHistoryService" />
 <bean id="managementService" factory-bean="processEngine" factory-method="getManagementService" />

...

还包括了其他的一些bean

<beans>
 ...
 <tx:annotation-driven transaction-manager="transactionManager"/>

 <bean id="userBean" class="org.flowable.spring.test.UserBean">
 <property name="runtimeService" ref="runtimeService" />
 </bean>

 <bean id="printer" class="org.flowable.spring.test.Printer" />

</beans>

使用

Flowable-03-api

Fri, 29 Apr 2022 09:57:47 +0000

流程引擎API和服务#

引擎API是与Flowable交互的常见方式，主要起点是ProcessEngine，可以通过配置（Configuration章节）中描述的多种方式创建。

从ProcessEngine获取包含工作流/BPM方法的各种服务。ProcessEngine和服务对象是线程安全的

下面是通过processEngine获取各种服务的方法

ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();

RuntimeService runtimeService = processEngine.getRuntimeService();
RepositoryService repositoryService = processEngine.getRepositoryService();
TaskService taskService = processEngine.getTaskService();
ManagementService managementService = processEngine.getManagementService();
IdentityService identityService = processEngine.getIdentityService();
HistoryService historyService = processEngine.getHistoryService();
FormService formService = processEngine.getFormService();
DynamicBpmnService dynamicBpmnService = processEngine.getDynamicBpmnService();

ProcessEngines.getDefaultProcessEngine()在第一次调用时初始化并构建流程引擎，然后返回相同的流程引擎

ProcessEngines类将扫描所有flowable.cfg.xml和flowable-context.xml文件。

对于所有 flowable.cfg.xml 文件，流程引擎将以典型的 Flowable 方式构建：ProcessEngineConfiguration.createProcessEngineConfigurationFromInputStream(inputStream).buildProcessEngine()。

对于所有 flowable-context.xml 文件，流程引擎将以 Spring 方式构建：首先创建 Spring 应用程序上下文，然后从该应用程序上下文中获取流程引擎。

The RepositoryService is probably the first service needed when working with the Flowable engine.

该服务**(RepositoryService)提供用于管理和操作部署deployments**和流程定义的操作

查询引擎已知的部署和流程定义
暂停和激活作为一个整体或特定流程定义的部署。挂起意味着不能对它们执行进一步的操作，而激活则相反并再次启用操作
检索各种资源，例如引擎自动生成的部署或流程图中包含的文件
检索流程定义的 POJO 版本，该版本可用于使用 Java 而不是 XML 来内省流程

RepositoryService主要是关于静态信息（不会改变的数据，或者至少不会改变太多），而RuntimeService处理启动流程定义的新流程实例

Flowable-02-Configuration

Fri, 29 Apr 2022 09:37:24 +0000

创建流程引擎#

Flowable 流程引擎通过一个名为 flowable.cfg.xml 的 XML 文件进行配置

现在类路径下放置floable.cfg.xml文件

<beans xmlns="http://www.springframework.org/schema/beans"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">

 <bean id="processEngineConfiguration" class="org.flowable.engine.impl.cfg.StandaloneProcessEngineConfiguration">

 <property name="jdbcUrl" value="jdbc:h2:mem:flowable;DB_CLOSE_DELAY=1000" />
 <property name="jdbcDriver" value="org.h2.Driver" />
 <property name="jdbcUsername" value="sa" />
 <property name="jdbcPassword" value="" />

 <property name="databaseSchemaUpdate" value="true" />

 <property name="asyncExecutorActivate" value="false" />

 <property name="mailServerHost" value="mail.my-corp.com" />
 <property name="mailServerPort" value="5025" />
 </bean>

</beans>

然后使用静态方法进行获取ProcessEngine

ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();

还有其他配置，这里不一一列举，详见文档地址 https://www.flowable.com/open-source/docs/bpmn/ch03-Configuration
大致目录如下

Flowable-01-GettingStarted

Wed, 27 Apr 2022 22:32:24 +0000

入门#

什么是流动性#

Flowable 是一个用 Java 编写的轻量级业务流程引擎。Flowable 流程引擎允许您部署 BPMN 2.0 流程定义（用于定义流程的行业 XML 标准）、创建这些流程定义的流程实例、运行查询、访问活动或历史流程实例和相关数据等等。

可以使用 Flowable REST API 通过 HTTP 进行通信。还有几个 Flowable 应用程序（Flowable Modeler、Flowable Admin、Flowable IDM 和 Flowable Task）提供开箱即用的示例 UI，用于处理流程和任务。

Flowable和Activiti#

Flowable是Activiti的一个分支

构建命令行命令#

创建流程引擎#

请假流程如下

员工要求休假数次
经理批准或拒绝请求
之后将模拟再某个外部系统中注册请求，并向员工发送一封包含结果的邮件

创建一个空的Mave项目，并添加依赖

 <dependencies>
 <dependency>
 <groupId>org.flowable</groupId>
 <artifactId>flowable-engine</artifactId>
 <version>6.6.0</version>
 </dependency>
 <dependency>
 <groupId>com.h2database</groupId>
 <artifactId>h2</artifactId>
 <version>1.3.176</version>
 </dependency> 

 <dependency>
 <groupId>mysql</groupId>
 <artifactId>mysql-connector-java</artifactId>
 <version>8.0.29</version> <!--当版本号>=8.0.22时会报date转字符串的错误-->
 </dependency>
 </dependencies>

添加一个带有Main方法的类

这里实例化一个ProcessEngine实例，一般只需要实例化一次，是通过ProcessEngineConfiguration创建的，用来配置和调整流程引擎的配置

ProcessEngineConfiguration也可以使用配置 XML 文件创建
ProcessEngineConfiguration需要的最低配置是与数据库的 JDBC 连接

package org.flowable;

import org.flowable.engine.ProcessEngine;
import org.flowable.engine.ProcessEngineConfiguration;
import org.flowable.engine.impl.cfg.StandaloneProcessEngineConfiguration;

public class HolidayRequest {
 public static void main(String[] args) {

 //这里改用mysql，注意后面的nullCatalogMeansCurrent=true
 //注意，pom需要添加mysql驱动依赖
 ProcessEngineConfiguration cfg = new StandaloneProcessEngineConfiguration()
 .setJdbcUrl("jdbc:mysql://localhost:3306/flowable_official?useUnicode=true" +
 "&characterEncoding=utf-8&serverTimezone=Asia/Shanghai&allowMultiQueries=true"
 +"&nullCatalogMeansCurrent=true"
 )
 .setJdbcUsername("root")
 .setJdbcPassword("123456")
 .setJdbcDriver("com.mysql.cj.jdbc.Driver")
 .setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE);
 /* //这是官网，用的h2
 ProcessEngineConfiguration cfg = new StandaloneProcessEngineConfiguration()
 .setJdbcUrl("jdbc:h2:mem:flowable;DB_CLOSE_DELAY=-1")
 .setJdbcUsername("sa")
 .setJdbcPassword("")
 .setJdbcDriver("org.h2.Driver")
 .setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE);*/

 ProcessEngine processEngine = cfg.buildProcessEngine();
 }
}

运行后会出现slf4j的警告，添加依赖并编写配置文件即可