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 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.

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 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 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 | Downloads | Bibliothek | Support | Feedback

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

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2012-01-20 09:46:29


KonzeptthemaKonzeptthema | Version 8.0.0.0 | ac56230_