Implementierung von B2B Web Services: Toms Anwendung

Zu Beginn der Einrichtung von Toms Service-Schicht wird unter dem ASP.NET-Hauptprojekt ein ws-Ordner erstellt, in dem die Web Services gespeichert werden. Dazu klickt man auf die Anwendung WSB2BTom und wählt Add | New Folder (Hinzufügen | Neuer Ordner), wobei der neue Ordner mit ws benannt wird. Durch Ablegen der Web Services in einem separaten Ordner wird es möglich, bestimmte Aspekte der in dem Ordner befindlichen Dateien mithilfe einer speziellen Web.config-Datei zu kontrollieren.

Nun klickt man mit der rechten Maustaste auf den Ordner ws und wählt Add | Add New Item (Hinzufügen | Neues Element hinzufügen). Als Dateityp für die neue Datei wählt man Web Configuration File. Standardmäßig wird die Datei als Web.config benannt. Man ersetzt den Inhalt dieser Datei durch das XML aus Listing C.

Durch das Entfernen dieser Protokolle werden die Web Services für den öffentlichen Zugriff unsichtbar. Anschließend muss der Web Service selbst hinzugefügt werden. Für Tom ist nur ein Web Service erforderlich. Dieser dient dazu, der Anwendung von John die Benachrichtigung von Toms Anwendung bezüglich abgeschlossener Bestellungen zu ermöglichen. Dazu klickt man mit der rechten Maustaste auf den ws-Ordner und wählt Add | Add Web Service (Hinzufügen | Web Service hinzufügen). Nun gibt man OrderWS.asmx als Dateinamen ein und kopiert den Inhalt aus Listing D in diesen neuen Web Service.

Für die Authentifizierung sorgt eine separate Support-Klasse, die den spezifischen SOAP-Header bearbeitet und feststellt, ob der Kunde gültig oder ungültig ist. Man klickt mit der rechten Maustaste auf den ws-Ordner und fügt eine neue Klasse namens WSUtil.vb hinzu. Dann kopiert man den Code aus Listing E in diese neue Klasse. Die Methode Authenticate() vergleicht den Sicherheits-Token im SOAP-Header mit dem in der Web.config-Datei der Haupt-Website gespeicherten Wert; im Falle einer Übereinstimmung gilt der Kunde als authentifiziert.

Es stehen zwei weitere Methoden zum einfachen Erstellen von Instanzen der für Johns Anwendung erforderlichen spezifischen SOAP-Header zur Verfügung. Um diese Methoden verwenden zu können, muss man die in Teil 4 dieser Artikelreihe aus Johns Anwendung generierten Proxy-Klassen hinzufügen. Listing F und Listing G enthalten den Code für die Klasse BookProxy.vb bzw. für die Klasse OrderProxy.vb. Diese Dateien muss man auf der Festplatte speichern, anschließend mit der rechten Maustaste auf das Projekt WSB2BTom klicken, Add | Add Existing Item (Hinzufügen | Vorhandenes Element hinzufügen) wählen und dann die beiden Proxy-Klassen zu dem Projekt hinzufügen.

Zum Schluss muss noch eine Proxy-Klasse für diesen neuen Web Service erstellt werden. Man kommentiert das Entfernen des Dokumentationsprotokolls in der Datei Web.config aus, kompiliert das Projekt und navigiert über einen Web-Browser zu der Web-Service-WSDL-Datei. Der Pfad dürfte ungefähr wie folgt aussehen:

http://localhost/wsb2btom/ws/OrderWS.asmx?wsdl

Man speichert die entstehende WSDL-Datei auf die Festplatte, öffnet eine Visual Studio .NET-Befehlseingabe und navigiert zum Speicherort der Datei. Zum Generieren der Proxy-Klasse ist der folgende Befehl einzugeben:

wsdl /l:VB /o:OrderWSProxy.vb OrderWS.wsdl