Momento トピックを使用してデータを非同期に処理する

Momento Topicsを使用すると、トピック上のメッセージを購読したり、別のトピックにメッセージを公開したりできます。Webhooksを使うと、これらのトピックをステートレスコンシューマーに接続し、非同期にイベントを処理することができます。イベントを topic_id で集約したり、各イベントをデータベースに保存したり、ペイロードを使用して Step 関数のワークフローをトリガーしたり、Webhook を使用することで、これらのイベントを好きなように処理する柔軟性が得られます。

これらのイベントを非同期に処理する鍵は、複数のトピックを使うことである。Webhookがリッスンするインバウンドトピックと、処理されたデータを公開する単一または複数のアウトバウンドトピックです。

Architecture

この図では、Topic 1 が 受信トピックで、Topic 2 が 送信トピックです。

前提条件

Webhook イベントを受信するためのパブリック向けのエンドポイント。このエンドポイントは POST リクエストを受け入れ、Momento からの着信コールを受け取ることができなければなりません。このイベントの構造の詳細については、こちらを参照してください。

Getting Started

Momentoコンソールにキャッシュを作成する
キャッシュ用にWebhookを作成する。webhook の宛先を公開エンドポイントに割り当てます。
受信メッセージを処理するコードを webhook に追加します。例えば、あなたの webhook が API Gateway の背後にある AWS Lambda 関数として実装されている場合、以下は受信メッセージを処理し、大文字に変換し、送信トピックに発行する非常に単純なコードです：

import {
    APIGatewayProxyEvent,
    APIGatewayProxyResult
} from "aws-lambda/trigger/api-gateway-proxy";

import {TopicClient, CredentialProvider} from '@gomomento/sdk';


interface MomentoWebhookEvent {
    cache: string;
    topic: string;
    event_timestamp: number;
    publish_timestamp: number;
    topic_sequence_number: number;
    token_id: string;
    text: string;
}

const momento = new TopicClient({
    credentialProvider: CredentialProvider.fromString('<the api key>'),
})

export const lambdaHandler = async (
    event: APIGatewayProxyEvent
): Promise<APIGatewayProxyResult> => {
    const webhookEvent: WebhookEvent = JSON.parse(event.body);
    // simply take the current message, uppercase it, and publish to a new topic
    await momento.publish(webhookEvent.cache, "topic 2", webhookEvent.text.toUpperCase());
    return {
        statusCode: 200,
        body: JSON.stringify({status : "success"})
    }
}

<SdkExampleCodeBlock language={'javascript'} file={'examples/nodejs/webhooks/doc-example-files/webhook-lambda-handler.ts'} />

4. クライアント側で、この新しい`topic 2`に購読者を追加する
```typescript
const result = await topicClient.subscribe(cacheName, 'topic 2', {
    onError: () => {
        console.error('Received an error from the topic');
        return;
    },
    onItem: (item: TopicItem) => {
        console.log(`Received uppercase text on topic 'topic-b': ${item.value().toString()}`);
        return;
    },
});

Webhookがリッスンしているトピックへのメッセージのパブリッシュを開始します。トピックへの発行には、Momento SDK を使用します

import {TopicPublish} from '@gomomento/sdk';
const publishResponse = await topicClient.publish(cacheName, 'topic 1', 'a value');
if (publishResponse instanceof TopicPublish.Success) {
    console.log('Value published successfully!');
} else {
    console.log(`Error publishing value: ${publishResponse.toString()}`);
}

これで topic 2 のサブスクライバーは大文字のメッセージを受信し、コンソールにメッセージをロギングします！

これで終わりです！これは文字列変換の極めて基本的な例だが、このパターンは、DBへの状態保存やキューへのメッセージ発行など、より高度な非同期処理にも当てはまります。アプリケーションの負荷がAPI Gateway + Lambda関数のような環境を超えた場合、コンテナやEC2インスタンスに簡単に置き換えることができます。イベント処理にWebhookを使用する、より完全な例については、私たちのEventBridge exampleや、このパターンを使用して多言語チャットアプリケーションを作成するblog postをチェックしてください。

前提条件​

Getting Started​

前提条件

Getting Started