SOAP Encoding

SOAP Encoding

• Se intendiamo usare il SOAP Encoding 1.1 il valore http://schemas.xmlsoap.org/soap/encoding/
• Se intendiamo usare il SOAP Encoding 1.2 il valore http://www.w3.org/2001/12/soap-encoding

I tipi di dati SOAP si dividono in due grandi categorie: i tipi semplici (o scalari) ed i tipi composti (anche detti compound).

SOAP-ENCODING DI TIPI SEMPLICI

I tipi semplici contengono esattamente un valore, come ad esempio il cognome, il prezzo, o la descrizione del prodotto, essi vengono serializzati all’interno di un elemento detto accessor del valore. Di seguito si riepilogano i principali tipi semplici, tale tabella è stata estrapolata dalla guida dei tipi XML del W3C.

In questi messaggi il tipo semplice è specificato nell’attributo xsi:type (proveniente dal namespace http://www.w3.org/1999/XMLSchema-instance) sempre specificato nell’elemento SOAP-ENV:Envelope.

<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" 
xmlns:xsi="http://www.w3.org/1999/XMLSchema-instance" 
xmlns:xsd:="http://www.w3.org/1999/XMLSchema">
	<SOAP-ENV:Body>
		<m:SayHelloTo xmlns:m="https://www.gianlucadivincenzo.it/helloworld">
			<name xsi:type="xsd:string">Gianluca</name>
		</m:SayHelloTo>
	</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Il corpo del messaggio SOAP in questo caso possiede un solo valore, accessibile tramite l’accessor name.

SOAP-ENCODING DI TIPI COMPOSTI

Esempio di Accessor Multipli

SOAP ENCODING DI STRUTTURE

Accessor dei membri delle Strutture

<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
	<SOAP-ENV:Body>
		<e:Book xmlns:e="https://www.gianlucadivincenzo.it/book">
			<author>Gianluca Di Vincenzo</author>
			<intro>Questa è una struttura con due membri.</intro>
		</e:Book>
	</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

dove la struttura è definita nel Namespace XML https://www.gianlucadivincenzo.it/book che possiede il seguente complexType.

<element name="Book">
	<complexType>
		<element name="author" type="xsd:string"/>
		<element name="intro" type="xsd:string"/>
	</complexType>
</element>

E’ possibile anche serializzare più strutture che prevedono dei puntatori, tale tipologia di soap encoding è detta multi-reference.

SOAP ENCODING DI ARRAYS

Il SOAP Encoding fornisce anche un elemento Array, che può essere usato per la serializzazione di matrici e di vettori.
Le istanze di un elemento di tipo Array devono contenere l’attributo arrayType che specifica il tipo degli elementi dell’Array.
Ad esempio, il seguente attributo specifica un array di 10 valori double:

arrayType="xsd:double[10]"

mentre quì si mostra un esempio di una matrice di double:

arrayType="xsd:string[5,5]"

Infine per completare la trattazione si propone la serializzazione di un messaggio che prevede al suo interno una matrice (o anche detto array multidimensionale).

<p:Persona>
	<nome>Gianluca Di Vincenzo</nome>
	<phoneNumbers SOAP-ENC:arrayType="p:phoneNumber[2,2]">
		<phoneNumber>Home - Phone</phoneNumber>
		<phoneNumber>Home - Fax</phoneNumber>
		<phoneNumber>Office - Phone</phoneNumber>
		<phoneNumber>Office - Fax</phoneNumber>
	</phoneNumbers>
</p:Persona>

dove nel Namespace XML è definito il complexType Persona.

<element name="ArrayOfPhoneNumbers">
	<complexType>
		<element name="phoneNumber" type="phoneNumber" maxOccurs="unbounded" />
	</complexType>
	<anyAttribute/>
</element>
<element name="Persona">
	<complexType>
		<element name="nome" type="string"/>
		<element name="phoneNumbers" type="ArrayOfPhoneNumbers" />
	</complexType>
</element>