Apex 開発者ガイド
jTransaction Finalizers (パイロット)
Transaction Finalizers 機能により、System.Finalizer インターフェースを使用して、キュー可能フレームワークを使う非同期 Apex ジョブにアクションを関連付けることができます。具体的な使用事例として、キュー可能ジョブが失敗した場合の回復アクションの設計が挙げられます。
非同期ジョブが成功または失敗したときに実行されるアクションを Transaction Finalizers よりも前に直接指定する方法はありません。SOQL クエリを使用して AsyncApexJob の状況をポーリングし、ジョブが失敗している場合にジョブを再度キューに追加することしかできません。Transaction Finalizers を使用すると、後処理アクションシーケンスをキュー可能ジョブに関連付け、ジョブの実行結果に基づいて関連するアクションを実行できます。
System.Finalizer インターフェース
System.Finalizer インターフェースには execute メソッドがあります。
System.FinalizerContext インターフェース
System.FinalizerContext インターフェースには 4 つのメソッドがあります。
-
getAsyncApexJobId メソッドこの Finalizer が定義されているキュー可能ジョブの ID を返します。
-
getRequestId メソッド要求を一意に識別する文字列である要求 ID を返し、イベントモニタリングログと関連付けることができます。AsyncApexJob テーブ���と関連付けるには、代わりに getAsyncApexJobId メソッドを使用します。キュー可能ジョブと Finalizer の実行の両方が (同じ) 要求 ID を使用します。
-
getResult メソッドFinalizer が関連付けられている親非同期 Apex キュー可能ジョブの結果を表す System.ParentJobResult 列挙を返します。この列挙は、SUCCESS、UNHANDLED_EXCEPTION の値を取ります。
-
getException メソッドgetResult が UNHANDLED_EXCEPTION の場合はキュー可能ジョブが失敗し、それ以外の場合は null になる例外を返します。
アクションをキュー可能ジョブに関連付けるには、次のように FinalizerContext インターフェースを実装します。
- System.FinalizerContext インターフェースを実装するクラスを定義します。
- キュー可能ジョブの execute メソッド内で Finalizer を関連付けます。Finalizer を関連付けるには、System.FinalizerContext インターフェースを実装するインスタンス化されたクラスの引数として System.attachFinalizer メソッド使用して、このメソッドを呼び出します。
例
例の処理を説明する