WSDL dokument

WSDL-dokument är bara ett enkelt XML-dokument.

Det innehåller en rad definitioner som beskriver en webbtjänst.

WSDL-dokumentstruktur

WSDL-dokument används för att beskriva en webbtjänst med hjälp av dessa huvudsakliga element:

Element Definition
<portType> Operationer som webbtjänsten utför
<message> Meddelanden som webbtjänsten använder
<types> Datatyper som webbtjänsten använder
<binding> Kommunikationsprotokollet som webbtjänsten använder

Den huvudsakliga strukturen för ett WSDL-dokument är liknande detta:

<definitions>
<types>
   definition of types........
</types>
<message>
   definition of a message....
</message>
<portType>
   definition of a port.......
</portType>
<binding>
   definition of a binding....
</binding>
</definitions>

WSDL-dokument kan innehålla andra element, såsom extension-element samt ett service-element som kan kombinera definitioner av flera webbtjänster i ett enda WSDL-dokument.

För en fullständig översikt över syntaxen, besök WSDL syntax Detta avsnitt.

WSDL port

<portType> Element är de viktigaste WSDL-elementen.

Det kan beskriva en webbtjänst, operationer som kan utföras samt relaterade meddelanden.

Man kan jämföra <portType>-elementet med en bibliotek (eller en modul, eller en klass) i ett traditionellt programmeringsspråk.

WSDL meddelanden

<message> Element definierar dataelementen för en operation.

Varje meddelande består av en eller flera delar. Dessa delar kan jämföras med argument i en anrop till en funktion i ett traditionellt programmeringsspråk.

WSDL typer

<types> Element definierar de datatyper som webbtjänsten använder.

För högsta möjliga plattform中立itet använder WSDL XML Schema-syntax för att definiera datatyper.

WSDL Bindings

<binding> Element definierar meddelandeformat och protokolldetaljer för varje port.

WSDL-exempel

Detta är en förenklad del av en WSDL-dokument:

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

I detta exempel<portType> Element definierar "glossaryTerms" som en vissPortNamn, definiera "getTerm" som en vissOperation.

Operationen "getTerm" har en namnInmatningsmeddelandeoch en som kallas "getTermResponse"Utmättningsmeddelande.

<message> Element kan definiera varje meddelandeDeloch relaterade datatyper.

Jämfört med traditionell programmering är glossaryTerms en bibliotek, och "getTerm" är en funktion med inmatningsparametern "getTermRequest" och utmatningsparametern getTermResponse.