Middleware インターフェイス

パッケージ:

com.microsoft.bot.builder

Maven 成果物:

com.microsoft.bot:bot-builder:4.14.3

public interface Middleware

受信アクティビティを操作できるミドルウェアを表します。 は BotAdapter 、ユーザーのチャネルからミドルウェア onTurn(TurnContext turnContext, NextDelegate next) の メソッドに受信アクティビティを渡します。

ミドルウェア オブジェクトは、adapter\u2019s ミドルウェア コレクションに追加できます。 アダプターは、ボット ミドルウェア パイプラインを介して で受信アクティビティを処理し、bot\u2019s ロジックに転送してから、もう一度戻します。 各アクティビティがボットを出入りして流れる際、ボット ロジックの実行前と実行後のどちらでも、各ミドルウェアがアクティビティを検査または操作できます。

アダプターはアクティビティごとに、追加された順にミドルウェアを呼び出します。

これにより、アダプターがボットのメソッドを呼び出す前と後に "before" メッセージと "after" メッセージを送信するミドルウェアが onTurn(TurnContext turnContext) 定義されます。 public class SampleMiddleware : Middleware { public async Task OnTurn(TurnContext context, MiddlewareSet.NextDelegate next) { context.SendActivity("before"); await next().ConfigureAwait(false); context.SendActivity("after"); } } Bot

メソッドの概要

修飾子と型	メソッドと説明
abstract java.util.concurrent.CompletableFuture<java.lang.Void>	onTurn(TurnContext turnContext, NextDelegate next) 受信アクティビティを処理します。

メソッドの詳細

onTurn

public abstract CompletableFuture onTurn(TurnContext turnContext, NextDelegate next)

受信アクティビティを処理します。

Parameters:

turnContext - このターンのコンテキスト オブジェクト。

next - ボット ミドルウェア パイプラインを続行するために 呼び出すデリゲート。

Returns:

実行するキューに登録された作業を表すタスク。 ミドルウェアは、デリゲートを next 呼び出して、パイプライン内の次のミドルウェアに制御を渡します。 ミドルウェアが次のデリゲートを呼び出さない場合、アダプターは後続のミドルウェア\u2019s 要求ハンドラーまたは bot\u2019s 受信ハンドラー、およびパイプラインショートサーキットを呼び出しません。

は context 、受信アクティビティと、アクティビティの処理に必要なその他のデータに関する情報を提供します。 TurnContext Activity