Riassunto e traduzione della reference ufficiale del W3C del linguaggio descrizione di servizi del W3C

1. Un tutorial veloce per WSDL
Liberamente estratto e sintetizzato da
WSDL-Tutorial (http://www.w3schools.com/wsdl)
Introduzione
WSDL è un linguaggio basato su XML per descrivere i servizi Web e le modalità per accedervi.
Prima di apprestarsi alla lettura di questo tutorial si devono conoscere i seguenti argomenti:XML,
XML Schema, XML Namespace.
WSDL sta per linguaggio di descrizione per Web Service (Web Service Description Language). Un
documento WSDL è un documento XML in quanto WSDL è basto su XML. WSDL è usato per
descrivere i servizi ma anche per localizzarli. WSDL specifica la locazione del servizio e le
operazioni (o i metodi) che questo offre.WSDL è una raccomandazione del W3C.
Documenti WSDL
Un documento WSDL è un semplice documento XML che contiene un insieme di definizioni per
descrivere il servizio.
La struttura di un documento WSDL
Gli elementi più importanti usati da WSDL per descrivere un servizio sono i seguenti
• <types>: i tipi di dato usati dal servizio.
• <message>: i messaggi usati dal web service.
• <portType>: le operazioni eseguite dal servizio.
• <binding>: i protocolli di comunicazione usati dal servizio.
La struttura principale del documento è simile a quella presentata nel seguente listato:
<definitions>
<types>
definizione dei tipi....
</types>
<message>
definizione di un messaggio....
</message>
<portType>
definizione di un port....
</portType>
<binding>
definifinizione di un binding...
</binding>
</definitions>
Un documento WSDL può anche contenere altri elementi come elementi di estensione e un
elemento del servizio che dà la possibilità di raggruppare le definizioni di diversi web service in un
solo documento WSDL.
Port WSDL
L'elemento <portType> è il più importante in un documento WSDL: descrive il servizio, le
operazioni che possono essere eseguite e i messaggi che sono coinvolti in queste operazioni.
L'elemento <portType> può essere paragonato ad una libreria di funzioni (o un modulo, o una
classe) in un tradizionale linguaggio di programmazione.
Messaggi WSDL
L'elemento <message> definisce gli elementi di dati di una operazione.
Ogni messaggio può essere costituito da una o più parti. Le parti possono essere paragonate a dei
parametri di una chiamata di funzione in un linguaggio di programmazione tradizionale.

2. Tipi WSDL
L'elemento <types> definisce i tipi di dato usati nel web service: per la massima compatibilità tra le
piattaforme WSDL usa XML Schema per definire i tipi di dato.
Binding WSDL
L'elemento <binding> definisce il formato del messaggio ed i dettagli del protocollo per ogni Port.
Esempio di WSDL
<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 questo esempio l'elemento portType definisce un “glossaryTerm” come nome del port e
“getTerm” come nome dell'operazione. L'operazione “getTerm” ha un messaggio di input chiamato
“getTermRequest” e un messaggio di output chiamato “getTermResponse”. Gli elementi <message>
definisco le parti di ogni messaggio e i tipi di dato ad esse associato.
Confrontando questo esempio con un lingaggio di programmazione tradizionale, “glossaryTerm”
risulta essere una libreria di funzioni, “getTerm” una funzione con “getTermRequest” come
parametro di input e “getTermResponse” come parametro di output.
Port WSDL
Un port WSDL descrive le interfacce ( le operazioni consentite) presentate da un web service.
Il port definisce un punto di connessione con il servizio. Un port può essere visto come una libreria
di funzioni e ogni sua operazione come una funzione.
Tipi di Operazioni
Il tipo di operazione Request-Response è il più comune in WSDL ma non è l'unico supportato.
• One-Way: L'operazione può ricevere una richiesta ma non ritorna nessuna risposta
• Request-Response: L'operazione può ricevere delle richieste e ritornerà una risposta.
• Solicit-Response: L'operazione può spedire una richiesta e attendere per una risposta.
• Notification: L'operazione può spedire un messaggio ma non attenderà una risposta.
Operazioni One-Way
<message name="newTermValues">
<part name="term" type="xs:string"/>
<part name="value" type="xs:string"/>
</message>
<portType name="glossaryTerms">
<operation name="setTerm">
<input name="newTerm" message="newTermValues"/>
</operation>
</portType >
Nell'esempio il porto “glossaryTerms” definisce un'operazione one-way chiamata “setTerm”.
L'operazione “setTerm” accetta messaggi di input con nuovi termini del glossario, usando un
messaggio “newTermValues” con parametri di input “term” e “value”. Non è stato definito nessun
output per questa operazione.

3. Operazioni Request-Response
<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>
Nell'esempio il port “glossaryTerms” definisce una operazione Request-Response chiamata
“getTerm”.L'operazione “getTerm” richiede un messaggio di input chiamato “getTermRequest”,con
un parametro chiamato “term”,e ritorna un messaggio di output chiamato “getTermResponse”, con
un parametro chiamato “value”.
Binding WSDL
Un binding WSDL definisce il formato del messaggio e i dettagli sul protocollo per un servizio
web.
Binding con SOAP
<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>
<binding type="glossaryTerms" name="b1">
<soap:binding style="document” transport="http://schemas.xmlsoap.org/soap/
http" />
<operation>
<soap:operation soapAction="http://example.com/getTerm"/>
<input><soap:body use="literal"/></input>
<output><soap:body use="literal"/></output>
</operation>
</binding>
L'elemento <binging> ha due attributi: name e type. L'attributo name ( si può usare qualsiasi nome
si voglia) definisce il nome del binding mentre l'attributo type punta al port a cui si riferisce il
binding, in questo caso “glossaryTerms”.
L'elemento soap:binding ha due attributi: style e transport. L'attributo style può valere o “rpc”
(remote procedure call) oppure “document” (in questo caso abbiamo usato “document”) mentre
l'attributo transport definisce il protocollo SOAP da utilizzare (in questo caso usiamo HTTP).
L'elemento operation definisce ogni operazioni che il port espone (contiene). Per ogni operazione

4. deve essere definita la SOAP action corrispondente e si deve inoltre specificare come gli input e gli
output devono essere codificati (in questo caso abbiamo usato “literal”.
WSDL e UDDI
Universal Description, Discovery e Integration (UDDI) è un servizio di directory in cui le imprese
possono registrarsi e cercare i servizi Web. UDDI è framework indipendente dalla piattaform per la
descrizione dei servizi, il discovery delle imprese, e per l'integrazione dei servizi imprenditoriali
tramite Internet. UDDI è una directory per immagazzinare informazioni sui servizi e le interfacce
dei web service scritte in WSDL. UDDI comunica tramite SOAP ed è costruita all'interno della
piattaforma Microsoft .NET.
UDDI usa gli standard del W3C (World Wide Web Consortium) e dell'IETF (Internet Engineering
Task Force) come XML, SOAP, HTTP e DNS e inoltre sfrutta WSDL per descrivere le interfacce
dei servizi.
UDDI è utile per trovare l'impresa giusta tra i milioni di imprese online, per definire come stabilire
il commercio una volta trovata l'impresa, raggiungere nuovi consumatori e migliorare l'accesso di
quelli già acquisiti, risolvere
Oltre 200 compagnie già sono membri della comunità UDDI.