Sie können Nachrichtenflüsse mithilfe von WSDLs konfigurieren.
Nachrichtenflüsse, die mit Web-Services zusammenarbeiten, verwenden gewöhnlich SOAP-Knoten. Im Abschnitt WebSphere Message Broker und Web-Services finden Sie ausführliche Informationen zu den SOAP-Knoten.
Im WSDL-Modus werden die SOAP-Knoten mithilfe einer WSDL-Datei konfiguriert, die zuvor in eine Anwendung oder Bibliothek importiert oder in einem Nachrichtensatz generiert. Diese WSDL-Datei können Sie auf einen SOAP-Knoten ziehen oder über die Eigenschaft Name der WSDL-Datei im Knoten angeben.
Sie können den Betriebsmodus der SOAP-Knoten ändern, sodass diese Knoten im Gateway-Modus arbeiten. Im Gateway-Modus ist keine WSDL-Datei für die Konfiguration der Knoten erforderlich, da sie generische Anforderungen/Antworten und unidirektionale SOAP-Nachrichten handhaben, die nicht an eine bestimmte WSDL-Datei gebunden sind. Nähere Informationen finden Sie unter Gateway-Betriebsmodus für SOAP-Knoten.
Wenn Sie eine WSDL-Datei auf einen Knoten ziehen, werden dessen Eigenschaften entsprechend den Eigenschaften im WSDL-Element address für die URI konfiguriert. Die Transporteigenschaften des SOAP-Knotens werden entsprechend der ersten aus der WSDL-Datei importierten Bindung festgelegt. Wenn nun die erste Bindung, die importiert wird, einen JMS-Transport beschreibt, werden die JMS-Transporteigenschaften übernommen; beschreibt sie einen HTTP-Transport, werden die HTTP-Eigenschaften übernommen. Bei Auswahl einer anderen importierten Bindung erfolgt die Angabe der Transporteigenschaften entsprechend. Der Porttyp (portType) variiert je nach ausgewähltem Transporttyp.
Die URI des WSDL-Elements address kann in zwei Formaten vorliegen: im W3C-Format oder im IBM® Format (veraltet). Das Format der WSDL-URI beeinflusst, nach welchen WSDL-Eigenschaftennamen der Parser sucht, um die Eigenschaften des SOAP-Knotens zu füllen. Beim Import einer IBM WSDL beispielsweise wird die Tabelle JNDI-Kontextparameter nicht gefüllt, da sie diese Eigenschaften im WSDL-Element 'address' für die URI nicht unterstützt. Diese Tabelle wird nur gefüllt, wenn die JNDI-Kontextparameter in einer W3C-WSDL vorhanden sind. Ausführliche Informationen hierzu finden Sie unter URI-Formate in WSDL für JMS.
Wenn Sie eine Servicedefinition bereitstellen, werden die Endpunkteigenschaften automatisch festgelegt, Sie können diese Eigenschaften jedoch auch manuell festlegen oder überschreiben.
Es besteht die Möglichkeit, WSDL-Definitionen in mehrere Dateien aufzuteilen. Die Anordnung sieht normalerweise folgendermaßen aus: Eine Servicedefinitionsdatei der höchsten Ebene importiert eine Bindungsdatei, die Bindungsdatei importiert eine Schnittstellendatei, und diese Schnittstellendatei importiert Schemadefinitionsdateien bzw. schließt diese ein.
Ein WSDL-Porttyp (portType, die logische WSDL-Schnittstelle) reicht alleine nicht für die Konfiguration eines SOAP-Knotens aus, sondern es ist eine bestimmte Bindung erforderlich, damit die SOAP-Nutzdaten während der Ausführungszeit klar strukturiert sind.
Eine Bindung definiert eine Verwendung - dies kann document (Dokument, die Standardeinstellung) oder rpc sein. Bei der Verwendung document werden die SOAP-Nutzdaten durch ein XML-Schemaelement in der WSDL beschrieben. Bei der Verwendung rpc entsprechen die SOAP-Nutzdaten dem WSDL-Operationsnamen in einem festgelegten Namespace.
Um einen eigenen Nachrichtenfluss zu erstellen, müssen Sie die Knoten wie beschrieben konfigurieren. Sie können jedoch auch ein neues Nachrichtenflussgerüst erstellen, indem Sie eine WSDL-Definition in einen leeren Erstellungsbereich des Nachrichtenflusseditors ziehen und eine bestimmte WSDL-Bindung auswählen. Sie können auch die Art des Flusses (Serviceanbieter oder -konsument) und die Operationen wählen, die vom Fluss verarbeitet werden sollen.
Die wichtigsten Knoten und Eigenschaften im generierten Nachrichtenfluss werden konfiguriert; bevor der Nachrichtenfluss jedoch implementiert wird, müssen Sie noch selbst alle Knoten hinzufügen, die Sie benötigen. Im Abschnitt Verwendung des neuen Web-Service konfigurieren finden Sie ausführliche Informationen zur Konfiguration eines neuen Web-Service mithilfe des Assistenten.
Ein SOAPReply-Knoten wird immer in Verbindung mit einem SOAPInput-Knoten verwendet. Im Abschnitt Web-Service-Szenarios finden Sie ausführliche Informationen zu den Szenarios des Web-Service.
Ein SOAPAsyncResponse-Knoten wird immer in Verbindung mit einem SOAPAsyncRequest-Knoten verwendet - die Verknüpfung erfolgt über die Eigenschaft Eindeutige Kennung. Im Abschnitt Web-Service-Szenarios finden Sie Informationen zu den Verwendungsmustern für SOAP-Knoten.
Ein Web-Service-Client kann eine HTTP GET-Anforderung mit einer ?wsdl-Abfragezeichenfolge an einen Nachrichtenfluss senden, der Web-Services implementiert, und erhält eine WSDL-Darstellung, die zur Konfiguration des Empfangsknotens verwendet wurde, der den Endpunkt des Service bildet. Dies ist nur möglich für Empfangsknoten, die HTTP- bzw. JMS-Transport verwenden. Das Protokoll der HTTP GET-Anforderung muss mit dem Flussprotokoll übereinstimmen; wenn der Fluss also SSL verwendet, muss die HTTP GET-Anforderung mit https:// beginnen.
Der Client sendet zunächst eine einfache ?wsdl-Abfrage und ruft die vollständige WSDL-Definition ab, indem er eine Kette referenzierter Importe und Einschlüsse verfolgt. Wenn z. B. der Web-Service-Endpunkt http://localhost:7800/test1 ist, lautet die erste Client-Abfrage folgendermaßen:
GET http://localhost:7800/test1?wsdl
Diese Anfrage gibt die Service-WSDL-Definition der obersten Stufe zurück, die Importe für weitere Abschnitte der WSDL-Definition enthalten kann. Wenn die zurückgegebene WSDL z. B. die folgende Zeile enthält:
<wsdl:import ... location="http://localhost:7800/test1?wsdl=wsdl0"/>
sendet der Client eine entsprechende Anforderung, um diesen WSDL-Abschnitt abzurufen:
GET http://localhost:7800/test1?wsdl=wsdl0
Ein oder mehrere WSDL-Abschnitte können ebenfalls Importe für XML-Schemadaten enthalten, z. B.:
<xsd:import ... schemaLocation="http://localhost:7800/test1?xsd=xsd0"/>
Der Client sendet wiederum eine entsprechende Anforderung, um diese Daten abzurufen:
GET http://localhost:7800/test1?xsd=xsd0
Die zurückgegebene WSDL-Definition entspricht logisch der implementierbaren WSDL-Datei des Toolkits, wobei die Inline-Schemas extern bereitgestellt werden. Sie ist nicht unbedingt physisch identisch mit der ursprünglich importierten WSDL-Definition. Obwohl ein SOAPInput-Knoten mit einer bestimmten WSDL-Bindung konfiguriert ist, umfasst die zurückgegebene WSDL auch andere Bindungen, die nicht durch diesen Fluss verwendet werden, wenn sie Teil der ursprünglich importierten WSDL-Definition waren.