WSDL Dokument

Ein WSDL-Dokument ist lediglich ein einfaches XML-Dokument.

Es enthält eine Reihe von Definitionen, die einen Web-Service beschreiben.

WSDL-Dokumentstruktur

WSDL-Dokumente verwenden diese Hauptelemente, um einen Webdienst zu beschreiben:

Element Definition
<portType> Vom Webdienst ausgeführte Operationen
<message> Vom Webdienst verwendete Nachrichten
<types> Vom Webdienst verwendete Datentypen
<binding> Vom Webdienst verwendete Kommunikationsprotokolle

Die Hauptstruktur eines WSDL-Dokuments ähnelt der folgenden:

Beispiel für ein WSDL-Dokument

<definitions> <types> Datentypdefinitionen........ </types> <message> Definition der kommunizierten Daten.... </message> <portType> Menge von Operationen...... </portType> <binding> Spezifikation von Protokoll und Datenformat.... </binding> </definitions>

Ein WSDL-Dokument kann andere Elemente wie Erweiterungselemente und ein service-Element enthalten. Dieses Element kann Definitionen mehrerer Webdienste in einem einzigen WSDL-Dokument kombinieren.

WSDL-Port

<portType>Das Element ist das wichtigste WSDL-Element.

Es kann einen Webdienst, die ausführbaren Operationen und die zugehörigen Nachrichten beschreiben.

Man kann das <portType>-Element mit einer Funktionsbibliothek (oder einem Modul oder einer Klasse) in traditionellen Programmiersprachen vergleichen.

WSDL-Nachricht

<message>Das Element definiert die Datenelemente einer Operation.

Jede Nachricht besteht aus einem oder mehreren Teilen. Diese Teile können mit den Parametern eines Funktionsaufrufs in traditionellen Programmiersprachen verglichen werden.

WSDL-Typen

<types>Das Element definiert die Datentypen, die vom Webdienst verwendet werden.

Für maximale Plattformneutralität verwendet WSDL die XML-Schema-Syntax, um Datentypen zu definieren.

WSDL-Bindungen

<binding>Das Element definiert das Nachrichtenformat und die Protokolldetails für jeden Port.

WSDL-Beispiel

Dies ist ein vereinfachtes Fragment eines WSDL-Dokuments:

Beispiel

<message name="getTermRequest"> <part name="term" type="xs:string"/> </message> <message name="getTermResponse"> <part name="value" type="xs:string"/> </message> <portType name="glossaryTerms"> <operation name="getTerm"> <input message="getTermRequest"/> <output message="getTermResponse"/> </operation> </portType>

In diesem Beispiel,<portType>Das Element definiert "glossaryTerms" als den Namen eines bestimmtenPortsund definiert "getTerm" als einen bestimmtenOperationsnamen.

Die Operation "getTerm" hat eineEingabenachricht namens "getTermRequest", und eineAusgabenachricht namens "getTermResponse".。

<message>Das Element kann dieTeilejeder Nachricht und die zugehörigen Datentypen definieren.

Im Vergleich zur traditionellen Programmierung ist glossaryTerms eine Funktionsbibliothek, und "getTerm" ist eine Funktion mit Eingabeparameter "getTermRequest" und Rückgabeparameter getTermResponse.

Andere Erweiterungen