イベントの再実行サンプル: コードのウォークスルー

イベントの再実行の JavaScript サンプル

再実行オプションで CometD クライアントを実装する場合、Visualforce コンポーネントを再利用するか、アプリケーションの JavaScript コードを適合できます。このセクションではサンプルコンポーネント部分が強調表示されています。

まず、Salesforce が提供する CometD 拡張 cometdReplayExtension を登録してイベントを再実行します。このスニペットでは、ストリーミングチャネルと再実行オプションも設定します。registerExtension の最初の引数は、拡張の登録解除に使用する任意の名前です。

次に、クライアントが CometD 再実行エンドポイントに接続します。エンドポイントの API バージョンは 37.0 以降である必要があります。現在のセッションのセッション ID 値が Authorization ヘッダーで渡されます。クライアントが cometd configure() 関数をコールして接続を設定し、エンドポイントおよび認証ヘッダーを指定します。次に、クライアントが cometd handshake() 関数をコールしてハンドシェイクを実行します。

接続プロセスのすべてのステップが正常に終了したことを確認するため、次のステップに進む前にクライアントはリスナを使用します。たとえば、/meta/handshake チャネルのリスナは、ハンドシェイクが成功したかどうかを確認します。成功した場合、subscribe() 関数がコールされます。

最後に、CometD subscribe() 関数のコールバックを指定します。チャネルでメッセージが受信されたときに、CometD がこのコールバック関数をコールします。このサンプルでは、コールバック関数によってページにメッセージデータが表示されます。ID 値が "content" の div HTML 要素にデータが追加されます。

cometdReplayExtension 拡張

cometdReplayExtension には、受信メッセージと送信メッセージでコールされる cometd 拡張関数が含まれます。これらの拡張関数は、ハンドシェイク時に拡張の登録を確認し、登録時に再実行オプションを設定するロジックを実装します。

ハンドシェイク時に、受信メッセージの関数で再実行拡張が登録されているかどうかが確認されます。登録されている場合は、_extensionEnabled 変数が true に設定されます。この関数は受信メッセージの再実行 ID も保存するため、クライアントのタイムアウト後に再接続するときに使用できます。

登録時に、送信メッセージの関数で _extensionEnabled 変数を使用して再実行拡張が登録されているかどうかが確認されます。拡張が登録されている場合、関数は指定された再実行オプションに基づいてイベントに登録します。このサンプルでは、拡張の setReplay() 関数をコールして再実行オプションを設定しています。