1. 项目概述
Flowable作为一款轻量级业务流程引擎,在企业级应用中扮演着重要角色。而达梦数据库作为国产数据库的代表,在政务、金融等领域有着广泛应用。本文将详细记录如何实现Flowable工作流引擎与达梦数据库的适配过程。
提示:适配过程中需要特别注意达梦数据库与标准SQL语法之间的差异,这是整个项目的关键挑战。
2. 环境准备
2.1 软件版本选择
- Flowable版本:6.7.0(当前稳定版)
- 达梦数据库:DM8(最新企业版)
- JDK:1.8及以上
- 应用服务器:Tomcat 9.x
版本匹配至关重要,不同版本的Flowable对数据库的支持程度不同。经过测试,6.7.0版本对国产数据库的兼容性最佳。
2.2 达梦数据库安装配置
达梦数据库的安装需要注意以下几个关键点:
系统参数调整:
- 共享内存大小设置
- 最大连接数配置
- 字符集选择(建议UTF-8)
初始化参数:
-- 创建Flowable专用表空间 CREATE TABLESPACE flowable DATAFILE 'flowable.dbf' SIZE 500M AUTOEXTEND ON; -- 创建用户并授权 CREATE USER flowable IDENTIFIED BY "Flowable@123" DEFAULT TABLESPACE flowable; GRANT DBA TO flowable;- 网络配置:
- 监听端口设置(默认5236)
- 远程连接权限配置
3. Flowable适配达梦数据库
3.1 数据库驱动配置
首先需要获取达梦数据库的JDBC驱动(DmJdbcDriver18.jar),并将其放入项目的lib目录。然后在Flowable配置文件中进行如下设置:
<bean id="dataSource" class="org.apache.commons.dbcp2.BasicDataSource"> <property name="driverClassName" value="dm.jdbc.driver.DmDriver"/> <property name="url" value="jdbc:dm://127.0.0.1:5236/flowable"/> <property name="username" value="flowable"/> <property name="password" value="Flowable@123"/> <property name="defaultAutoCommit" value="false"/> <property name="maxTotal" value="20"/> </bean>3.2 SQL脚本适配
Flowable原生提供的SQL脚本是基于标准SQL语法编写的,需要针对达梦数据库进行以下修改:
数据类型映射:
- TIMESTAMP → DATETIME
- TEXT → CLOB
- BLOB → BINARY
语法调整:
- 移除
ENGINE=InnoDB等MySQL特有语法 - 修改索引创建语句
- 调整外键约束语法
- 移除
分页查询改造: 达梦数据库的分页语法与MySQL不同,需要重写相关查询语句。
3.3 配置数据库类型
在Flowable引擎配置中明确指定数据库类型:
ProcessEngineConfiguration configuration = new StandaloneProcessEngineConfiguration() .setDatabaseType("dm") .setDataSource(dataSource) .setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE);4. 常见问题与解决方案
4.1 初始化报错处理
问题现象:执行初始化脚本时报"无效的列"错误。
原因分析:达梦数据库对保留字的处理与MySQL不同。
解决方案:
- 检查脚本中的关键字是否被用作列名
- 必要时使用引号包裹列名
- 修改脚本中的SQL语法
4.2 流程部署异常
问题现象:部署流程定义时报"Error creating bean with name 'jdbcMappingContext'"。
排查步骤:
- 检查数据库连接是否正常
- 验证表结构是否完整
- 查看日志中的详细错误信息
解决方法:
# 在application.properties中添加 spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.DmDialect4.3 性能优化建议
连接池配置:
- 初始连接数:5
- 最大连接数:50
- 最大等待时间:30000ms
数据库参数调整:
- 增大缓冲池大小
- 优化排序区设置
- 调整日志文件大小
Flowable配置优化:
configuration.setAsyncExecutorActivate(true) .setAsyncExecutorDefaultTimerJobAcquireWaitTime(10000) .setAsyncExecutorDefaultAsyncJobAcquireWaitTime(10000);5. 高级配置技巧
5.1 动态审批人设置
在达梦环境下实现动态审批人需要注意SQL语法差异:
<userTask id="reviewTask" name="Review Task" flowable:assignee="${approver}"> <extensionElements> <flowable:taskListener event="create" class="com.example.ApproverAssignmentListener"/> </extensionElements> </userTask>对应的监听器实现:
public class ApproverAssignmentListener implements TaskListener { @Override public void notify(DelegateTask delegateTask) { // 从达梦数据库查询审批人 String sql = "SELECT approver FROM workflow_approvers WHERE process_key = ?"; // 执行查询并设置审批人 } }5.2 网关配置优化
排他网关在达梦环境下的配置示例:
<exclusiveGateway id="decisionGateway" /> <sequenceFlow id="flow1" sourceRef="decisionGateway" targetRef="task1"> <conditionExpression xsi:type="tFormalExpression"> <![CDATA[${status == 'approved'}]]> </conditionExpression> </sequenceFlow>5.3 集群部署方案
对于高可用场景,达梦数据库支持主备部署模式:
主备配置要点:
- 数据同步策略设置
- 故障自动切换配置
- 连接池的故障转移设置
Flowable多实例配置:
flowable.async.executor.threads.core=5 flowable.async.executor.threads.max=10 flowable.async.executor.queue.size=1006. 数据迁移方案
6.1 从单机迁移到主备
迁移步骤:
- 在主库执行全量备份
- 在备库恢复数据
- 配置主备同步
- 验证数据一致性
关键命令:
# 数据导出 ./dexp USERID=flowable/Flowable@123 DIRECTORY=/backup FILE=flowable.dmp LOG=flowable.log # 数据导入 ./dimp USERID=flowable/Flowable@123 DIRECTORY=/backup FILE=flowable.dmp LOG=flowable_imp.log6.2 从其他数据库迁移到达梦
以MySQL为例的迁移步骤:
- 使用达梦迁移工具进行结构迁移
- 处理不兼容的数据类型
- 验证外键约束
- 测试业务流程
迁移过程中的常见问题处理:
- 字符集转换问题
- 自增主键处理
- 触发器转换
7. 监控与维护
7.1 数据库监控
关键监控指标:
- 连接数使用情况
- 缓存命中率
- SQL执行效率
- 锁等待情况
监控SQL示例:
SELECT * FROM V$SYSTEM_STAT WHERE NAME IN ('parse count (total)', 'execute count');7.2 Flowable引擎监控
- 内置监控接口配置:
configuration.setEnableDatabaseEventLogging(true) .setHistoryLevel(HistoryLevel.FULL);- 自定义监控指标:
- 流程实例数量
- 任务积压情况
- 平均处理时间
- 预警机制设置:
<bean id="performanceInterceptor" class="org.flowable.engine.impl.cfg.performance.PerformanceInterceptor"> <property name="warningThreshold" value="1000"/> </bean>8. 测试验证
8.1 单元测试配置
使用JUnit进行流程测试的配置示例:
@RunWith(FlowableTestRunner.class) @TestDeployment public class ApprovalProcessTest { @Autowired private RuntimeService runtimeService; @Test public void testApprovalProcess() { // 测试流程 } }8.2 性能测试方案
- 测试工具:JMeter
- 测试场景:
- 单流程实例创建
- 并发流程启动
- 长时间运行测试
- 关键指标:
- TPS(每秒事务数)
- 平均响应时间
- 错误率
测试数据准备SQL:
-- 预置测试数据 INSERT INTO ACT_RU_TASK (...) VALUES (...); -- 批量插入测试 BEGIN FOR i IN 1..1000 LOOP INSERT INTO ACT_RU_TASK (...) VALUES (...); END LOOP; COMMIT; END;9. 实际应用案例
9.1 公文审批系统实现
典型配置示例:
<process id="document_approval" name="Document Approval Process"> <startEvent id="start"/> <userTask id="department_approval" name="Department Approval"> <extensionElements> <flowable:formProperty id="comment" name="Approval Comment" type="string"/> </extensionElements> </userTask> <!-- 更多节点配置 --> </process>达梦数据库特有的优化点:
- 大字段存储优化
- 全文检索配置
- 审批历史查询优化
9.2 采购流程配置
采购流程中的关键表设计:
CREATE TABLE PURCHASE_ORDER ( ID NUMBER(19) PRIMARY KEY, ORDER_NO VARCHAR2(64) NOT NULL, APPLICANT VARCHAR2(64), AMOUNT NUMBER(19,2), STATUS VARCHAR2(32), -- 其他字段 CREATE_TIME DATETIME ); -- 创建流程关联表 CREATE TABLE FLOW_PURCHASE_REL ( PROCESS_ID VARCHAR2(64), BUSINESS_KEY VARCHAR2(64), -- 其他关联字段 PRIMARY KEY (PROCESS_ID, BUSINESS_KEY) );流程与业务数据关联的实现:
// 启动流程时关联业务数据 runtimeService.startProcessInstanceByKey( "purchaseProcess", businessKey, variables);10. 开发调试技巧
10.1 日志配置优化
推荐日志配置(logback.xml):
<logger name="org.flowable" level="DEBUG"/> <logger name="org.springframework.jdbc" level="WARN"/> <logger name="org.apache.ibatis" level="WARN"/> <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender"> <file>logs/flowable.log</file> <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"> <fileNamePattern>logs/flowable.%d{yyyy-MM-dd}.log</fileNamePattern> </rollingPolicy> <encoder> <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern> </encoder> </appender>10.2 调试工具推荐
- 数据库工具:DM Manager
- SQL分析工具:达梦性能视图
- 流程可视化:Flowable Modeler
- API测试:Postman
调试常用SQL:
-- 查看运行中流程 SELECT * FROM ACT_RU_EXECUTION; -- 查询待办任务 SELECT * FROM ACT_RU_TASK WHERE ASSIGNEE_ = 'user1'; -- 查看流程变量 SELECT * FROM ACT_RU_VARIABLE WHERE EXECUTION_ID_ = 'xxx';10.3 常见陷阱规避
事务管理:
- 避免长事务
- 合理设置事务隔离级别
- 注意事务传播行为
连接泄露预防:
try { ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(...); // 业务处理 } finally { // 确保资源释放 }- 达梦特有注意事项:
- 批量操作时注意参数个数限制
- 使用绑定变量提高性能
- 避免使用达梦不支持的函数