WSDL für die Konfiguration von Nachrichtenflüssen verwenden

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 mit der Web Services Description Language (WSDL) konfiguriert, die zuvor importiert oder in einer Nachrichtengruppe generiert wurde. Sie wird dann in der Workbench unter Implementierbare WSDL angezeigt. Sie können die WSDL auf einen SOAP-Knoten ziehen oder mit der Eigenschaft Name der WSDL-Datei auf dem Knoten angeben.

Sie können den Betriebsmodus der SOAP-Knoten so ändern, dass sie im Gateway-Modus agieren. Im Gateway-Modus ist keine WSDL-Datei für die Konfiguration der Knoten erforderlich, da sie generische Anforderungs-/Antwort- und unidirektionale SOAP-Nachrichten verarbeiten, 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 importieren, indem Sie sie auf einen SOAP-Knoten ziehen, werden die Knoteneigenschaften aus den Eigenschaften der WSDL-URI address konfiguriert. Die Transporteigenschaften des SOAP-Knotens werden entsprechend der ersten aus der WSDL-Datei importierten Bindung festgelegt. Wenn also die erste importierte Bindung einen JMS-Transport beschreibt, werden die JMS-Transporteigenschaften ausgefüllt; beschreibt die erste importierte Bindung einen HTTP-Transport, werden die HTTP-Transporteigenschaften ausgefüllt. 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. Die Tabelle JNDI-Kontextparameter wird zum Beispiel nicht gefüllt, wenn Sie eine IBM WSDL importieren, da das IBM Format diese Eigenschaften in der WSDL-URI "address" 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.

WSDL-Definitionen können optional in mehrere Dateien aufgeteilt werden. 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.

Wenn Sie Ihren eigenen Nachrichtenfluss erstellen möchten, konfigurieren Sie die Knoten wie beschrieben. Sie können jedoch auch einen neuen Gerüstnachrichtenfluss erstellen, indem Sie eine WSDL-Definition auf einen leeren Erstellungsbereich im Nachrichtenflusseditor 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, Sie müssen die Konfiguration jedoch vervollständigen und vor der Implementierung des Flusses weitere 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.

SOAP-Knoten konfigurieren

Die folgenden Knoten werden explizit durch WSDL konfiguriert:
Die folgenden Knoten werden implizit durch WSDL konfiguriert, da sie die WSDL-Konfiguration des Knotens übernehmen, mit dem sie paarweise verbunden sind:

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.

WSDL mit ?wsdl abfragen

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 Eingabeknotens verwendet wurde, der den Endpunkt des Service bildet. Dies ist nur möglich für Eingabeknoten, 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 Referenzen müssen die korrekte Semantik haben, um verfolgt werden zu können:
  • <wsdl:import>-Elemente müssen unmittelbar untergeordnete Elemente von wsdl:definition-Elementen sein
  • <xsd:import>- und <xsd:include>-Elemente müssen unmittelbar untergeordnete Kinder der xsd:schema-Elemente sein
Dabei ist wsdl eine Kurzform (Namensbereichspräfix) für http://schemas.xmlsoap.org/wsdl/ und xsd für http://www.w3.org/2001/XMLSchema. Eine URI-Anforderung von einem Element, das auf den ersten Blick wie ein <import>- oder <include>-Element aussieht, z. B. ein Element in einem Kommentar, führt zu einem SOAP-Fehler. Ausschließlich die einfache ?wsdl-Abfragezeichenfolge gefolgt von Abfragen, die denen in semantisch gültigen Importen und Einschlüssen entsprechen, führen dazu, dass Daten zurückgegeben werden.

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.

Bemerkungen | Marken | Dieser Link öffnet ein neues Fenster Downloads | Dieser Link öffnet ein neues Fenster Bibliothek | Dieser Link öffnet ein neues Fenster Support | Feedback

Copyright IBM Corporation 1999, 2011Copyright IBM Corporation 1999, 2011.

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2011-11-04 19:52:26


KonzeptthemaKonzeptthema | Version 8.0.0.0 | ac56230_