Exemplarische Vorgehensweise: Erstellen von austauschbaren Webdiensten

Aktualisiert: November 2007

In dieser exemplarischen Vorgehensweise wird gezeigt, wie Sie einen Webdiensts duplizieren können, den Sie zuvor erstellt haben und als Ersatz verwenden möchten. Diese Anwendung wurde in Exemplarische Vorgehensweise: Entwerfen eines Webdiensts implementiert.

Vorbereitungsmaßnahmen

Führen Sie die Schritte in Exemplarische Vorgehensweise: Entwerfen eines Webdiensts aus.

So erstellen Sie eine Kopie eines vorhandenen Webdiensts

  1. Öffnen Sie Catalog.sln.

  2. Zeigen Sie das Anwendungsdiagramm an.

  3. Klicken Sie mit der rechten Maustaste auf die Anwendung Catalog, und klicken Sie auf Kopieren.

  4. Fügen Sie die kopierte Anwendung in das Anwendungsdiagramm ein.

  5. Nennen Sie die eingefügte Version CatalogFacade.

    CatalogFacade schließt dieselben CatalogWebService-Endpunkte und GetLegacyInfo-Endpunkte ein, die in Catalog angezeigt werden. Aus diesem Grund ist CatalogFacade kompatibel mit allen Anwendungen, die mit Catalog kompatibel sind. Alle Verbindungen von Catalog mit anderen Anwendungen, z. B. CatalogDB, werden beibehalten. Im Gegensatz zu Catalog wird CatalogFacade jedoch nicht implementiert angezeigt.

    Hinweis:

    Visual Studio kopiert keine bestimmten Einstellungen zwischen Anwendungen. Daher wird die Datenbankverbindung zwar grafisch beibehalten, aber diese Verbindung funktioniert zur Laufzeit nicht, da Visual Studio einige Elemente, wie das Kennwort, nicht kopiert. Um diese Verbindung zu aktivieren, müssen Sie die Informationen für die Verbindung zwischen CatalogFacade und CatalogDB eingeben.

Daher können Sie die Anwendung CatalogFacade als Wrapperwebdienst für einen in einer Legacyanwendung implementierten Legacykatalog verwenden, die nicht durch die Designer für verteilte Systeme modelliert wird. Sie können solche Legacyanwendungen auch mit dem Anwendungstyp Generisch im Anwendungsdiagramm darstellen. Eine solche Anwendung könnte z. B. ein Hauptbuchsystem sein, das auf einem AS/400-Computer ausgeführt wird.

Sie modellieren jetzt eine Legacyanwendung mit dem Anwendungstyp Generisch.

So erstellen Sie ein Modell einer Legacyanwendung

  1. Ziehen Sie aus der Toolbox eine GenericApplication-Anwendung ins Diagramm, und nennen Sie sie LegacyCatalog.

  2. Ziehen Sie aus der Toolbox einen .NETWebServiceEndpoint-Endpunkt in CatalogFacade, und nennen Sie ihn LegacyInterface.

  3. Ziehen Sie bei gedrückter ALT-Taste den LegacyInterface-Endpunkt auf LegacyCatalog, um beide zu verbinden.

    In LegacyCatalog wird ein neuer Consumerendpunkt angezeigt. LegacyCatalog ist ein Anwendungsplatzhalter für den alten Katalog. Visual Studio generiert keinen Code für LegacyCatalog. Der Platzhalter im Diagramm zeigt jedoch das Vorhandensein der Legacyanwendung und ihre Verbindung zum CatalogFacade-Webdienst, der als Wrapper ihrer Funktionalität fungiert. Im nächsten Verfahren wird veranschaulicht, wie CatalogFacade und Catalog den gleichen Vertrag bereitstellen.

So entwerfen Sie ein Katalogsystem

  1. Klicken Sie bei gedrückter UMSCHALTTASTE auf Catalog und auf CatalogDB.

  2. Wählen Sie im Menü Diagramm die Option Anwendungssystem entwerfen aus.

  3. Das Dialogfeld Anwendungssystem entwerfen wird angezeigt.

  4. Geben Sie unter Systemname den Namen NewCatalogSystem ein.

    Der System-Designer wird geöffnet, in dem das neue System die ausgewählten Anwendungen enthält. Ändern Sie ggf. den Speicherort der Anwendungen.

  5. Klicken Sie mit der rechten Maustaste auf den CatalogWebService-Endpunkt, und wählen Sie Proxyendpunkt hinzufügen aus.

    Hierdurch wird ein Kommunikationsweg für die eingehende Kommunikation dieses Systems erstellt.

  6. Zeigen Sie das Anwendungsdiagramm an.

  7. Klicken Sie mit der rechten Maustaste auf SalesWebClient, und klicken Sie auf Anwendungssystem entwerfen.

  8. Nennen Sie das System CatalogSystem.

  9. Ziehen Sie NewCatalogSystem aus dem Fenster Systemansicht in CatalogSystem.

    Beachten Sie, dass NewCatalogSystem einen Endpunkt verfügbar macht, damit Sie das System verbinden können. Dieser Endpunkt ist der Proxyendpunkt, den Sie zuvor erstellt haben. Er stellt die Konnektivität mit CatalogWebService in Catalog bereit.

  10. Verbinden Sie den CatalogWebService-Proxyendpunkt in NewCatalogSystem mit dem Consumerendpunkt in SalesWebClient.

  11. Zeigen Sie das Anwendungsdiagramm an.

  12. Erstellen Sie ein neues System, das CatalogFacade und LegacyCatalog enthält, und nennen Sie es LegacyCatalogSystem.

  13. Erstellen Sie einen Proxyendpunkt für CatalogWebService in LegacyCatalogSystem.

  14. Zeigen Sie das CatalogSystem-System an.

  15. Löschen Sie das NewCatalogSystem-System aus CatalogSystem.

  16. Ziehen Sie aus dem Fenster Systemansicht das LegacyCatalogSystem-System ins CatalogSystem-System.

  17. Verbinden Sie den CatalogWebService-Endpunkt im LegacyCatalogSystem-System mit dem Consumerendpunkt in SalesWebClient.

    Das NewCatalogSystem-System und das LegacyCatalogSystem-System enthalten jeweils den CatalogWebService-Endpunkt, den Sie als Proxyendpunkt verfügbar gemacht haben. Deshalb können Sie die Systeme in CatalogSystem gegenseitig ersetzen.

Sie erstellen nun einen wiederverwendbaren Prototyp einer Anwendung, der den CatalogWebService enthält und Visual C# als Standardsprache verwendet. Sie können der Toolbox diesen Prototyp hinzufügen.

So erstellen Sie einen wiederverwendbaren Prototyp

  1. Zeigen Sie das Anwendungsdiagramm an.

  2. Ziehen Sie aus der Toolbox einen ASP.NETWebService in das Diagramm.

  3. Kopieren Sie den CatalogWebService-Endpunkt aus Catalog, und fügen Sie ihn in die neue ASP.NET-Webdienstanwendung ein.

  4. Ändern Sie die Language-Eigenschaft für die neue Anwendung in Visual C#.

  5. Wählen Sie im Menü Diagramm die Option Zur Toolbox hinzufügen aus.

    Das Dialogfeld Zur Toolbox hinzufügen wird angezeigt.

  6. Geben Sie im Feld Name den Namen CatalogWebServiceApp ein, und klicken Sie auf OK.

    Das Dialogfeld Datei speichern wird angezeigt. Visual Studio speichert die Datei als ADPROTOTYPE-Datei, die im Anwendungs-Designer verwendete Anwendungsprototypdatei.

  7. Klicken Sie auf Speichern.

  8. Öffnen Sie die Toolbox, und ziehen Sie CatalogWebServiceApp in das Diagramm.

Sie haben eine wiederverwendbare und angepasste Version der ASP.NET-Webdienstanwendung erstellt, die auch den CatalogWebService-Endpunkt enthält. Dieser Prototyp wird in der Toolbox immer dann angezeigt, wenn Sie eine neue Projektmappe für verteilte Systeme erstellen.

Sie können diesen Prototyp für andere Benutzer des Designers für verteilte Systeme freigeben, indem Sie ihn an einen freigegebenen Speicherort exportieren. Weitere Informationen finden Sie unter den folgenden Themen:

Nächste Schritte

Exemplarische Vorgehensweise: Darstellen von indirekten Webdienstverbindungen

Siehe auch

Weitere Ressourcen

Exemplarische Vorgehensweisen zum Entwerfen von Webdiensten