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

イベントの再生の 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() 関数をコールして再生オプションを設定しています。