title: Web Services Description Language
text: # Web Services Description Language
  
  Il Web Services Description Language (WSDL) è un linguaggio formale in formato XML utilizzato per la creazione di "documenti" per la descrizione di Web service.
  
  ## Descrizione
  
  Mediante WSDL può essere infatti descritta l'interfaccia pubblica di un Web service (ovvero una descrizione basata su XML) che indica come interagire con un determinato servizio.
  
  Un "documento" WSDL contiene infatti, relativamente al Web service descritto, informazioni su:
  
  * cosa può essere utilizzato (le "operazioni" messe a disposizione dal servizio)
  * come sfruttare tale raggruppamento (specificando il protocollo di comunicazione da utilizzare per accedere al servizio, il formato dei messaggi accettati in input e restituiti in output dal servizio ed i dati correlati) ovvero i "vincoli" (bindings in inglese) del servizio;
  * dove si trova il servizio nella rete (cosiddetto endpoint o port del servizio che solitamente corrisponde all'indirizzo - in formato URI - che rende disponibile il Web service)
  
  Le operazioni supportate dal Web service ed i messaggi che è possibile scambiare con lo stesso sono descritti in maniera astratta e quindi non collegati ad uno specifico protocollo di rete e ad uno specifico formato.
  
  Il WSDL è solitamente utilizzato in combinazione con SOAP e XML Schema per rendere disponibili Web service su reti aziendali o su internet: un programma client può, infatti, "leggere" il documento WSDL relativo ad un Web service per determinare quali siano le funzioni messe a disposizione sul server e attraverso il protocollo SOAP utilizzare una o più delle funzioni elencate dal WSDL.
  
  La versione 1.1 di WSDL non è stata adottata come standard dal World Wide Web Consortium (W3C).
  
  Il 26 giugno 2007 la versione 2.0 è stata promossa a standard ufficiale (in forma di "raccomandazione") dal W3C.
  
  ## Stili e codifiche
  
  Un documento WSDL può essere caratterizzato da quattro distinte combinazioni di stili e codifiche:
  
  * RPC/encoded: ha una struttura molto semplice, ma non è approvato dallo standard WS-I ed è complesso da validare.
  * RPC/literal: è di nuovo molto semplice ed è privo di informazioni di codifica sui tipi. Soddisfa inoltre le specifiche WS-I, ma resta complesso da validare.
  * Document/encoded: non è conforme alle specifiche WS-I e non è praticamente mai utilizzato.
  * Document/literal: anche qui mancano le informazioni di codifica sui tipi ed è conforme alle specifiche WS-I (con alcune restrizioni). Può inoltre essere facilmente controllato con un validatore XML. Tuttavia, la struttura del WSDL diventa più complessa e verbosa. Infine, nel messaggio SOAP non è prevista l'indicazione del metodo utilizzato, per cui può risultare più complesso (o impossibile) capire quale operazione è richiesta dal client.
  