AutoSaveStateMiddleware class

Middleware che salverà automaticamente le modifiche di stato alla fine del turno.

Commenti

La classe AutoSaveStateMiddleware deve essere aggiunta all'inizio dello stack middleware del bot, prima di qualsiasi altro componente che usa lo stato. Tutti i plug-in BotState passati al costruttore avranno il metodo BotState.saveChanges() chiamato al completamento corretto del turno.

Questo esempio mostra il codice boilerplate per la lettura e la scrittura di conversazioni e stato utente all'interno di un bot:

const { AutoSaveStateMiddleware, ConversationState, UserState, MemoryStorage } = require('botbuilder');

const storage = new MemoryStorage();
const conversationState = new ConversationState(storage);
const userState = new UserState(storage);
adapter.use(new AutoSaveStateMiddleware(conversationState, userState));

server.post('/api/messages', (req, res) => {
   adapter.processActivity(req, res, async (turnContext) => {
      // Get state
      const convo = await conversationState.load(turnContext);
      const user = await userState.load(turnContext);

      // ... route activity ...
      // ...make changes to state objects...
      // ... no need to call userState.saveChanges() or conversationState.saveChanges() anymore!
   });
});

Costruttori

AutoSaveStateMiddleware(BotState[])

Crea una nuova istanza di AutoSaveStateMiddleware.

Proprietà

botStateSet

Set di plug-in BotState salvati automaticamente.

Metodi

add(BotState[])

Aggiunge altri plug-in BotState da salvare.

onTurn(TurnContext, () => Promise<void>)

Chiamato dall'adapter (ad esempio, un BotFrameworkAdapter) in fase di esecuzione per elaborare un'attività in ingresso.

Dettagli costruttore

AutoSaveStateMiddleware(BotState[])

Crea una nuova istanza di AutoSaveStateMiddleware.

new AutoSaveStateMiddleware(botStates: BotState[])

Parametri

botStates

BotState[]

Uno o più plug-in BotState per salvare automaticamente alla fine del turno.

Dettagli proprietà

botStateSet

Set di plug-in BotState salvati automaticamente.

botStateSet: BotStateSet

Valore della proprietà

Dettagli metodo

add(BotState[])

Aggiunge altri plug-in BotState da salvare.

function add(botStates: BotState[]): this

Parametri

botStates

BotState[]

Uno o più plug-in BotState da aggiungere.

Restituisce

this

Oggetto BotStateSet aggiornato.

onTurn(TurnContext, () => Promise<void>)

Chiamato dall'adapter (ad esempio, un BotFrameworkAdapter) in fase di esecuzione per elaborare un'attività in ingresso.

function onTurn(context: TurnContext, next: () => Promise<void>): Promise<void>

Parametri

context
TurnContext

Oggetto di contesto per questo turno.

next

() => Promise<void>

La funzione delegato successiva.

Restituisce

Promise<void>