Freigeben über

Schritt 1: Verwenden des WCF-LOB-Assistenten zur Entwicklung von Adaptern, um ein Echo-Adapter-Projekt zu erstellen

  • Artikel

Schritt 1 von 9

Dauer: 15 Minuten

In diesem Schritt erstellen Sie ein Projekt mithilfe von Visual Studio und dem Adapterentwicklungs-Assistenten. Der Assistent für die Adapterentwicklung führt Sie durch die Schritte zur Entwicklung eines benutzerdefinierten Adapters für das System. Es sammelt Informationen zu Nachrichtenaustauschmustern, Metadatenfeatures, Adaptereigenschaften und Verbindungseigenschaften. Nachdem der Assistent erfolgreich abgeschlossen wurde, generiert er eine Reihe von Dateien.

Voraussetzungen

Sie müssen über die unter Before You Begin the Tutorial beschriebenen Kenntnisse verfügen und Ihren Computer erfolgreich für die Adapterentwicklung mithilfe des WCF LOB Adapter SDK eingerichtet haben.

Auswählen des WCF LOB-Adapter-Plug-Ins in Visual Studio

  1. Starten Sie Visual Studio, zeigen Sie dann im Menü Datei auf Neu, und klicken Sie dann auf Projekt.

  2. Führen Sie im Dialogfeld Neues Projekt folgende Schritte aus:

    Option Aufgabe
    Projekttypen Klicken Sie auf Visual C#.
    Vorlagen Klicken Sie auf WCF LOB-Adapter.
    Name Geben Sie EchoAdapter ein.
    Location Geben Sie C:\Tutorials ein.
    Erstellen eines Verzeichnisses für die Projektmappe Aktivieren Sie dieses Kontrollkästchen, um ein Verzeichnis für die Projektmappendateien zu erstellen.
    Projektmappenname Geben Sie EchoAdapterSampleV2 ein.

    Die folgende Abbildung zeigt das Dialogfeld Neues Projekt .

    Screenshot: Dialogfeld

  3. Klicken Sie auf OK.

  4. Klicken Sie auf der Seite Willkommenauf Weiter. Die folgende Abbildung zeigt die Willkommensseite .

    Screenshot: Willkommensseite

  5. Klicken Sie auf Weiter.

Geben Sie die Schema- und Namespaceinformationen ein.

  1. Gehen Sie auf der Seite Schema-, Namespace- und URI-Informationen wie folgt vor:

    Option Aufgabe
    Schema Geben Sie echov2 ein.
    Project-Namespace Geben Sie Microsoft.Adapters.Samples.EchoV2 ein.

    Die folgende Abbildung zeigt die Seite Schema, Namespace und URI-Informationen .

    Screenshot: Seite "

  2. Klicken Sie auf Weiter.

Eingeben der Datenfluss- und Metadatenfeatures

  1. Gehen Sie auf der Seite Datenflüsse und Metadatenfeatures wie folgt vor:

    Nachrichtenaustauschmuster

    Option Aufgabe
    Synchroner ausgehender Datenverkehr Aktivieren Sie das Kontrollkästchen.
    Synchroner eingehender Datenverkehr Aktivieren Sie das Kontrollkästchen.

    Metadatenfeatures

    Option Aufgabe
    Abruf Aktivieren Sie das Kontrollkästchen.
    Durchsuchen Aktivieren Sie das Kontrollkästchen.
    Suchen, Aktivieren Sie das Kontrollkästchen.

    Hinweis

    Datenflüsse sind in diesem Kontext identisch mit Nachrichtenaustauschmustern, der Begriff, der in den konzeptionellen Themen verwendet wird.

    Die folgende Abbildung zeigt die Seite Datenflüsse und Metadatenfeatures .

    Screenshot: Seite

  2. Klicken Sie auf Weiter.

Geben Sie die Adaptereigenschaften ein.

  1. Gehen Sie auf der Seite Adaptereigenschaften wie folgt vor:

  2. Fügen Sie eine Eigenschaft mit dem Namen Count hinzu. Diese Nummer wird von jedem Vorgang des Echoadapters verwendet. Jeder Vorgang gibt den Eingabewert count number of times zurück.

    Option Aufgabe
    Eigenschaftenname Geben Sie Count ein.
    Datentyp Wählen Sie System.Int32 aus.
    Standardwert Geben Sie 5 ein.
    Add (Hinzufügen) Klicken Sie auf diese Option, um die neue Adaptereigenschaft hinzuzufügen.

  3. Fügen Sie eine Eigenschaft namens EnableConnectionPooling hinzu. Dieses Flag wird vom WCF LOB Adapter SDK verwendet, um das Laufzeitverbindungspooling zu aktivieren oder zu deaktivieren.

    Option Aufgabe
    Eigenschaftenname Geben Sie EnableConnectionPooling ein.
    Datentyp Wählen Sie System.Boolean aus.
    Standardwert Geben Sie true ein.
    Add (Hinzufügen) Klicken Sie auf diese Option, um die neue Adaptereigenschaft hinzuzufügen.

  4. Fügen Sie eine Eigenschaft mit dem Namen InboundFileFilter hinzu. Diese Eigenschaft wird vom FileSystemWatcher verwendet, um Dateien dieser Erweiterung zu überwachen. Diese Eigenschaft gilt nur für das eingehende Szenario.

    Option Aufgabe
    Eigenschaftenname Geben Sie InboundFileFilter ein.
    Datentyp Wählen Sie System.String aus.
    Standardwert Geben Sie *.txtein.
    Add (Hinzufügen) Klicken Sie auf diese Option, um die neue Adaptereigenschaft hinzuzufügen.

  5. Fügen Sie eine Eigenschaft namens InboundFileSystemWatcherFolder hinzu. Diese Eigenschaft wird verwendet, um den Ordner festzulegen, in dem die Dateien gelöscht werden, damit FileSystemWatcher eine Benachrichtigung an den Adapter auslösen kann. Diese Eigenschaft gilt nur für das eingehende Szenario.

    Option Aufgabe
    Eigenschaftenname Geben Sie InboundFileSystemWatcherFolder Ein.
    Datentyp Wählen Sie System.String aus.
    Standardwert Geben Sie C:\\inbound\\watcher ein.
    Add (Hinzufügen) Klicken Sie auf diese Option, um die neue Adaptereigenschaft hinzuzufügen.

    Die folgende Abbildung zeigt die Seite Adaptereigenschaften .

    Screenshot: Seite "

  6. Klicken Sie auf Weiter.

Geben Sie die Verbindungseigenschaften ein.

  1. Gehen Sie auf der Seite Verbindungseigenschaften wie folgt vor:

  2. Fügen Sie eine Eigenschaft namens Application hinzu. Diese Eigenschaft dient nur zur Veranschaulichung. Der Echoadapter umfasst kein LOB-System.

    Option Aufgabe
    Eigenschaftenname Geben Sie Anwendung ein.
    Datentyp Wählen Sie System.String aus.
    Standardwert Geben Sie lobapplication ein.
    Add (Hinzufügen) Klicken Sie auf diese Option, um die neue Adaptereigenschaft hinzuzufügen.

  3. Fügen Sie eine Eigenschaft namens EnableAuthentication hinzu. Bei trueerwartet der Adapter einen Wert im Feld "Benutzername" innerhalb der Clientanmeldeinformationen.

    Option Aufgabe
    Eigenschaftenname Geben Sie EnableAuthentication ein.
    Datentyp Wählen Sie System.Boolean aus.
    Standardwert Geben Sie false ein.
    Add (Hinzufügen) Klicken Sie auf diese Option, um die neue Adaptereigenschaft hinzuzufügen.

  4. Fügen Sie eine Eigenschaft namens HostName hinzu. Diese Eigenschaft dient nur zur Veranschaulichung, ähnlich der Eigenschaft Application.

    Option Aufgabe
    Eigenschaftenname Geben Sie Hostname ein.
    Datentyp Wählen Sie System.String aus.
    Standardwert Geben Sie lobhostname ein.
    Add (Hinzufügen) Klicken Sie auf diese Option, um die neue Adaptereigenschaft hinzuzufügen.

  5. Fügen Sie eine Eigenschaft namens EchoInUpperCase hinzu. Diese Eigenschaft steuert, ob einige Vorgänge wiederholte Zeichenfolgen in Großbuchstaben konvertieren oder im ursprünglichen Format belassen.

    Option Aufgabe
    Eigenschaftenname Geben Sie EchoInUpperCase ein.
    Datentyp Wählen Sie System.Boolean aus.
    Standardwert Geben Sie False ein.
    Add (Hinzufügen) Klicken Sie auf diese Option, um die neue Adaptereigenschaft hinzuzufügen.

  6. Klicken Sie auf Weiter.

Beenden des Assistenten

  1. Klicken Sie auf der Seite Zusammenfassung auf Fertig stellen. Die folgende Abbildung zeigt Projektmappen-Explorer mit dem EchoAdapter-Projekt.

    Screenshot: Projektmappen-Explorer mit dem EchoAdapter-Projekt

    Ihr Projekt sollte die gleichen Dateien enthalten. Wenn dies nicht der Fall ist, beenden Sie Visual Studio, löschen Sie den Ordner EchoAdapterSampleV2 , und starten Sie diesen Schritt des Tutorials neu.

  2. Klicken Sie in Visual Studio im Menü Datei auf Alle speichern.

    Hinweis

    Sie haben Ihre Arbeit gespeichert. Sie können Visual Studio zu diesem Zeitpunkt sicher schließen oder mit dem nächsten Schritt fortfahren, Schritt 2: Kategorisieren der Adapter- und Verbindungseigenschaften.

Was habe ich gerade getan?

In diesem Schritt haben Sie die Echoadapterlösung mithilfe von Visual Studio und dem Adapterentwicklungs-Assistenten erstellt. Die folgende Tabelle enthält den Satz von Dateien und den Zweck der einzelnen Dateien.

Dateiname Beschreibung
EchoAdapter.cs Dies ist die Standard Adapterklasse, die von Microsoft.ServiceModel.Channels.Common.Adaptererbt.

Für den Echoadapter sind keine Änderungen erforderlich.
EchoAdapterBinding.cs Dies ist die Klasse, die beim Erstellen einer Bindung für einen Adapter verwendet wird.

Für den Echoadapter sind keine Änderungen erforderlich.
EchoAdapterBindingCollectionElement.cs Dies ist die Binding Collection Element-Klasse, die implementiert System.ServiceModel.Configuration.StandardBindingCollectionElement.

Für den Echoadapter sind keine Änderungen erforderlich.
EchoAdapterBindingElement.cs Dadurch wird eine Basisklasse für die Konfigurationselemente bereitgestellt.

Um die Adapter- und Verbindungseigenschaften des Echoadapters zu kategorisieren, führen Sie Schritt 2: Kategorisieren der Adapter- und Verbindungseigenschaften aus.
EchoAdapterBindingElementExtensionElement.cs Diese Klasse wird bereitgestellt, um den Adapter als Bindungselement darzustellen, sodass er innerhalb einer benutzerdefinierten WCF-Bindung verwendet werden kann.

Um die Adapter- und Verbindungseigenschaften des Echoadapters zu kategorisieren, führen Sie Schritt 2: Kategorisieren der Adapter- und Verbindungseigenschaften aus.
EchoAdapterHandlerBase.cs Dies ist die Basisklasse für Handler, die verwendet werden, um allgemeine Eigenschaften/Hilfsfunktionen zu speichern, die von Ihrer Basisklasse verfügbar gemacht werden.

Um die Adapter- und Verbindungseigenschaften des Echoadapters zu kategorisieren, führen Sie Schritt 2: Kategorisieren der Adapter- und Verbindungseigenschaften aus.
EchoAdapterConnection.cs Dadurch wird die Verbindung mit dem Zielsystem definiert.

Um die Verbindung des Echoadapters mit dem Zielsystem zu unterstützen, führen Sie Schritt 3: Implementieren der Verbindung für den Echoadapter aus.
EchoAdapterConnectionFactory.cs Dadurch wird die Verbindungsfactory für das Zielsystem definiert.

Um die Verbindung des Echoadapters mit dem Zielsystem zu unterstützen, führen Sie Schritt 3: Implementieren der Verbindung für den Echoadapter aus.
EchoAdapterConnectionUri.cs Dies ist die Klasse für die Darstellung eines Adapterverbindungs-URI.

Um die Verbindung des Echoadapters mit dem Zielsystem zu unterstützen, führen Sie Schritt 3: Implementieren der Verbindung für den Echoadapter aus.
EchoAdapterMetadataBrowseHandler.cs Diese Klasse wird beim Ausführen einer verbindungsbasierten Suche nach Metadaten aus dem Zielsystem verwendet.

Um die Metadatensuchefunktion für den Echoadapter zu unterstützen, führen Sie Schritt 4: Implementieren des Metadatensuchhandlers für den Echoadapter aus.
EchoAdapterMetadataSearchHandler.cs Diese Klasse wird zum Ausführen einer verbindungsbasierten Suche nach Metadaten aus dem Zielsystem verwendet.

Um die Metadatensuchefunktion für den Echoadapter zu unterstützen, führen Sie Schritt 5: Implementieren des Metadatensuchhandlers für den Echoadapter aus.
EchoAdapterMetadataResolve.cs Diese Klasse wird zum Ausführen eines verbindungsbasierten Abrufs von Metadaten aus dem Zielsystem verwendet.

Um die Metadatenauflösungsfunktion für den Echoadapter zu unterstützen, führen Sie Schritt 6: Implementieren des Metadatenlösehandlers für den Echoadapter aus.
EchoAdapterOutboundHandler.cs Diese Klasse wird zum Senden von Daten an das Zielsystem verwendet.

Um den ausgehenden Nachrichtenaustausch für den Echoadapter zu unterstützen, führen Sie Schritt 7: Implementieren des synchronen ausgehenden Handlers für den Echoadapter aus.
EchoAdapterInboundHandler.cs Diese Klasse implementiert eine Schnittstelle zum Lauschen oder Abrufen von Daten.

Um den eingehenden Nachrichtenaustausch für den Echoadapter zu unterstützen, führen Sie Schritt 8: Implementieren des synchronen eingehenden Handlers für den Echoadapter aus.
EchoAdapterTrace.cs Diese Klasse implementiert die Adapterablaufverfolgung für das Debuggen und die Problembehandlung.

Nächste Schritte

Sie kategorisieren Adapter- und Verbindungseigenschaften für die logische Gruppierung der Benutzeroberfläche und implementieren dann Verbindungs-, Metadatensuche-, Such- und Auflösungsfunktionen sowie den ausgehenden und eingehenden Nachrichtenaustausch. Schließlich erstellen Sie den Echoadapter und stellen sie bereit.

Weitere Informationen

Schritt 2: Kategorisieren der Adapter- und Verbindungseigenschaften
Tutorial 1: Entwickeln des Echo-Adapters