Elemento SOAP Header

Gli elementi Header di SOAP opzionali contengono informazioni di testa.

Elemento SOAP Header

Gli elementi Header di SOAP opzionali possono contenere informazioni specifiche dell'applicazione (ad esempio, autenticazione, pagamento, ecc.). Se l'elemento Header viene fornito, deve essere il primo figlio dell'elemento Envelope.

Nota:Tutti gli elementi diretti figli dell'elemento Header devono essere in uno spazio di nomi qualificato.

<?xml version="1.0"?>
<soap:Envelope
xmlns:soap="http://www.w3.org/2001/12/soap-envelope"
soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding"
<soap:Header>
<m:Trans
xmlns:m="http://www.codew3c.com/transaction/"
soap:mustUnderstand="1">234</m:Trans>
</soap:Header>
...
...
</soap:Envelope>

L'esempio sopra contiene un'header con un elemento "Trans" che ha un valore di 234, e l'attributo "mustUnderstand" dell'elemento è "1".

SOAP definisce tre attributi nel namespace predefinito ("http://www.w3.org/2001/12/soap-envelope"). Questi attributi sono: actor, mustUnderstand e encodingStyle. Questi attributi definiti nella testa di SOAP possono definire come il contenitore deve trattare il messaggio SOAP.

attributo actor

Attraverso il percorso del messaggio che passa attraverso diversi endpoint, i messaggi SOAP possono essere propagati da un mittente a un destinatario. Non tutte le parti del messaggio SOAP sono destinate a essere trasmesse all'endpoint finale del messaggio SOAP, tuttavia, dall'altra parte, potrebbero essere destinate a uno o più endpoint lungo il percorso del messaggio.

L'attributo actor di SOAP può essere utilizzato per indirizzare l'elemento Header a un endpoint specifico.

Sintassi

soap:actor="URI"

Esempio

<?xml version="1.0"?>
<soap:Envelope
xmlns:soap="http://www.w3.org/2001/12/soap-envelope"
soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding"
<soap:Header>
<m:Trans
xmlns:m="http://www.codew3c.com/transaction/"
soap:actor="http://www.codew3c.com/appml/">
234
</m:Trans>
</soap:Header>
...
...
</soap:Envelope>

Attributo mustUnderstand

L'attributo mustUnderstand di SOAP può essere utilizzato per identificare se un elemento del titolo è obbligatorio o opzionale per il ricevente che lo tratta.

Se hai aggiunto "mustUnderstand="1" a un sottoelemento dell'elemento Header, può indicare che il ricevente deve riconoscere questo elemento. Se questo ricevente non può riconoscere questo elemento, deve失效 nel trattamento di questo header.

Sintassi

soap:mustUnderstand="0|1"

Esempio

<?xml version="1.0"?>
<soap:Envelope
xmlns:soap="http://www.w3.org/2001/12/soap-envelope"
soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding"
<soap:Header>
<m:Trans
xmlns:m="http://www.codew3c.com/transaction/"
soap:mustUnderstand="1">
234
</m:Trans>
</soap:Header>
...
...
</soap:Envelope>

Attributo encodingStyle

L'attributo encodingStyle di SOAP è stato spiegato nella sezione precedente.