WF4.0 基礎篇(16)：CompensableActivity 補償機制實現交易語意與錯誤回滾

CompensableActivity 提供類似資料庫交易的補償/確認機制：Body (主邏輯)、CompensationHandler (補償/回滾)、ConfirmationHandler (確認/提交)、CancellationHandler (取消處理)。配合 Compensate、Confirm 活動可顯式控制，亦支援異常自動觸發。

核心活動速覽

自動執行規則

• 正常完成：自動執行所有 ConfirmationHandler (由內而外、由下而上)
• 外部異常 + OnUnhandledException=Cancel：自動執行 CompensationHandler
• Body 內部異常 + OnUnhandledException=Cancel：自動執行 CancellationHandler
• TerminateWorkflow：不觸發任何補償/確認行為

顯式調用控制

• 需將 CompensableActivity.Result 繫結至 CompensationToken 變數
• Compensate/Confirm 的 Target 繫結該 Token
• 每個 Token 只能被調用一次；Confirm 後不可 Compensate，反之亦然
• 顯式調用後不再自動執行對應 Handler

Confirm 顯式調用：

Compensate 顯式調用：

多層/巢狀 CompensableActivity 執行順序

• 無異常：ConfirmationHandler 執行順序 - 同層由下而上、巢狀由外而內
• 外部異常：同層執行 ConfirmationHandler，子層執行 ConfirmationHandler
• 內部異常 (父子關係)：直接父子層執行 CancellationHandler，旁系執行 ConfirmationHandler

原始碼下載：CompensableWorkflow.rar