创建一个ProcessEngine
Flowable流程引擎通过名为的XML文件进行配置flowable.cfg.xml.
获得一个最简单的方法ProcessEngine是使用这个org.flowable.engine.ProcessEngines类:
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
会在类路径中查找文件flowable.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>
请注意, 配置的XML实际上是一个Spring配置. 这并不意味着Flowable只能在Spring环境中使用！ 我们只是利用Spring内部的解析和依赖注入功能来构建引擎.
注意 在
flowable.cfg.xml必须包含有ID processEngineConfiguration 的Bean
数据库配置
有两种方法来配置Flowable引擎将使用的数据库. 第一个选项是定义数据库的JDBC属性:
jdbcUrl：数据库的JDBC URL.
jdbcDriver：执行特定数据库类型的驱动程序.
jdbcUsername：连接到数据库的用户名.
jdbcPassword：连接到数据库的密码.
基于提供的JDBC属性构建的数据源将具有默认的MyBatis连接池设置. 可以选择设置以下属性来调整连接池(取自MyBatis文档):
jdbcMaxActiveConnections：连接池在任何时间最多可以包含的活动连接数.默认值是10.
jdbcMaxIdleConnections：连接池在任何时间最多可以包含的空闲连接数.
jdbcMaxCheckoutTime：在强制返回连接之前, 可以从连接池中检出连接的时间量(以毫秒为单位).默认是20000(20秒).
jdbcMaxWaitTime：这是一个低级别的设置, 让池有机会打印日志状态, 并重新尝试获取连接, 以防异常耗时(为了避免在池被错误配置的情况下永远失败)是20000(20秒).
示例数据库配置:
<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="" />
我们的基准测试表明, 在处理大量的并发请求时, MyBatis连接池并不是最高效或灵活的. 因此, 建议使用javax.sql.DataSource实现, 并将其注入流程引擎配置(例如DBCP, C3P0, Hikari, Tomcat连接池等):
<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" >
<property name="driverClassName" value="com.mysql.jdbc.Driver" />
<property name="url" value="jdbc:mysql://localhost:3306/flowable" />
<property name="username" value="flowable" />
<property name="password" value="flowable" />
<property name="defaultAutoCommit" value="false" />
</bean>
<bean id="processEngineConfiguration" class="org.flowable.engine.impl.cfg.StandaloneProcessEngineConfiguration">
<property name="dataSource" ref="dataSource" />
...
无论您使用JDBC还是数据源, 都可以设置以下属性:
databaseType: 通常不需要指定该属性, 因为它可以从你的数据库连接字符串中自动检测. 如果自动检测失败时需要指定. 能选择的值有{h2, mysql, oracle, postgres, mssql, db2}.
databaseSchemaUpdate: 设置策略来处理流程引擎启动和关闭时的数据库模式.
false(默认值):在创建流程引擎时检查数据库模式的版本,如果版本不匹配,则引发异常.
true: 在构建流程引擎时, 将执行检查, 并在必要时执行架构的更新. 如果架构不存在, 则会创建该架构.
create-drop: 在创建流程引擎时创建模式, 并在流程引擎关闭时删除模式.
支持的数据库
MySQL用户注意
低于5.6.4的MySQL版本不支持时间戳或毫秒级精度的日期. 更糟糕的是, 有些版本在创建这样的列时会抛出异常, 而其他版本则不会.
具体来说, 以下适用于MySQL版本:
<5.6: 没有可用的毫秒精度. DDL文件可用(查找包含mysql55的文件).可以直接使用自动创建/更新.
5.6.0 - 5.6.3: 没有可用的毫秒精度. 自动创建/更新将不起作用. 建议无论如何升级到更新的数据库版本. 如果不行, 可以使用mysql 5.5的 DDL文件.
5.6.4+: 可用的毫秒精度. 可用的DDL文件(包含mysql的默认文件). 可直接使用自动创建/更新.
数据库表名解释
Flowable的数据库名称都以ACT_开头. 第二部分是表用例的两字符识别. 这个用例也将大致匹配服务API.
ACT_RE_ *: RE代表repository. 带有此前缀的表包含静态信息, 如流程定义和流程资源(图像, 规则等).
ACT_RU_ *: RU代表runtime. 这些是包含流程实例, 用户任务, 变量, 作业等的运行时数据存储表. Flowable仅在流程实例执行期间存储运行时数据, 并在流程实例结束时删除记录. 这使运行时间小而快速.
ACT_HI_ *: HI代表history. 这些表格包含历史数据, 例如过去的流程实例, 变量, 任务等等.
ACT_GE_ *: general数据, 用于各种用例.
数据库升级
确保在运行升级之前备份数据库(使用数据库备份功能).
默认情况下, 每次创建流程引擎时都会执行版本检查. 这通常发生在您的应用程序或Flowable Web应用程序启动时. 如果Flowable库注意到库版本和Flowable数据库表版本之间存在差异, 则抛出异常.
要进行升级, 您必须先将以下配置属性放在flowable.cfg.xml配置文件中：
<beans >
<bean id="processEngineConfiguration"
class="org.flowable.engine.impl.cfg.StandaloneProcessEngineConfiguration">
<!-- ... -->
<property name="databaseSchemaUpdate" value="true" />
<!-- ... -->
</bean>
</beans>
