Freigeben über

Schnittstellen für einen isolierten Empfangsadapter

  • Artikel

Isolierte Empfangsadapter werden in einem anderen Prozessbereich als dem BizTalk Server-Prozess gehostet. Damit ein isolierter Empfangsadapter mit der Messaging-Engine interagieren kann, registriert sich dieser während des Systemstarts, sodass er von der Engine konfiguriert und gesteuert werden kann. Der Adapter erstellt den Transportproxy, fragt die Schnittstelle IBTTransportProxy ab und ruft IBTTransportProxy.RegisterIsolatedReceiver auf, um seine IBTTransportConfig-Rückrufschnittstelle bei der Messaging-Engine zu registrieren. Dieser synchrone Aufruf erfolgt, bevor der Adapter seine erste Nachricht an BizTalk Server sendet. So kann die Messaging-Engine einen Rückruf in den Adapter ausführen und angeben, welche seiner Endpunkte aktiv sind und auf eingehende Nachrichten überwacht werden sollen. Isolierte Adapter müssen die folgenden Schnittstellen implementieren:

  • IBTTransport

  • IBTTransportConfig

  • IBaseComponent

  • IPersistPropertyBag

    Für die Registrierung des Adapters muss der Adapter einen konfigurierten und aktivierten Empfangsspeicherort übergeben. Der Hostprozess des Adapters muss ein Mitglied der Gruppe Benutzer isolierter BizTalk-Hosts sein. Außerdem wird der Adapter abgefragt, um sicherzustellen, dass er über die ordnungsmäßige Klassen-ID verfügt und auf dem Computer ausgeführt wird, der für diese Hostinstanz konfiguriert wurde.

    Nachdem der Adapter erfolgreich beim Transportproxy registriert wurde, übergibt die Messaging-Engine die Konfigurationsinformationen und die anderen Empfangsorte zurück an den Adapter, indem die Load-Methode der IPersistPropertyBag-Schnittstelle bzw . die AddReceiveEndpoint-Methode der IBTTransportConfig-Schnittstelle aufgerufen wird.

    Wenn ein isolierter Empfangsadapter die Verarbeitung von Nachrichten beendet und beendet wird, muss er die TerminateIsolatedReceiver-Methode der IBTTransportProxy-Schnittstelle aufrufen.

    In der folgenden Abbildung sind die Objektinteraktionen beim Erstellen eines isolierten Empfangsadapters dargestellt.

    Abbildung, die die Objektinteraktionen zeigt, die beim Erstellen eines isolierten Empfangsadapters beteiligt sind.
    Workflow der Initialisierung eines isolierten Empfangsadapters

Hinweis

Es wird empfohlen, dass der Adapter die derzeit ausgeführten Anforderungen an BizTalk Server nachverfolgt. Der Adapter sollte die Terminate-Methode blockieren, bis die Arbeitsanzahl 0 erreicht hat. Auf der Empfangsseite umfasst diese Arbeit alle ausstehenden Anforderungen, die nicht in BizTalk Server veröffentlicht wurden. Beachten Sie, dass Antwortnachrichten in der Regel nicht an einen Empfangsadapter übermittelt werden, nachdem "Beenden" aufgerufen wurde. Im Allgemeinen akzeptiert die Messaging-Engine, nachdem der Adapter die Terminate-Methode aufgerufen hat, keine Anforderungen zum Veröffentlichen neuer Nachrichten, mit Ausnahme von Antwortnachrichten für Solicit-Antwort-Paare.

Hinweis

Ein Prozess kann nur einen Adapter, jedoch verschiedene Instanzen isolierter Adapter hosten.

Weitere Informationen

Adaptervariablen
Entwickeln eines Empfangsadapters
Instanziieren und Initialisieren eines Empfangsadapters
Schnittstellen für einen In-Process-Empfangsadapter
Schnittstellen für einen Empfangsadapter mit Batchunterstützung
Schnittstellen für einen transaktionalen Empfangsadapter mit Batchunterstützung
Schnittstellen für einen synchronen Empfangsadapter für Anforderungsantworten