ARTICLE DETAIL

资讯详情

深耕网站建设、视觉设计与SEO优化的一线实战洞察。

Flowable工作流引擎与达梦数据库适配实践

Flowable工作流引擎与达梦数据库适配实践

1. 项目概述

Flowable作为一款轻量级业务流程引擎,在企业级应用中扮演着重要角色。而达梦数据库作为国产数据库的代表,在政务、金融等领域有着广泛应用。本文将详细记录如何实现Flowable工作流引擎与达梦数据库的适配过程。

提示:适配过程中需要特别注意达梦数据库与标准SQL语法之间的差异,这是整个项目的关键挑战。

2. 环境准备

2.1 软件版本选择

  • Flowable版本:6.7.0(当前稳定版)
  • 达梦数据库:DM8(最新企业版)
  • JDK:1.8及以上
  • 应用服务器:Tomcat 9.x

版本匹配至关重要,不同版本的Flowable对数据库的支持程度不同。经过测试,6.7.0版本对国产数据库的兼容性最佳。

2.2 达梦数据库安装配置

达梦数据库的安装需要注意以下几个关键点:

  1. 系统参数调整:

    • 共享内存大小设置
    • 最大连接数配置
    • 字符集选择(建议UTF-8)
  2. 初始化参数:

-- 创建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;
  1. 网络配置:
    • 监听端口设置(默认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语法编写的,需要针对达梦数据库进行以下修改:

  1. 数据类型映射:

    • TIMESTAMP → DATETIME
    • TEXT → CLOB
    • BLOB → BINARY
  2. 语法调整:

    • 移除ENGINE=InnoDB等MySQL特有语法
    • 修改索引创建语句
    • 调整外键约束语法
  3. 分页查询改造: 达梦数据库的分页语法与MySQL不同,需要重写相关查询语句。

3.3 配置数据库类型

在Flowable引擎配置中明确指定数据库类型:

ProcessEngineConfiguration configuration = new StandaloneProcessEngineConfiguration() .setDatabaseType("dm") .setDataSource(dataSource) .setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE);

4. 常见问题与解决方案

4.1 初始化报错处理

问题现象:执行初始化脚本时报"无效的列"错误。

原因分析:达梦数据库对保留字的处理与MySQL不同。

解决方案:

  1. 检查脚本中的关键字是否被用作列名
  2. 必要时使用引号包裹列名
  3. 修改脚本中的SQL语法

4.2 流程部署异常

问题现象:部署流程定义时报"Error creating bean with name 'jdbcMappingContext'"。

排查步骤:

  1. 检查数据库连接是否正常
  2. 验证表结构是否完整
  3. 查看日志中的详细错误信息

解决方法:

# 在application.properties中添加 spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.DmDialect

4.3 性能优化建议

  1. 连接池配置:

    • 初始连接数:5
    • 最大连接数:50
    • 最大等待时间:30000ms
  2. 数据库参数调整:

    • 增大缓冲池大小
    • 优化排序区设置
    • 调整日志文件大小
  3. 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 集群部署方案

对于高可用场景,达梦数据库支持主备部署模式:

  1. 主备配置要点:

    • 数据同步策略设置
    • 故障自动切换配置
    • 连接池的故障转移设置
  2. Flowable多实例配置:

flowable.async.executor.threads.core=5 flowable.async.executor.threads.max=10 flowable.async.executor.queue.size=100

6. 数据迁移方案

6.1 从单机迁移到主备

迁移步骤:

  1. 在主库执行全量备份
  2. 在备库恢复数据
  3. 配置主备同步
  4. 验证数据一致性

关键命令:

# 数据导出 ./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.log

6.2 从其他数据库迁移到达梦

以MySQL为例的迁移步骤:

  1. 使用达梦迁移工具进行结构迁移
  2. 处理不兼容的数据类型
  3. 验证外键约束
  4. 测试业务流程

迁移过程中的常见问题处理:

  • 字符集转换问题
  • 自增主键处理
  • 触发器转换

7. 监控与维护

7.1 数据库监控

关键监控指标:

  1. 连接数使用情况
  2. 缓存命中率
  3. SQL执行效率
  4. 锁等待情况

监控SQL示例:

SELECT * FROM V$SYSTEM_STAT WHERE NAME IN ('parse count (total)', 'execute count');

7.2 Flowable引擎监控

  1. 内置监控接口配置:
configuration.setEnableDatabaseEventLogging(true) .setHistoryLevel(HistoryLevel.FULL);
  1. 自定义监控指标:
  • 流程实例数量
  • 任务积压情况
  • 平均处理时间
  1. 预警机制设置:
<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 性能测试方案

  1. 测试工具:JMeter
  2. 测试场景:
    • 单流程实例创建
    • 并发流程启动
    • 长时间运行测试
  3. 关键指标:
    • 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>

达梦数据库特有的优化点:

  1. 大字段存储优化
  2. 全文检索配置
  3. 审批历史查询优化

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 调试工具推荐

  1. 数据库工具:DM Manager
  2. SQL分析工具:达梦性能视图
  3. 流程可视化:Flowable Modeler
  4. 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 常见陷阱规避

  1. 事务管理:

    • 避免长事务
    • 合理设置事务隔离级别
    • 注意事务传播行为
  2. 连接泄露预防:

try { ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(...); // 业务处理 } finally { // 确保资源释放 }
  1. 达梦特有注意事项:
    • 批量操作时注意参数个数限制
    • 使用绑定变量提高性能
    • 避免使用达梦不支持的函数
返回列表