Muster 'Service Facade to Microsoft .NET: request-response'

Verwenden Sie das Muster Microsoft .NET request-response, um eine für die Microsoft .NET-Plattform geschriebene Anwendung mit WebSphere Message Broker zu integrieren. Sie können das Muster verwenden, um eine .NET-Klasse durch Verwendung von WebSphere Message Broker als Web-Service verfügbar zu machen.

Ein Diagramm, das das Verhalten des Musters zeigt. Anfordernde Anwendungen senden Web-Service-Anforderungen an den Broker. Das Muster übergibt die Anforderungen an eine .NET-Klasse und gibt die Antwort anschließend als Web-Service-Antwortnachricht von der Klasse an die anfordernden Anwendungen zurück.

Lösung

Eine Instanz des Musters Microsoft .NET request-response ist mit einer Klasse konfiguriert, die in einer der Programmiersprachen geschrieben ist, die von der Microsoft .NET-Plattform unterstützt wird, z. B. C# oder VB.NET. Die Musterinstanz generiert Nachrichtenflüsse, die eine Web-Service-Fassade auf die .NET-Klasse implementieren. Der Benutzer eines Musters kann aus ihrer .NET-Assembly eine Klasse auswählen, um sie als Web-Service zu aktivieren. Der Benutzer eines Musters kann auch die statischen Methoden der Klasse zur Verwendung auswählen.

Wenn eine anfordernde Anwendung den Web-Service aufruft, rufen die von der Musterinstanz generierten Nachrichtenflüsse eine statische Methode für die .NET-Klasse auf. Der generierte Web-Service implementiert eine WSDL-Operation für jede statische Methode für die .NET-Klasse.

Daten von einer anfordernden Anwendung in einer Web-Service-Anforderungsnachricht werden als Eingabeparameter an die .NET-Klasse übergeben. Ausgabe-, Referenz- und Rückgabewertparameter der .NET-Klasse werden zu der anfordernden Anwendung in der Web-Services-Antwortnachricht zurückgegeben.

Generierte Web-Services

Die Musterinstanz generiert Nachrichtenflüsse, die einen Web-Service implementieren. Die Musterinstanz generiert auch eine WSDL mit mehreren Dateien, die die Web-Services-Schnittstelle zwischen einer anfordernden Anwendung und WebSphere Message Broker repräsentiert.

Die von der Musterinstanz generierten WSDL-Dateien konfigurieren den SOAP-Eingabeknoten in den generierten Nachrichtenflüssen. Die WSDL-Dateien können auch von anfordernden Anwendungen verwendet werden, um sicherzustellen, dass SOAP-Anforderungen im korrekten Format gesendet und empfangen werden.

Die WSDL-Dateien sind eine WS-I-kompatible Web-Service-Beschreibung. Die erste WSDL-Datei enthält eine WSDL-Port-Typendefinition und eine Operation für jede statische Methode, die in der .NET-Klasse ausgewählt wurde. Jede Operation verfügt über eine Eingabenachricht und eine Ausgabenachricht. Die zweite WSDL-Datei enthält einen SOAP-Service und Portdefinitionen. Die SOAP-Adresse des Web-Service ist als Musterparameter konfiguriert. Die Musterinstanz generiert auch eine XML-Schemadatei. Das XML-Schema repräsentiert die Datentypen für alle Eingabe- und Ausgabeparameter für jede WSDL-Operation. Die Schemadatei ist in der WSDL-Datei enthalten, die die Standard-WSDL-Anweisung include verwendet.

Web-Services implementieren

Sowohl WSDL als auch das Schema müssen in Message Broker zusammen mit den generierten Nachrichtenflüssen implementiert sein. In WebSphere Message Broker Version 8.0 müssen Sie die WSDL-Datei und die XML-Schemadatei nicht in einen Nachrichtensatz importieren, bevor Sie sie in einem Broker implementieren.

Einschränkungen bei der Verwendung des Musters
Erforderliche Tasks vor der Anwendung des Musters
Parameter für das Muster
Erforderliche Tasks nach der Generierung des Musters