Formati standard dei messaggi SOAP specificati tramite WSDL

Il WSDL (Web Services Description Language) è uno standard industriale che definisce uno schema per documenti XML che a sua volta definiscono servizi Web. Esso offre due principali opzioni di formattazione per i messaggi SOAP. Entrambe le opzioni non sono specificate negli elementi XML nello spazio dei nomi WSDL primario, https://schemas.xmlsoap.org/wsdl/, ma nello spazio dei nomi https://schemas.xmlsoap.org/wsdl/soap/. Questo spazio dei nomi secondario esegue il commit di un servizio Web con il protocollo SOAP.

Opzioni di formattazione SOAP

Le due opzioni di formattazione sono:

• Style: per l'elemento figlio e possibilmente i nipoti, dell'elemento Body in un messaggio SOAP. È specificato come attributo stile di un' di un elemento WSDL associazione (in genere) o di un elemento dell'operazione.

• Use: per i parametri del metodo del servizio Web, o un valore restituito il quale compare più in basso nel livello successivo. È specificato come attributo use di un elemento corpo.

Per ulteriori informazioni sulla specifica SOAP, visitare il sito Web di W3C all'indirizzo http://www.w3.org/TR/SOAP (informazioni in lingua inglese). Infromazioni sulla specifica WSDL possono essere trovate anche sul sito Web W3C ().

Valori consentiti dell'attributo stile

WSDL consente due valori per l'attributo stile che controlla la formattazione complessiva del corpo del testo dei messaggi SOAP:

• RPC: i parametri, o un valore restituito, vengono posizionati automaticamente in un elemento padre il cui il proprio padre è l'elemento Body del messaggio SOAP. Parametri e valori restituiti appaiono automaticamente senza qualifica dello spazio dei nomi. Questo schema SOAP è descritto nella Sezione 7 della specifica SOAP 1.1. style="rpc"specificato.

  Per una richiesta SOAP, l'elemento sotto il Body SOAP viene chiamato come un elemento dell'operazioneWSDL che corrisponde al metodo del servizio Web. Ogni elemento all'interno di quell'elemento rappresenta un parametro e è chiamato come il rispettivo parametro.

  Per una risposta SOAP, il nome dell'elemento sotto il Body SOAP corrisponde al nome dell'operazione, con l'aggiunta di Response. Il nome dell'elemento di sotto, che rappresenta il valore restituito, corrisponde al nome dell'operazione ma con suffisso Return.

• Document: il contenuto dell'elemento del Body SOAP è specificato pienamente in WSDL come gli elementi XML definiti in un XSD (XML Schema Definition). Lo schema XML è specificato o importato nel documento WSDL. Il WSDL non considera parametri e valori restituiti; tratta solo i documenti XML. Lo sviluppatore, o preferibilmente l'infrastruttura dei servizi Web, gestisce come i parametri e i valori restituiti vadano tradotti in elementi e tipi dello schema XML. style="document"specificato.

  Gli elementi XML di livello superiore sono specificati come parti del messaggio; gli elementi part definiti in un elemento del messaggio e che puntano alle dichiarazioni dell'elemento XSD. Di solito c'è solo una parte, di modo che il contenuto del Body SOAP sia veramente un documento XML, anche se WSDL, in sé per sé, non proibisce la presenza di più elementi.

WSDL ammette due valori per l'attributo use che controlla la formattazione di parametri e valori restituiti:

• Encoded: i dati vengono formattati secondo uno schema descritto nella sezione 5 della specifica SOAP 1.1. La codifica SOAP utilizza un sottoinsieme dello schema XML per l'associazione tra documenti XML e i dati che rappresentano. La codifica SOAP utilizza anche riferimenti per elementi che sono visualizzati più volte in un documento. use="encoded"specificato.

• Literal: i dati sono formattati in modo letterale secondo l'XSD (XML Schema Definition) specificato o importato nel documento WSDL. use="literal"specificato.

Vedere anche

Altre risorse

Personalizzazione della formattazione dei messaggi SOAP

Copyright © 2007 Microsoft Corporation. Tutti i diritti riservati.