BotFrameworkHttpClient Klasse

  • Referenz
Paket:
com.microsoft.bot.integration
Maven-Artefakt:
com.microsoft.bot:bot-integration-core:4.14.3

public class BotFrameworkHttpClient
extends BotFrameworkClient

Klasse zum sicheren Posten von Aktivitäten in einem Bot mithilfe des BotFramework-HTTP-Protokolls. Diese Klasse kann verwendet werden, um Aktivitäten mithilfe des Bot Framework-HTTP-Protokolls sicher an einen Bot zu posten. Es gibt 2 Verwendungsmuster:* Weiterleitungsaktivität auf eine Fähigkeit (Bot -> Bot as a Skill), die über PostActivity(fromBotId, toBotId, Endpunkt, serviceUrl, aktivität);* Posten einer Aktivität an sich selbst (externer Dienst -> Bot), die über PostActivity(botId, Endpunkt, Aktivität)Diese wird von externen Diensten wie Webjobs verwendet, die Aktivitäten an den Bot mithilfe der bots eigenen Anmeldeinformationen posten müssen.

Zusammenfassung zum Konstruktor

Konstruktor Beschreibung
BotFrameworkHttpClient(CredentialProvider credentialProvider, ChannelProvider channelProvider)

Initialisiert eine neue Instanz der BotFrameworkHttpClient Klasse.

Methodenzusammenfassung

Modifizierer und Typ Methode und Beschreibung
java.util.concurrent.CompletableFuture<TypedInvokeResponse<T>> <T>postActivity(String fromBotId, String toBotId, URI toUrl, URI serviceUrl, String conversationId, Activity activity, Class<T> type)

Leitet eine Aktivität an eine Fähigkeit (Bot) weiter.
java.util.concurrent.CompletableFuture<TypedInvokeResponse<T>> <T>postActivity(String botId, URI botEndpoint, Activity activity, Class<T> type)

Posten Sie "Aktivität" im Bot, indem Sie die Anmeldeinformationen des Bots verwenden.
protected java.util.concurrent.CompletableFuture<AppCredentials> buildCredentials(String appId, String oAuthScope)

Logik zum Erstellen eines AppCredentials Objekts, das zum Abrufen von Token für diesen AbrufenHttpClient() verwendet werden soll.
protected static java.util.Map<java.lang.String,AppCredentials> getAppCredentialMapCache()

Ruft den Cache für Die AppAnmeldeinformationen ab, um den Tokenerwerb zu beschleunigen (ein Token wird nur angefordert, wenn es abgelaufen ist).
protected ChannelProvider getChannelProvider()

Ruft den Kanalanbieter für diesen Adapter ab.
protected CredentialProvider getCredentialProvider()

Ruft den Anmeldeinformationsanbieter für diesen Adapter ab.
okhttp3.OkHttpClient getHttpClient()

Ruft den Http--Client für diesen Adapter ab.

Geerbte Methoden von BotFrameworkClient

<T>postActivity

Geerbte Methoden von 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

Details zum Konstruktor

BotFrameworkHttpClient

public BotFrameworkHttpClient(CredentialProvider credentialProvider, ChannelProvider channelProvider)

Initialisiert eine neue Instanz der BotFrameworkHttpClient Klasse.

Parameter:

credentialProvider - Eine Instanz von CredentialProvider .
channelProvider - Eine Instanz von ChannelProvider .

Details zur Methode

<T>postActivity

public CompletableFuture> postActivity(String fromBotId, String toBotId, URI toUrl, URI serviceUrl, String conversationId, Activity activity, Class type)

Leitet eine Aktivität an eine Fähigkeit (Bot) weiter. HINWEIS: Durch das Weiterleiten einer Aktivität an eine Fähigkeit werden UserState- und ConversationState-Änderungen geleert, sodass die Fähigkeit einen genauen Zustand aufweist.

Überschreibt:

BotFrameworkHttpClient.<T>postActivity(String fromBotId, String toBotId, URI toUrl, URI serviceUrl, String conversationId, Activity activity, Class<T> type)

Parameter:

fromBotId - Die MicrosoftAppId des Bots, der die Aktivität sendet.
toBotId - Die MicrosoftAppId des Bots, der die Aktivität empfängt.
toUrl - Die URL des Bots, der die Aktivität empfängt.
serviceUrl - Die Rückruf-URL für den Qualifikationshost.
conversationId - Eine Unterhaltung D, die für die Unterhaltung mit den Fähigkeiten verwendet werden soll.
activity - Aktivitäten, die weitergeleitet werden sollen.
type

Gibt zurück:

task with optional invokeResponse.

<T>postActivity

public CompletableFuture> postActivity(String botId, URI botEndpoint, Activity activity, Class type)

Posten Sie "Aktivität" im Bot, indem Sie die Anmeldeinformationen des Bots verwenden.

Parameter:

botId - Die MicrosoftAppId des Bots.
botEndpoint - Die URL des Bots.
activity - Aktivität, die gepostt werden soll.
type - Typ von .

Gibt zurück:

InvokeResponse.

buildCredentials

protected CompletableFuture buildCredentials(String appId, String oAuthScope)

Logik zum Erstellen eines AppCredentials-Objekts, das zum Abrufen von Token für diesen getHttpClient() verwendet werden soll.

Parameter:

appId - Die Anwendungs-ID.
oAuthScope - Der optionale OAuth-Bereich.

Gibt zurück:

Die App-Anmeldeinformationen, die zum Abrufen von Token verwendet werden sollen.

getAppCredentialMapCache

protected static Map getAppCredentialMapCache()

Ruft den Cache für appCredentials ab, um den Tokenerwerb zu beschleunigen (ein Token wird nur angefordert, wenn es abgelaufen ist). AppCredentials werden mit appId + Scope zwischengespeichert (dieser letzte Parameter wird nur verwendet, wenn die App-Anmeldeinformationen zum Aufrufen einer Fähigkeit verwendet werden).

Gibt zurück:

der AppCredentialMapCache-Wert als statisches gleichzeitiges Diktieren<Zeichenfolge, AppCredentials>.

getChannelProvider

protected ChannelProvider getChannelProvider()

Ruft den Kanalanbieter für diesen Adapter ab.

Gibt zurück:

der ChannelProvider-Wert als getChannelProvider().

getCredentialProvider

protected CredentialProvider getCredentialProvider()

Ruft den Anmeldeinformationsanbieter für diesen Adapter ab.

Gibt zurück:

der CredentialProvider-Wert als getCredentialProvider().

getHttpClient

public OkHttpClient getHttpClient()

Ruft den HttpClient für diesen Adapter ab.

Gibt zurück:

der OkhttpClient-Wert als getHttpClient().

Gilt für: