DialogContext Classe

Pacote:

com.microsoft.bot.dialogs

Artefato Maven:

com.microsoft.bot:bot-dialogs:4.14.3

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

public class DialogContext

Fornece contexto para o estado atual da pilha de diálogos.

Resumo do Construtor

Construtor	Description
DialogContext(DialogSet withDialogs, TurnContext withTurnContext, DialogState withState)	Inicializa uma nova instância da classe Contexto da Caixa de Diálogodo contexto de turno.
DialogContext(DialogSet withDialogs, DialogContext withParentDialogContext, DialogState withState)	Inicializa uma nova instância da classe Contexto da Caixa de Diálogodo contexto de turno.

Resumo do método

Modificador e tipo	Método e descrição
java.util.concurrent.CompletableFuture<DialogTurnResult>	beginDialog(String dialogId) Inicia uma nova caixa de diálogo e a envia para a pilha de caixas de diálogo.
java.util.concurrent.CompletableFuture<DialogTurnResult>	beginDialog(String dialogId, Object options) Inicia uma nova caixa de diálogo e a envia para a pilha de caixas de diálogo.
java.util.concurrent.CompletableFuture<DialogTurnResult>	cancelAllDialogs() O método auxiliar para cancelAllDialogs(boolean cancelParents, String eventName, Object eventValue) isso não cancela caixas de diálogo pai nem passa e evento.
java.util.concurrent.CompletableFuture<DialogTurnResult>	cancelAllDialogs(boolean cancelParents, String eventName, Object eventValue) Exclui qualquer pilha de diálogo existente, cancelando assim todas as caixas de diálogo na pilha.
java.util.concurrent.CompletableFuture<DialogTurnResult>	continueDialog() Continua a execução da caixa de diálogo ativa, se houver uma, passando o Contexto da Caixa de Diálogoatual para o método da caixa de continueDialog(DialogContext dc) diálogo ativa.
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() Método auxiliar que fornece um resultado nulo para endDialog(Object result).
java.util.concurrent.CompletableFuture<DialogTurnResult>	endDialog(Object result) Encerra uma caixa de diálogo tirando-a da pilha e retornando um resultado opcional para o pai da caixa de diálogo.
Dialog	findDialog(String dialogId) Localize a ID da caixa de diálogo para o contexto fornecido.
DialogInstance	getActiveDialog() Obtém a instância armazenada em cache da caixa de diálogo ativa na parte superior da pilha ou nula se a pilha estiver vazia.
DialogContext	getChild() Obtém o contexto da caixa de diálogo para filho se houver um filho ativo.
TurnContext	getContext() Obtém o contexto para a virada de conversa atual.
DialogSet	getDialogs() Obtém o conjunto de caixas de diálogo que estão ativas para o contêiner de caixa de diálogo atual.
java.lang.String	getLocale() Obtenha a localidade no Contexto da Caixa de Diálogo.
DialogContext	getParent() Obtém o contexto da caixa de diálogopai, se houver.
TurnContextStateCollection	getServices() Obtém a coleção de serviços que é contextual para esse contexto de caixa de diálogo.
java.util.List<DialogInstance>	getStack() Obtém a pilha de diálogo atual.
DialogStateManager	getState() Obtém ou define o Gerenciador de Estadoda Caixa de Diálogoque gerencia a exibição de todos os escopos de memória.
java.util.concurrent.CompletableFuture<DialogTurnResult>	prompt(String dialogId, PromptOptions options) Função auxiliar para simplificar a formatação das opções para chamar uma caixa de diálogo de prompt.
java.util.concurrent.CompletableFuture<DialogTurnResult>	replaceDialog(String dialogId) O método auxiliar para replaceDialog(String dialogId, Object options) isso passa nulo para opções.
java.util.concurrent.CompletableFuture<DialogTurnResult>	replaceDialog(String dialogId, Object options) Inicia uma nova caixa de diálogo e substitui a caixa de diálogo atualmente ativa na pilha por uma nova.
java.util.concurrent.CompletableFuture<java.lang.Void>	repromptDialog() Chama o método da caixa de repromptDialog(TurnContext turnContext, DialogInstance instance) diálogo atualmente ativa.
void	setParent(DialogContext withDialogContext) Defina o contexto da caixa de diálogopai.

Métodos herdados de 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

Detalhes do construtor

DialogContext

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

Inicializa uma nova instância da classe DialogContext do contexto de turno.

Parameters:

withDialogs - O conjunto de diálogos para o qual criar o contexto da caixa de diálogo.

withTurnContext - O contexto de turno atual.

withState - A propriedade state da qual recuperar o contexto da caixa de diálogo.

DialogContext

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

Inicializa uma nova instância da classe DialogContext do contexto de turno.

Parameters:

withDialogs - O conjunto de diálogos para o qual criar o contexto da caixa de diálogo.

withParentDialogContext - Contexto da caixa de diálogo pai.

withState - Estado da caixa de diálogo atual.

Detalhes do método

beginDialog

public CompletableFuture beginDialog(String dialogId)

Inicia uma nova caixa de diálogo e a envia para a pilha de caixas de diálogo.

Parameters:

dialogId - ID da caixa de diálogo a ser iniciada.

Returns:

Se a tarefa for bem-sucedida, o resultado indicará se a caixa de diálogo ainda estará ativa depois que a curva tiver sido processada pela caixa de diálogo.

beginDialog

public CompletableFuture beginDialog(String dialogId, Object options)

Inicia uma nova caixa de diálogo e a envia para a pilha de caixas de diálogo.

Parameters:

dialogId - ID da caixa de diálogo a ser iniciada.

options - Opcional, informações a serem passadas para a caixa de diálogo que está sendo iniciada.

Returns:

Se a tarefa for bem-sucedida, o resultado indicará se a caixa de diálogo ainda estará ativa depois que a curva tiver sido processada pela caixa de diálogo.

cancelAllDialogs

public CompletableFuture cancelAllDialogs()

O método auxiliar para cancelAllDialogs(boolean cancelParents, String eventName, Object eventValue) isso não cancela caixas de diálogo pai nem passa e evento.

Returns:

Se a tarefa for bem-sucedida, o resultado indicará que as caixas de diálogo foram canceladas depois que a curva foi processada pela caixa de diálogo ou que a pilha já estava vazia.

cancelAllDialogs

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

Exclui qualquer pilha de diálogo existente, cancelando assim todas as caixas de diálogo na pilha.

Em geral, o contexto pai é o manipulador de diálogo ou de turno do bot que iniciou a caixa de diálogo. Se o pai for uma caixa de diálogo, a pilha chamará o método pai resumeDialog(DialogContext dc, DialogReason reason, Object result) para retornar um resultado para a caixa de diálogo pai. Se a caixa de diálogo pai não implementar Dialog#resumeDialog, o pai também terminará e o resultado será passado para o próximo contexto pai.

Parameters:

cancelParents - Se for true, o cancelamento também será exibido por meio de qualquer caixa de diálogo pai.

eventName - O evento. Se for nulo, CANCEL_DIALOG será usado.

eventValue - O valor do evento. Pode ser nulo.

Returns:

Se a tarefa for bem-sucedida, o resultado indicará que as caixas de diálogo foram canceladas depois que a curva foi processada pela caixa de diálogo ou que a pilha já estava vazia.

continueDialog

public CompletableFuture continueDialog()

Continua a execução da caixa de diálogo ativa, se houver uma, passando o DialogContext atual para o método da caixa de continueDialog(DialogContext dc) diálogo ativa.

Returns:

Se a tarefa for bem-sucedida, o resultado indicará se a caixa de diálogo ainda estará ativa depois que a curva tiver sido processada pela caixa de diálogo.

emitEvent

public CompletableFuture emitEvent(String name)

Parameters:

name - Nome do evento para gerar.

Returns:

emitEvent

emitEvent

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

Parameters:

name - Nome do evento para gerar.

value - Valor a ser enviado junto com o evento.

bubble - Sinalize para controlar se o evento deve ser bolhas para seu pai se não for tratado localmente. O padrão é um valor de true.

fromLeaf - Se o evento é emitido de um nó folha.

Returns:

completedFuture

endDialog

public CompletableFuture endDialog()

Método auxiliar que fornece um resultado nulo para endDialog(Object result).

Returns:

Se a tarefa for bem-sucedida, o resultado indicará que a caixa de diálogo terminou depois que a curva foi processada pela caixa de diálogo.

endDialog

public CompletableFuture endDialog(Object result)

Encerra uma caixa de diálogo tirando-a da pilha e retornando um resultado opcional para o pai da caixa de diálogo. A caixa de diálogo pai é a caixa de diálogo em que o iniciado está sendo encerrado por meio de uma chamada para beginDialog(String dialogId, Object options) ou prompt(String dialogId, PromptOptions options). A caixa de diálogo pai terá seu resumeDialog(DialogContext dc, DialogReason reason, Object result) método invocado com qualquer resultado retornado. Se a caixa de diálogo pai não tiver implementado um resumeDialog(DialogContext dc, DialogReason reason) método, ele também será encerrado automaticamente e o resultado será passado para seu pai. Se não houver mais caixas de diálogo pai na pilha, o processamento da curva terminará.

Parameters:

result - Opcional, resultado a ser passado para o contexto pai.

Returns:

Se a tarefa for bem-sucedida, o resultado indicará que a caixa de diálogo terminou depois que a curva foi processada pela caixa de diálogo.

findDialog

public Dialog findDialog(String dialogId)

Localize a ID da caixa de diálogo para o contexto fornecido.

Parameters:

dialogId - ID da caixa de diálogo a ser encontrada.

Returns:

caixa de diálogo com essa ID ou nulo.

getActiveDialog

public DialogInstance getActiveDialog()

Obtém a instância armazenada em cache da caixa de diálogo ativa na parte superior da pilha ou nula se a pilha estiver vazia.

Returns:

A instância armazenada em cache da caixa de diálogo ativa na parte superior da pilha ou nula se a pilha estiver vazia.

getChild

public DialogContext getChild()

Obtém o contexto da caixa de diálogo para filho se houver um filho ativo.

Returns:

Contexto da caixa de diálogo para filho se houver um filho ativo.

getContext

public TurnContext getContext()

Obtém o contexto para a virada de conversa atual.

Returns:

O contexto para a virada de conversa atual.

getDialogs

public DialogSet getDialogs()

Obtém o conjunto de caixas de diálogo que estão ativas para o contêiner de caixa de diálogo atual.

Returns:

O conjunto de caixas de diálogo que estão ativas para o contêiner de caixa de diálogo atual.

getLocale

public String getLocale()

Obtenha a localidade em DialogContext.

Returns:

Uma Cadeia de Caracteres que representa a localidade atual.

getParent

public DialogContext getParent()

Obtém o DialogContext pai, se houver. Usado ao pesquisar a ID de uma caixa de diálogo a ser iniciada.

Returns:

O pai "DialogContext, se houver. Usado ao pesquisar a ID de uma caixa de diálogo a ser iniciada.

getServices

public TurnContextStateCollection getServices()

Obtém a coleção de serviços que é contextual para esse contexto de caixa de diálogo.

Returns:

Coleção de serviços.

getStack

public List getStack()

Obtém a pilha de diálogo atual.

Returns:

A pilha de diálogo atual.

getState

public DialogStateManager getState()

Obtém ou define o DialogStateManager que gerencia a exibição de todos os escopos de memória.

Returns:

DialogStateManager com exibição de memória unificada de todos os escopos de memória.

prompt

public CompletableFuture prompt(String dialogId, PromptOptions options)

Função auxiliar para simplificar a formatação das opções para chamar uma caixa de diálogo de prompt. Esse auxiliar pegará um argumento PromptOptions e, em seguida, chamará beginDialog(String dialogId, Object options)

Parameters:

dialogId - ID da caixa de diálogo de prompt a ser iniciada.

options - Informações a serem passadas para a caixa de diálogo de prompt que está sendo iniciada.

Returns:

Se a tarefa for bem-sucedida, o resultado indicará se a caixa de diálogo ainda estará ativa depois que a curva tiver sido processada pela caixa de diálogo.

replaceDialog

public CompletableFuture replaceDialog(String dialogId)

O método auxiliar para replaceDialog(String dialogId, Object options) isso passa nulo para opções.

Parameters:

dialogId - ID da nova caixa de diálogo a ser iniciada.

Returns:

Se a tarefa for bem-sucedida, o resultado indicará se a caixa de diálogo ainda estará ativa depois que a curva tiver sido processada pela caixa de diálogo.

replaceDialog

public CompletableFuture replaceDialog(String dialogId, Object options)

Inicia uma nova caixa de diálogo e substitui a caixa de diálogo atualmente ativa na pilha por uma nova. Isso é particularmente útil para criar loops ou redirecionar para outra caixa de diálogo.

Parameters:

dialogId - ID da nova caixa de diálogo a ser iniciada.

options - Opcional, informações a serem passadas para a caixa de diálogo que está sendo iniciada.

Returns:

Se a tarefa for bem-sucedida, o resultado indicará se a caixa de diálogo ainda estará ativa depois que a curva tiver sido processada pela caixa de diálogo.

repromptDialog

public CompletableFuture repromptDialog()

Chama o método da caixa de repromptDialog(TurnContext turnContext, DialogInstance instance) diálogo atualmente ativa. Usado com caixas de diálogo que implementam um comportamento de prompt novamente.

Returns:

Uma tarefa que representa o trabalho enfileirado para execução.

setParent

public void setParent(DialogContext withDialogContext)

Defina o DialogContext pai.

Parameters:

withDialogContext - O DialogContext para o qual definir o pai.