Generieren eines WCF-Clients oder eines WCF-Dienstvertrags für Oracle Database-Lösungsartefakte

Artikel
10/14/2023

Sie können das Visual Studio-Plug-In Adapterdienstverweis hinzufügen verwenden, um eine WCF-Clientklasse oder einen WCF-Dienstvertrag (Schnittstelle) für ausgewählte Vorgänge in Oracle-Datenbankartefakten zu generieren. Sie können auch das ServiceModel Metadata Utility Tool (svcutil.exe) verwenden, um die WCF-Clientklasse oder den WCF-Dienstvertrag zu generieren. Das Add Adapter Service Reference Plug-In macht jedoch die Funktionalität des ServiceModel Metadata Utility Tools über eine Standardmäßige Microsoft Windows-Schnittstelle verfügbar. Es bietet auch Such- und Suchfunktionen, die mit dem svcutil.exe-Tool nicht verfügbar sind, und generiert eine Konfigurationsdatei basierend auf den Bindungseigenschaften, die Sie beim Herstellen einer Verbindung mit der Oracle-Datenbank auswählen.

Generieren einer Clientklasse mithilfe des Add Adapter Service Reference Plug-In

Führen Sie die folgenden Schritte aus, um eine WCF-Clientklasse mithilfe des Adapterdienstverweis-Plug-Ins hinzufügen zu generieren.

So generieren Sie eine WCF-Clientklasse

Klicken Sie in Visual Studio Projektmappen-Explorer mit der rechten Maustaste auf Ihr Projekt, und klicken Sie dann auf Adapterdienstverweis hinzufügen.
Nachdem das Dialogfeld Adapterdienstverweis hinzufügen geöffnet wird, führen Sie die Schritte unter Abrufen von Metadaten für Oracle-Vorgänge in Visual Studio aus, um eine Verbindung mit der Oracle-Datenbank herzustellen und nach Vorgängen zu suchen. Um eine WCF-Clientklasse für die ausgewählten Vorgänge zu erstellen, stellen Sie sicher, dass Client (Ausgehende Vorgänge) in der Dropdownliste Vertragstyp auswählen ausgewählt ist (dies ist die Standardeinstellung).
Nachdem Sie alle Vorgänge ausgewählt haben, die Sie als Ziel verwenden möchten, klicken Sie auf OK , um die WCF-Clientklasse zu generieren.

Das Add Adapter Service Reference Plug-In fügt Ihrem Projekt zwei Dateien hinzu:

OracleDBBindingClient.cs. Diese Datei enthält die generierte WCF-Clientklasse und den Hilfscode für die ausgewählten Vorgänge.
App.config. Diese Datei enthält eine Bindungskonfiguration und Clientendpunktkonfigurationen. Diese Konfigurationen basieren auf den Auswahlmöglichkeiten, die Sie beim Konfigurieren der Bindung und Verbindung für das Add Adapter Service Reference Plug-In vorgenommen haben.

Wichtig

Wenn Sie beim Verwenden des Visual Studio-Plug-Ins Adapterdienstverweis hinzufügen keinen Wert für eine Bindungseigenschaft vom Typ Zeichenfolge angeben, deren Standardwert NULL ist, ist diese Bindungseigenschaft in der app.config-Datei nicht verfügbar. Sie müssen die Bindungseigenschaft und ihren Wert bei Bedarf manuell in der app.config-Datei hinzufügen.

Generieren eines WCF-Dienstvertrags mithilfe des Add Adapter Service Reference Plug-In

Der Adapter macht eingehende Vorgänge verfügbar, damit die Oracle-Datenbank Nachrichten an einen Adapterclient senden kann. Für solche Vorgänge müssen Sie einen WCF-Dienstvertrag generieren. Der Adapter macht beispielsweise einen eingehenden POLLINGSTMT-Vorgang verfügbar, um die Oracle-Datenbank abzufragen. Der Oracle Database-Adapter führt die abfrage aus, die durch die PollingStatement-Bindungseigenschaft angegeben ist, und sendet das Resultset in einer POLLINGSTMT-Nachricht an die verwendende Anwendung. In diesem Szenario fungiert die nutzende Anwendung als Dienst, und der Oracle Database-Adapter fungiert als Client. Sie müssen daher einen WCF-Dienst implementieren, der den POLLINGSTMT-Vorgang vom Adapter empfangen kann. Dazu verwenden Sie das Add Adapter Service Reference Plug-In, um eine .NET-Schnittstelle zu generieren, die den Dienstvertrag darstellt, der vom Adapter für den POLLINGSTMT-Vorgang angezeigt wird. Diese .NET-Schnittstelle wird auch als WCF-Dienstvertrag bezeichnet. Anschließend implementieren Sie diese Schnittstelle, um den WCF-Dienst zu erstellen, den Sie zum Empfangen des POLLINGSTMT-Vorgangs verwenden können.

Dieser Abschnitt enthält Informationen zum Generieren eines WCF-Dienstvertrags mithilfe des Add Adapter Service Reference Plug-In für eingehende Vorgänge, die vom Adapter verfügbar gemacht werden.

So generieren Sie einen WCF-Dienstvertrag für eingehende Vorgänge

Klicken Sie in Visual Studio Projektmappen-Explorer mit der rechten Maustaste auf Ihr Projekt, und klicken Sie dann auf Adapterdienstverweis hinzufügen.
Nachdem das Dialogfeld Adapterdienstverweis hinzufügen geöffnet wird, führen Sie die Schritte unter Abrufen von Metadaten für Oracle-Vorgänge in Visual Studio aus, um eine Verbindung mit der Oracle-Datenbank herzustellen. Es gibt mehrere Bindungseigenschaften und eine URI-Eigenschaft, die Sie möglicherweise festlegen möchten, wenn Sie für eingehende Vorgänge eine Verbindung mit der Oracle-Datenbank herstellen. Beispielsweise müssen Sie für den Eingehenden Abrufvorgang (POLLINGSTMT) die Bindungseigenschaft PollingStatement angeben, wenn Sie die Verbindung mit der Oracle-Datenbank konfigurieren. Der Oracle Database-Adapter verwendet die in dieser Eigenschaft angegebene SQL SELECT-Anweisung, um die Klasse zu generieren, die das vom POLLINGSTMT-Vorgang zurückgegebene Resultset darstellt.
Nachdem Sie eine Verbindung mit der Oracle-Datenbank hergestellt haben, wählen Sie in der Dropdownliste Vertragstyp auswählen die Option Dienst (Eingehende Vorgänge) aus.
Klicken Sie im Feld Kategorie auswählen auf den Stammknoten (/), und navigieren Sie zu dem Vorgang, für den Sie den Dienstvertrag generieren möchten. Wählen Sie beispielsweise für den Abrufvorgang im Feld Verfügbare Kategorien und Vorgängedie Option POLLINGSTMT aus, und klicken Sie dann auf Hinzufügen.
Klicken Sie auf OK, um den WCF-Dienstvertrag für den POLLINGSTMT-Vorgang zu generieren.

Das Add Adapter Service Reference Plug-In fügt Ihrem Projekt drei Dateien hinzu:

OracleDBBindingInterface.cs. Diese Datei enthält den generierten WCF-Dienstvertrag (Schnittstelle) und Hilfscode für den POLLINGSTMT-Vorgang.
OracleDBBindingService.cs. Diese Datei enthält eine Klasse, die die in OracleDBBindingInterface.cs definierte Schnittstelle implementiert. Sie können die Geschäftslogik implementieren, die die von der Abfrage zurückgegebenen Datensätze in der POLLINGSTMT-Methode in dieser Klasse verarbeitet.
App.config. Diese Datei enthält eine Bindungskonfiguration, Endpunktverhalten und Dienstendpunktkonfiguration, die auf den Auswahlen basieren, die Sie beim Konfigurieren der Bindung und Verbindung für das Add Adapter Service Reference Plug-In vorgenommen haben.

Wichtig

Wenn Sie beim Verwenden des Visual Studio-Plug-Ins Adapterdienstverweis hinzufügen keinen Wert für eine Bindungseigenschaft vom Typ Zeichenfolge angeben, deren Standardwert NULL ist, ist diese Bindungseigenschaft in der app.config-Datei nicht verfügbar. Sie müssen die Bindungseigenschaft und ihren Wert bei Bedarf manuell in der app.config-Datei hinzufügen.

Verwenden von svcutil.exe zum Generieren einer WCF-Clientklasse oder eines WCF-Dienstvertrags

Sie können svcutil.exe verwenden, um eine WCF-Clientklasse oder eine WCF-Dienstschnittstelle für Ihre Anwendung zu generieren. Sie müssen svcutil.exe für die Verwendung mit dem Oracle Database-Adapter konfigurieren. Weitere Informationen zum Konfigurieren und Verwenden von svcutil.exe mit dem Oracle Database-Adapter finden Sie unter Verwenden des ServiceModel-Metadatenhilfsprogramms mit dem BizTalk-Adapter für Oracle-Datenbank.

Svcutil.exe generiert die WCF-Clientklasse oder den WCF-Dienstvertrag in einer Ausgabedatei. Der Standarddateiname ist output.cs. Sie müssen diese Datei manuell in Ihr Visual Studio-Projekt einschließen.

Weitere Informationen

Entwickeln von Oracle-Datenbankanwendungen mithilfe des WCF-Dienstmodells
Ausführen von einfachen Einfüge-, Update-, Lösch- und Auswahlvorgängen in SQL mithilfe des WCF-Dienstmodells

Freigeben über