DialogContext クラス

  • java.lang.Object
    • com.microsoft.bot.dialogs.DialogContext

public class DialogContext

ダイアログ スタックの現在の状態のコンテキストを提供します。

コンストラクターの概要

コンストラクター 説明
DialogContext(DialogSet withDialogs, TurnContext withTurnContext, DialogState withState)

ダイアログコンテキスト クラスの新しいインスタンスをターン コンテキストから初期化します。

DialogContext(DialogSet withDialogs, DialogContext withParentDialogContext, DialogState withState)

ダイアログコンテキスト クラスの新しいインスタンスをターン コンテキストから初期化します。

メソッドの概要

修飾子と型 メソッドと説明
java.util.concurrent.CompletableFuture<DialogTurnResult> beginDialog(String dialogId)

新しいダイアログを開始し、ダイアログ スタックにプッシュします。

java.util.concurrent.CompletableFuture<DialogTurnResult> beginDialog(String dialogId, Object options)

新しいダイアログを開始し、ダイアログ スタックにプッシュします。

java.util.concurrent.CompletableFuture<DialogTurnResult> cancelAllDialogs()

親ダイアログやパスとイベントを取り消さない cancelAllDialogs(boolean cancelParents, String eventName, Object eventValue) のヘルパー メソッド。

java.util.concurrent.CompletableFuture<DialogTurnResult> cancelAllDialogs(boolean cancelParents, String eventName, Object eventValue)

既存のダイアログ スタックを削除し、スタック上のすべてのダイアログを取り消します。

java.util.concurrent.CompletableFuture<DialogTurnResult> continueDialog()

現在のダイアログコンテキストをアクティブなダイアログの continueDialog(DialogContext dc) メソッドに渡すことで、アクティブなダイアログがある場合は、そのダイアログの実行を続行します。

java.util.concurrent.CompletableFuture<java.lang.Boolean> emitEvent(String name)
java.util.concurrent.CompletableFuture<java.lang.Boolean> emitEvent(String name, Object value, boolean bubble, boolean fromLeaf)
java.util.concurrent.CompletableFuture<DialogTurnResult> endDialog()

endDialog(Object result)に null 結果を提供するヘルパー メソッド。

java.util.concurrent.CompletableFuture<DialogTurnResult> endDialog(Object result)

スタックからダイアログをポップして終了し、オプションの結果をダイアログの親に返します。

Dialog findDialog(String dialogId)

指定されたコンテキストのダイアログ ID を検索します。

DialogInstance getActiveDialog()

スタックの上部にあるアクティブなダイアログのキャッシュされたインスタンスを取得します。スタックが空の場合は null を取得します。

DialogContext getChild()

アクティブな子がある場合は、子のダイアログ コンテキストを取得します。

TurnContext getContext()

会話の現在のターンのコンテキストを取得します。

DialogSet getDialogs()

現在のダイアログ コンテナーでアクティブなダイアログのセットを取得します。

java.lang.String getLocale()

ダイアログコンテキストでロケールを取得します。

DialogContext getParent()

親ダイアログコンテキスト (存在する場合) を取得します。

TurnContextStateCollection getServices()

このダイアログ コンテキストに依存するサービス コレクションを取得します。

java.util.List<DialogInstance> getStack()

現在のダイアログ スタックを取得します。

DialogStateManager getState()

すべてのメモリ スコープのビューを管理するダイアログStateManager を取得または設定します。

java.util.concurrent.CompletableFuture<DialogTurnResult> prompt(String dialogId, PromptOptions options)

プロンプト ダイアログを呼び出すためのオプションの書式設定を簡略化するヘルパー関数。

java.util.concurrent.CompletableFuture<DialogTurnResult> replaceDialog(String dialogId)

オプションに null を渡す replaceDialog(String dialogId, Object options) のヘルパー メソッド。

java.util.concurrent.CompletableFuture<DialogTurnResult> replaceDialog(String dialogId, Object options)

新しいダイアログを開始し、スタック上で現在アクティブなダイアログを新しいダイアログに置き換えます。

java.util.concurrent.CompletableFuture<java.lang.Void> repromptDialog()

現在アクティブなダイアログの repromptDialog(TurnContext turnContext, DialogInstance instance) メソッドを呼び出します。

void setParent(DialogContext withDialogContext)

親ダイアログコンテキストを設定します。

メソッドの継承元: java.lang.Object

java.lang.Object.clone java.lang.Object.equals java.lang.Object.finalize java.lang.Object.getClass java.lang.Object.hashCode java.lang.Object.notify java.lang.Object.notifyAll java.lang.Object.toString java.lang.Object.wait java.lang.Object.wait java.lang.Object.wait

コンストラクターの詳細

DialogContext

public DialogContext(DialogSet withDialogs, TurnContext withTurnContext, DialogState withState)

ターン コンテキストから DialogContext クラスの新しいインスタンスを初期化します。

パラメーター:

withDialogs - ダイアログ コンテキストを作成するダイアログ セット。
withTurnContext - 現在のターン コンテキスト。
withState - ダイアログ コンテキストを取得する状態プロパティ。

DialogContext

public DialogContext(DialogSet withDialogs, DialogContext withParentDialogContext, DialogState withState)

ターン コンテキストから DialogContext クラスの新しいインスタンスを初期化します。

パラメーター:

withDialogs - ダイアログ コンテキストを作成するダイアログ セット。
withParentDialogContext - 親ダイアログ コンテキスト。
withState - 現在のダイアログの状態。

メソッドの詳細

beginDialog

public CompletableFuture beginDialog(String dialogId)

新しいダイアログを開始し、ダイアログ スタックにプッシュします。

パラメーター:

dialogId - 開始するダイアログの ID。

戻り値:

タスクが成功した場合、結果は、ダイアログによってターンが処理された後もダイアログがアクティブかどうかを示します。

beginDialog

public CompletableFuture beginDialog(String dialogId, Object options)

新しいダイアログを開始し、ダイアログ スタックにプッシュします。

パラメーター:

dialogId - 開始するダイアログの ID。
options - 省略可能。開始中のダイアログに渡す情報。

戻り値:

タスクが成功した場合、結果は、ダイアログによってターンが処理された後もダイアログがアクティブかどうかを示します。

cancelAllDialogs

public CompletableFuture cancelAllDialogs()

親ダイアログやパスとイベントを取り消さない cancelAllDialogs(boolean cancelParents, String eventName, Object eventValue) のヘルパー メソッド。

戻り値:

タスクが成功した場合、結果は、ダイアログによってターンが処理された後にダイアログが取り消されたか、スタックが既に空であることを示します。

cancelAllDialogs

public CompletableFuture cancelAllDialogs(boolean cancelParents, String eventName, Object eventValue)

既存のダイアログ スタックを削除し、スタック上のすべてのダイアログを取り消します。

一般に、親コンテキストは、ダイアログを開始したダイアログまたはボット ターン ハンドラーです。 親がダイアログの場合、スタックは親の resumeDialog(DialogContext dc, DialogReason reason, Object result) メソッドを呼び出して、親ダイアログに結果を返します。 親ダイアログに Dialog#resumeDialogが実装されていない場合、親も終了し、結果は次の親コンテキストに渡されます。

パラメーター:

cancelParents - true の場合、キャンセルは親ダイアログでもバブル アップします。
eventName - イベント。 null の場合、CANCEL_DIALOG が使用されます。
eventValue - イベント値。 null を指定できます。

戻り値:

タスクが成功した場合、結果は、ダイアログによってターンが処理された後にダイアログが取り消されたか、スタックが既に空であることを示します。

continueDialog

public CompletableFuture continueDialog()

現在の DialogContext をアクティブなダイアログの continueDialog(DialogContext dc) メソッドに渡すことで、アクティブなダイアログがある場合は、アクティブなダイアログの実行を続行します。

戻り値:

タスクが成功した場合、結果は、ダイアログによってターンが処理された後もダイアログがアクティブかどうかを示します。

emitEvent

public CompletableFuture emitEvent(String name)

パラメーター:

name - 発生させるイベントの名前。

戻り値:

emitEvent

emitEvent

public CompletableFuture emitEvent(String name, Object value, boolean bubble, boolean fromLeaf)

パラメーター:

name - 発生させるイベントの名前。
value - イベントと共に送信する値。
bubble - ローカルで処理されない場合にイベントを親にバブルするかどうかを制御するフラグ。 既定値は trueです。
fromLeaf - イベントがリーフ ノードから出力されるかどうか。

戻り値:

completedFuture

endDialog

public CompletableFuture endDialog()

endDialog(Object result)に null 結果を提供するヘルパー メソッド。

戻り値:

タスクが成功した場合、結果は、ターンがダイアログによって処理された後にダイアログが終了したことを示します。

endDialog

public CompletableFuture endDialog(Object result)

スタックからダイアログをポップして終了し、オプションの結果をダイアログの親に返します。 親ダイアログは、beginDialog(String dialogId, Object options) または prompt(String dialogId, PromptOptions options)の呼び出しを介して開始されたダイアログです。 親ダイアログには、返された結果で resumeDialog(DialogContext dc, DialogReason reason, Object result) メソッドが呼び出されます。 親ダイアログで resumeDialog(DialogContext dc, DialogReason reason) メソッドが実装されていない場合は、自動的に終了し、結果がその親に渡されます。 スタック上にそれ以上親ダイアログがない場合、ターンの処理は終了します。

パラメーター:

result - 省略可能。親コンテキストに渡す結果。

戻り値:

タスクが成功した場合、結果は、ターンがダイアログによって処理された後にダイアログが終了したことを示します。

findDialog

public Dialog findDialog(String dialogId)

指定されたコンテキストのダイアログ ID を検索します。

パラメーター:

dialogId - 検索するダイアログ ID。

戻り値:

その ID を持つダイアログ、または null。

getActiveDialog

public DialogInstance getActiveDialog()

スタックの上部にあるアクティブなダイアログのキャッシュされたインスタンスを取得します。スタックが空の場合は null を取得します。

戻り値:

スタックの上部にあるアクティブなダイアログのキャッシュされたインスタンス。スタックが空の場合は null。

getChild

public DialogContext getChild()

アクティブな子がある場合は、子のダイアログ コンテキストを取得します。

戻り値:

アクティブな子がある場合の子のダイアログ コンテキスト。

getContext

public TurnContext getContext()

会話の現在のターンのコンテキストを取得します。

戻り値:

会話の現在のターンのコンテキスト。

getDialogs

public DialogSet getDialogs()

現在のダイアログ コンテナーでアクティブなダイアログのセットを取得します。

戻り値:

現在のダイアログ コンテナーでアクティブなダイアログのセット。

getLocale

public String getLocale()

DialogContext でロケールを取得します。

戻り値:

現在のロケールを表す文字列。

getParent

public DialogContext getParent()

親 DialogContext (存在する場合) を取得します。 開始するダイアログの ID を検索するときに使用されます。

戻り値:

親 "DialogContext (存在する場合)。 開始するダイアログの ID を検索するときに使用されます。

getServices

public TurnContextStateCollection getServices()

このダイアログ コンテキストに依存するサービス コレクションを取得します。

戻り値:

サービス コレクション。

getStack

public List getStack()

現在のダイアログ スタックを取得します。

戻り値:

現在のダイアログ スタック。

getState

public DialogStateManager getState()

すべてのメモリ スコープのビューを管理する DialogStateManager を取得または設定します。

戻り値:

すべてのメモリ スコープの統合メモリ ビューを持つ DialogStateManager。

prompt

public CompletableFuture prompt(String dialogId, PromptOptions options)

プロンプト ダイアログを呼び出すためのオプションの書式設定を簡略化するヘルパー関数。 このヘルパーは PromptOptions 引数を受け取り、beginDialog(String dialogId, Object options) を呼び出します。

パラメーター:

dialogId - 開始するプロンプト ダイアログの ID。
options - 開始中のプロンプト ダイアログに渡す情報。

戻り値:

タスクが成功した場合、結果は、ダイアログによってターンが処理された後もダイアログがアクティブかどうかを示します。

replaceDialog

public CompletableFuture replaceDialog(String dialogId)

オプションに null を渡す replaceDialog(String dialogId, Object options) のヘルパー メソッド。

パラメーター:

dialogId - 開始する新しいダイアログの ID。

戻り値:

タスクが成功した場合、結果は、ダイアログによってターンが処理された後もダイアログがアクティブかどうかを示します。

replaceDialog

public CompletableFuture replaceDialog(String dialogId, Object options)

新しいダイアログを開始し、スタック上で現在アクティブなダイアログを新しいダイアログに置き換えます。 これは、ループを作成したり、別のダイアログにリダイレクトしたりする場合に特に便利です。

パラメーター:

dialogId - 開始する新しいダイアログの ID。
options - 省略可能。開始中のダイアログに渡す情報。

戻り値:

タスクが成功した場合、結果は、ダイアログによってターンが処理された後もダイアログがアクティブかどうかを示します。

repromptDialog

public CompletableFuture repromptDialog()

現在アクティブなダイアログの repromptDialog(TurnContext turnContext, DialogInstance instance) メソッドを呼び出します。 再プロンプト動作を実装するダイアログで使用されます。

戻り値:

実行するキューに登録された作業を表すタスク。

setParent

public void setParent(DialogContext withDialogContext)

親 DialogContext を設定します。

パラメーター:

withDialogContext - 親を設定する DialogContext。

適用対象