jBPM 4.0 開發指南：第 3 章 配置體系與模組化裝配

第 3 章 配置體系與模組化裝配

3.1 預置配置文件與導入機制

jbpm.jar 內建多個預置配置文件，採用模組化導入設計：

jbpm.default.cfg.xml      # 核心默認配置：日誌、Hibernate、業務日曆等
jbpm.identity.cfg.xml     # 身份管理組件
jbpm.jbossremote.cfg.xml  # JBoss 遠程調用配置
jbpm.jobexecutor.cfg.xml  # 作業執行器配置
jbpm.tx.hibernate.cfg.xml # Hibernate 本地事務配置
jbpm.tx.jta.cfg.xml       # JTA 分佈式事務配置

用戶配置 jbpm.cfg.xml 通過導入組合所需功能：

<?xml version="1.0" encoding="UTF-8"?>
<jbpm-configuration>
    <import resource="jbpm.default.cfg.xml" />
    <import resource="jbpm.tx.hibernate.cfg.xml" />
    <import resource="jbpm.jpdl.cfg.xml" />
    <import resource="jbpm.identity.cfg.xml" />
    <import resource="jbpm.jobexecutor.cfg.xml" />
</jbpm-configuration>

JTA 環境下替換為 jbpm.tx.jta.cfg.xml。自定義配置可在導入後覆蓋特定區段。

3.2 Hibernate 映射文件清單

框架內建完整領域模型映射：

jbpm.execution.hbm.xml   # 執行相關實體
jbpm.history.hbm.xml     # 歷史審計實體
jbpm.identity.hbm.xml    # 身份管理實體
jbpm.repository.hbm.xml  # 流程定義倉庫實體
jbpm.task.hbm.xml        # 任務實體
jbpm.jpdl.hbm.xml        # jPDL 語言擴展實體

3.3 輔助配置文件

jbpm.task.lifecycle.xml       # 任務生命週期定義
jbpm.variable.types.xml       # 變量類型系統
jbpm.wire.bindings.xml        # Wire 依賴注入綁定
jbpm.jpdl.activities.xml      # jPDL 內建活動註冊
jbpm.jpdl.eventlisteners.xml  # jPDL 內建事件監聽器註冊

3.4 配置解析入口點

深入理解配置解析機制，請參考：

• 解析器類：org.jbpm.pvm.internal.env.JbpmConfigurationParser
• Wire 綁定資源：modules/pvm/src/main/resources/jbpm.wire.bindings.xml
• 綁定實現包：org.jbpm.pvm.internal.wire.binding