HTTP-Adapter (BizTalk Server-Beispiel)
Das HTTP-Adapterbeispiel veranschaulicht, wie die in BizTalk Server verwendeten Kommunikationsparadigma für Anforderung/Antwort und "Solicit/Response" implementiert werden.
Speicherort dieses Beispiels
<Beispielpfad>\AdaptersDevelopment\HttpAdapter\
In der folgenden Tabelle werden die Dateien in diesem Beispiel samt Zweck beschrieben.
| Datei(en) | BESCHREIBUNG |
|---|---|
| \Design-Time\Adapter Management | Enthält das Projekt, mit dem der Entwurfszeitteil dieses Adapters implementiert wird. |
| \Laufzeit\HttpReceive | Enthält das Projekt, mit dem das Kommunikationsmuster für den Adapter Anforderungsantwort implementiert wird. Dies ist ein isolierter Empfänger. |
| \Run-Time\HttpReceive | Enthält das Projekt, mit dem das Kommunikationsmuster für den Adapter Antwort anfragen implementiert wird. |
Verwenden dieses Beispiels
Dieses Beispiel ist als eine Grundstruktur zur Entwicklung benutzerdefinierter Adapter gedacht. In einigen Fällen muss BizTalk Server möglicherweise Nachrichten an eine bestimmte benutzerdefinierte Anwendung übermitteln oder ein Protokoll verwenden, für das kein systemeigener Adapter vorhanden ist. Es gibt Adapter von Drittanbietern, die weitere Protokolle unterstützen. Möglicherweise möchten Sie feststellen, ob es bereits einen Adapter für Ihr Protokoll gibt, bevor Sie einen benutzerdefinierten Adapter entwickeln. Sie können einen eigenen benutzerdefinierten Adapter entwickeln, wenn Sie keinen Adapter finden, der Ihren Kommunikationsbedürfnissen entspricht.
Die Entwicklung eines benutzerdefinierten Adapters kann viele Herausforderungen beinhalten. Zur Vereinfachung dieses Vorgangs hat Microsoft ein Basisframework entwickelt: das Adapterframework. Sie können dieses Framework sowie die Beispielquellcodes für Adapter im BizTalk Server SDK als Basis für eigene Entwicklungen verwenden. Weitere Informationen zu benutzerdefinierten Adaptern und dem Adapterframework finden Sie im Abschnitt Siehe auch am Ende dieses Dokuments.
Erstellen und Initialisieren des Beispieladapters
Wichtig
Wenn die BizTalk-Installation eine 64-Bit-Installation ist oder der Speicherort der Installation geändert wurde, müssen OutboundAssemblyPath, InboundAssemblyPath und AdapterMgmtAssemblyPath entsprechend geändert werden.
So erstellen und initialisieren Sie den HTTP-Beispieladapter
Navigieren Sie in einem Befehlsfenster zum folgenden Ordner:
<Beispielpfad>\AdaptersDevelopment\HttpAdapter
Führen Sie die Datei "Setup.bat" aus, von der folgende Aktionen ausgeführt werden:
Kompilieren des HTTP-Adapters und all seiner Abhängigkeiten
Erstellen einer Anwendung für Internetinformationsdienste (IIS), die von der Empfängerseite des Adapters verwendet wird
In IIS 7.0 müssen Sie sicherstellen, dass die Identität des Anwendungspools, in dem diese IIS-Anwendung ausgeführt wird, Mitglied der folgenden Gruppen ist:
Gruppe Benutzer isolierter BizTalk-Hosts
Gruppe IIS_WPG
Unter IIS 7.0 müssen Sie die Anwendung migrieren, um mit dem integrierten .NET-Modus zu arbeiten. Sie können die Anwendungskonfiguration, einschließlich des Inhalts des <Abschnitts httpHandlers-Konfiguration, migrieren, indem Sie folgendes aus einem Befehlszeilenfenster> verwenden (das Fenster muss als Administrator ausgeführt werden):
%systemroot%\system32\inetsrv\APPCMD.EXE migrate config "Default Web Site/HttpReceive"Nach der Migration der Anwendung kann sie im klassischen .NET-Modus, im integrierten .NET-Modus sowie auf Vorgängerversionsplattformen ausgeführt werden.
Hinweis
Sie sollten sicherstellen, dass während des Erstellungs- und Initialisierungsprozesses keine Fehler gemeldet wurden, bevor Sie dieses Beispiel ausführen.
Hinweis
Wenn Sie die Projekte in diesem Beispiel öffnen und erstellen möchten, ohne die Datei Setup.bat auszuführen, müssen Sie zunächst ein Schlüsselpaar für starke Namen mit dem entsprechenden .NET Framework-Hilfsprogramm (sn.exe) erstellen. Verwenden Sie dieses Schlüsselpaar zum Signieren der resultierenden Assemblys.
Hinweis
Wenn Sie von "Setup.bat" vorgenommene Änderungen rückgängig machen möchten, führen Sie "Cleanup.bat" aus. "Cleanup.bat" müssen Sie ausführen, bevor "Setup.bat" ein zweites Mal ausgeführt wird.
Registrieren des Beispieladapters
So registrieren Sie den HTTP-Beispieladapter
Navigieren Sie in Windows Explorer zum Installationslaufwerk für BizTalk Server, und navigieren Sie dann zu <Samples Path>\AdaptersDevelopment\HTTPAdapter.
Doppelklicken Sie zum Hinzufügen des Beispieladapters zur Registrierung auf HTTP. NET.reg.
Hinweis
HTTP. NET.reg enthält hartcodierte Pfade zum BizTalk Server Installationsverzeichnis. Wenn Sie BizTalk Server nicht am Standardspeicherort installiert haben oder ihre BizTalk Server Installation von einer früheren Version von BizTalk Server aktualisiert haben, müssen Sie die HTTP-Datei ändern. NET.reg mit den entsprechenden Pfaden. Aktualisieren Sie die Pfade für die Werte OutboundAssemblyPath und AdapterMgmtAssemblyPath so, dass Sie auf die richtige Speicherposition der angegebenen Dateien verweisen.
Wichtig
Wenn Sie BizTalk auf einem 64-Bit-Computer installieren, ändern Sie alle Instanzen des HKEY_CLASSES_ROOT\CLSID\ Registrierungseintrags in HKEY_CLASSES_ROOT\Wow6432Node\CLSID\ im HTTP. NET.reg-Registrierungsdatei .
Klicken Sie im Dialogfeld Registrierungs-Editor auf Ja , um den Beispieladapter zur Registrierung hinzuzufügen, und klicken Sie dann auf OK.
Klicken Sie zum Schließen von Windows Explorer im Menü Datei auf Schließen.
Installieren des Beispieladapters
So installieren Sie den HTTP-Beispieladapter
Klicken Sie auf das Menü Start, wählen Sie Alle Programme, Microsoft BizTalk Server 20xx und dann BizTalk Server Verwaltung aus.
Erweitern Sie in der BizTalk Server Verwaltungskonsole die Struktur BizTalk Server Verwaltung, erweitern Sie dann die BizTalk-Gruppenstruktur, und erweitern Sie dann die Struktur Plattformeinstellungen.
Klicken Sie mit der rechten Maustaste auf Adapter, klicken Sie auf Neu, und klicken Sie dann auf Adapter.
Gehen Sie im Dialogfeld Adaptereigenschaften wie folgt vor.
Option Aufgabe Name Geben Sie HTTP.NET ein. Adapter Wählen Sie in der Dropdownliste HTTP.NET aus. BESCHREIBUNG Geben Sie Beispiel HTTP.NET Adapter ein. Klicken Sie auf OK.
Der Adapter wird nun in der Liste der Adapter im rechten Fenster der BizTalk-Verwaltungskonsole angezeigt.
Beenden und erneutes Starten der Hostinstanz
So beenden Sie die Hostinstanz für den HTTP-Beispieladapter und starten diese erneut
Klicken Sie auf das Menü Start, wählen Sie Alle Programme, Microsoft BizTalk Server 20xx und BizTalk Server Verwaltung aus.
Erweitern Sie in der BizTalk Server Verwaltungskonsole die Struktur BizTalk Server Administration, erweitern Sie dann Plattformeinstellungen, und klicken Sie auf Hostinstanzen.
Klicken Sie im Ergebnisbereich mit der rechten Maustaste auf den Host instance (in der Regel der Computername), und klicken Sie dann auf Beenden.
Die status des Hosts instance in Beendet geändert.
Klicken Sie im Ergebnisbereich mit der rechten Maustaste auf den Host instance, und klicken Sie dann auf Start.
Der HTTP.NET-Adapter kann nun von der Anwendung verwendet werden. Beim Konfigurieren des Adapters hat das Format für die Transporteigenschaft des virtuellen Verzeichnisses die Folgende: /httpreceive/httpreceive.aspx?optionalQueryString.
Kommentare
Der HTTP.NET-Adapter verwendet die BaseAdapter-Klassen, die unter <Samples Path>\AdaptersDevelopment\BaseAdapter\v1.0. bereitgestellt werden. 2\. Die Klassen im BaseAdapter-Projekt dienen zur schnelleren Adapterentwicklung. Genauere Informationen zu den bereitstehenden Klassen finden Sie in den Kommentaren im BaseAdapter-Code.
Weitere Informationen
Registrieren eines Adapters
Adapterbeispiele – Verwendung
Entwickeln von benutzerdefinierten Adaptern
Was ist das Adapterframework?
Verwenden von Adapterframework-Tools
Entwickeln eines Empfangsadapters
Entwickeln eines Sendeadapters
Bereitstellen eines benutzerdefinierten Adapters
Tipps zum Entwerfen Ihres Adapters
Konfiguration von Adaptern zur Entwurfszeit