赵走x博客 - 开发者的网上家园

3、构建命令行程序

资源编号:551104 热度：74

3、Flowable BPMN 用户手册 (v 6.3.0)：构建命令行程序

>原文：https://tkjohn.github.io/flowable-userguide/#_creating_a_process_engine

# 2.3.1. 创建流程引擎
在这个初步教程中，将构建一个简单的例子，以展示如何创建一个Flowable流程引擎，介绍一些核心概念，并展示如何使用API。 截图时使用的是Eclipse，但实际上可以使用任何IDE。我们使用Maven获取Flowable依赖及管理构建，但是类似的任何其它方法也都可以使用（Gradle，Ivy，等等）。

我们将构建的例子是一个简单的请假(holiday request)流程：

- 雇员(employee)申请几天的假期

- 经理(manager)批准或驳回申请

我们会模拟将申请注册到某个外部系统，并给雇员发送结果邮件

首先，通过File → New → Other → Maven Project创建一个新的Maven项目

![](http://oldmark.oss-cn-beijing.aliyuncs.com/2023/10/07/102a2108-64d4-11ee-952d-0242ac1b0002/5522e339757e4e018fc0fac11d070652.png)

在下一界面中，选中'create a simple project (skip archetype selection)'

![](http://oldmark.oss-cn-beijing.aliyuncs.com/2023/10/07/190df2e0-64d4-11ee-a04e-0242ac1b0002/d4acd3fd1bf74699aaab44871ac4db49.png)

填入'Group Id'与'Artifact id':

![](http://oldmark.oss-cn-beijing.aliyuncs.com/2023/10/07/217f3862-64d4-11ee-98aa-0242ac1b0002/e73bbd4ff84143ed81c8931162e9ad30.png)

这样就建立了空的Maven项目，然后添加两个依赖：

- Flowable流程引擎。使我们可以创建一个ProcessEngine流程引擎对象，并访问Flowable API。

- 一个内存数据库。本例中为H2，因为Flowable引擎在运行流程实例时，需要使用数据库来存储执行与历史数据。 请注意H2依赖包含了数据库及驱动。如果使用其他数据库（例如PostgreSQL，MySQL等），需要添加对应的数据库驱动依赖。

在pom.xml文件中添加下列行：
```
<dependencies>
  <dependency>
    <groupId>org.flowable</groupId>
    <artifactId>flowable-engine</artifactId>
    <version>6.3.0</version>
  </dependency>
  <dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <version>1.3.176</version>
  </dependency>
</dependencies>
```
如果由于某些原因，依赖JAR无法自动获取，可以右键点击项目，并选择'Maven → Update Project'以强制手动刷新（一般不会需要这么操作）。 在这个项目中的'Maven Dependencies'下，可以看到flowable-engine与许多其他（传递的）依赖。

创建一个新的Java类，并添加标准的Java main方法：

```
package org.flowable;

public class HolidayRequest {

public static void main(String[] args) {

}

}
```
首先要做的是初始化ProcessEngine流程引擎实例。这是一个线程安全的对象，因此通常只需要在一个应用中初始化一次。 ProcessEngine由ProcessEngineConfiguration实例创建。该实例可以配置与调整流程引擎的设置。 通常使用一个配置XML文件创建ProcessEngineConfiguration，但是（像在这里做的一样）也可以编程方式创建它。 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) {
    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();
  }

}
```
在上面的代码中，第10行创建了一个独立(standalone)配置对象。这里的'独立'指的是引擎是完全独立创建及使用的（而不是在Spring环境中使用，这时需要使用SpringProcessEngineConfiguration类代替）。第11至14行中，传递了一个内存H2数据库实例的JDBC连接参数。 重要：请注意这样的数据库在JVM重启后会消失。如果需要永久保存数据，需要切换为持久化数据库，并相应切换连接参数。 第15行中，设置了true，确保在JDBC参数连接的数据库中，数据库表结构不存在时，会创建相应的表结构。 另外，Flowable也提供了一组SQL文件，可用于手动创建所有表的数据库表结构。

然后使用这个配置创建ProcessEngine对象（第17行）。

这样就可以运行了。在Eclipse中最简单的方法是右键点击类文件，选择Run As → Java Application ：

![](http://oldmark.oss-cn-beijing.aliyuncs.com/2023/10/07/75491620-64d4-11ee-ae71-0242ac1b0002/3523436f4a8b4f8a819eafe289745a2a.png)

应用运行没有问题，但也没有在控制台提供有用的信息，只有一条消息提示日志没有正确配置：

![](http://oldmark.oss-cn-beijing.aliyuncs.com/2023/10/07/7ffc618a-64d4-11ee-879a-0242ac1b0002/f6aadfb6a2ab48329803f82f17de276d.png)

Flowable使用SLF4J作为内部日志框架。在这个例子中，我们使用log4j作为SLF4J的实现。因此在pom.xml文件中添加下列依赖：

```
<dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-api</artifactId>
  <version>1.7.21</version>
</dependency>
<dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-log4j12</artifactId>
  <version>1.7.21</version>
</dependency>
```
Log4j需要一个配置文件。在src/main/resources文件夹下添加log4j.properties文件，并写入下列内容：
```
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{hh:mm:ss,SSS} [%t] %-5p %c %x - %m%n
```
重新运行应用。应该可以看到关于引擎启动与创建数据库表结构的提示日志：

![](http://oldmark.oss-cn-beijing.aliyuncs.com/2023/10/07/9e7abb3e-64d4-11ee-aafb-0242ac1b0002/5c80ddf10a8e4818a0fca0afef9acac0.png)

这样就得到了一个启动可用的流程引擎。接下来为它提供一个流程！