jBPM 4 內置 IOC 容器架構解析：WireContext、Descriptor、Binding 與雙層上下文機制

jBPM 4 未依賴 Spring 等外部 IOC 容器，而是自行實現輕量級容器 WireContext，通過 WireParser 解析 XML 配置、Binding 映射標籤到 Descriptor、Descriptor 實例化組件，構建雙層上下文 (ProcessEngineContext、TransactionContext) 服務運行時全生命周期。本文深度解析容器核心類協作與應用模式。

核心類職責鏈

WireParser (解析 XML)
    ↓ 加載 Binding 列表 (默認 jbpm.wire.bindings.xml)
Binding (標籤 → Descriptor 轉換器)
    ↓ 生成 Descriptor 並加入 WireDefinition
WireDefinition (Descriptor 註冊表)
    ↓ 返回 WireContext
WireContext (運行時容器)
    ├── 緩存 Map<String, Object> 實例
    ├── 獲取組件: get(String key) / get(Class<T> type)
    └── 實例化委托 Descriptor

四種實例化策略 (Descriptor 定義)

雙層上下文架構 — 運行時核心

1. ProcessEngineContext (全局單例)

對應配置 <process-engine-context>：

<process-engine-context>
  <repository-service />
  <repository-cache />
  <execution-service />
  <history-service />
  <management-service />
  <identity-service />
  <task-service />
  <hibernate-configuration><cfg resource="jbpm.hibernate.cfg.xml"/></hibernate-configuration>
  <hibernate-session-factory />
</process-engine-context>

• 生命周期：引擎啟動創建，關閉銷毀，全局唯一。
• 持有：所有業務服務、Hibernate SessionFactory、緩存等長壽組件。

2. TransactionContext (請求級/事務級)

對應配置 <transaction-context>：

<transaction-context>
  <repository-session />
  <pvm-db-session />
  <job-db-session />
  <task-db-session />
  <message-session />
  <timer-session />
  <history-session />
</transaction-context>

• 生命周期：每次 EnvironmentFactory.openEnvironment() 創建，close() 銷毀。
• 持有：數據庫 Session (Hibernate/JDBC)、各類 DbSession、事務對象等短壽組件。

Environment 線程綁定與充血模型

// 簡化流程
Environment env = EnvironmentFactory.openEnvironment(); // 創建 TransactionContext 壓入
try {
    // 領域模型方法內部
    ExecutionService es = Environment.getFromCurrent(ExecutionService.class);
    es.startProcessInstanceByKey("order");
} finally {
    EnvironmentFactory.closeEnvironment(); // 彈出並關閉 TransactionContext
}

• Environment 通過 ThreadLocal 綁定當前線程上下文棧。
• 領域對象 (Entity) 可直接從 Environment 獲取服務，實現「充血模型」 (行為與數據封裝在一起)。
• 服務查找統一入口：Context.get(key) / Context.get(type)。

配置文件中的 Wire 綁定 (jbpm.wire.bindings.xml)

定義標籤名到 Binding 實現類的映射，例如：

<wire xmlns="https://jbpm.org/wire">
  <binding name="repository-service" class="org.jbpm.pvm.internal.wire.binding.RepositoryServiceBinding"/>
  <binding name="hibernate-session-factory" class="org.jbpm.pvm.internal.wire.binding.HibernateSessionFactoryBinding"/>
  <!-- 更多綁定 -->
</wire>

每個 Binding 負責將 XML 元素屬性/子元素轉換為 Descriptor 參數，支援構造器注入、設值注入、工廠方法、生命周期回調等。

總結：為什麼自建容器？

jBPM 4 的 WireContext 雖功能不及 Spring 完整，但針對流程引擎「雙層上下文、事務緊耦合、零依賴嵌入」三大核心需求量身定制，是領域特化容器設計的優秀案例。理解其機制有助於排查引擎啟動失敗、服務注入失效、事務邊界異常等疑難問題。