継続を使用した長時間コールアウトの実行

Apex クラスでの継続の処理

Apex クラスで継続を処理するためのステップは次の通りです。

1. 外部サービスをコールする前に、Salesforce ユーザインターフェース内の認証されたリモートサイトのリストにそのリモートサイトを追加する必要があります。[設定] から、[クイック検索] ボックスに「リモートサイトの設定」と入力します。[リモートサイトの設定] を選択して、[新規リモートサイト] をクリックします。次の Apex クラスの継続の例に示すように、LONG_RUNNING_SERVICE_URL に対応するコールアウトの URL を追加します。

   コールアウトでエンドポイントとして指定ログイン情報を指定する場合、リモートサイト設定を定義する必要はありません。指定ログイン情報では、1 つの定義にコールアウトエンドポイントの URL と必要な認証パラメータを指定します。コードに、長時間サービスの URL ではなく、指定ログイン情報 URL を指定します。

2. 長時間のコールアウトを実行するには、Continuation オブジェクトを返す Apex メソッドを定義します。(@AuraEnabled アノテーションの属性については後ほど説明します。)
3. コールアウトの完了後に Apex コールバックメソッドが呼び出されるように Continuation オブジェクトの continuationMethod プロパティで設定します。この例のコールバックメソッドは processResponse です。コールバックメソッドは、同じ Apex クラスに属している必要があります。
4. HttpRequest オブジェクトを Continuation オブジェクトに追加して、コールアウトのエンドポイントを設定します。1 つの Continuation オブジェクトに最大 3 個のコールアウトを含めることができます。各コールアウトには、リモートサイトまたは指定ログイン情報が [設定] で定義されている必要があります。
5. コールバックメソッドに渡すデータを Continuation オブジェクトの state プロパティで設定します。state プロパティにはオブジェクト型があるため、Apex でサポートされているすべてのデータ型を渡すことができます。
6. Apex コールバックでロジックをコーディングします。Continuation オブジェクトに設定されているすべてのコールアウトが完了すると、Apex コールバックメソッドの processResponse が呼び出されます。このコールバックメソッドには 2 つのアクセス可能なパラメータがあります。
   1. labels — 継続に含まれる各リクエストのラベルのリスト。ラベルは自動的に作成されます。
   2. state — Continuation オブジェクトの state プロパティで設定した状態。
7. 継続に含まれる各要求に対する応答。次に例を示します。
8. 結果を JavaScript コントローラに返します。

継続を使用した完全な Apex クラスの例

上記のすべてのステップを 1 つにまとめた完全な Apex クラスの例を示します。