Élément HeaderSOAP


L'élément Header SOAP facultatif contient des informations d'en-tête.


Élément Header SOAP

L'élément Header SOAP facultatif peut contenir des informations spécifiques à l'application sur le message SOAP (telles que l'authentification, le paiement, etc.).

Si l'élément Header est fourni, il doit être le premier élément enfant de l'élément Envelope.

Remarque :Tous les éléments enfants directs de l'élément Header doivent être qualifiés par un espace de noms.

<?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.w3schools.com/transaction/"
  soap:mustUnderstand="1">234
  </m:Trans>
</soap:Header>
...
...
</soap:Envelope>

L'exemple ci-dessus contient un en-tête avec un élément "Trans" dont la valeur est 234, et l'attribut "mustUnderstand" de cet élément a une valeur de "1".

SOAP définit trois attributs dans l'espace de noms par défaut ("http://www.w3.org/2001/12/soap-envelope").

Ces trois attributs sont : actor, mustUnderstand et encodingStyle. Ces attributs définis dans l'en-tête SOAP peuvent définir comment un conteneur traite le message SOAP.


Attribut mustUnderstand

L'attribut mustUnderstand de SOAP peut être utilisé pour identifier si un élément d'en-tête est obligatoire ou facultatif pour le récepteur qui le traite.

Si vous ajoutez "mustUnderstand="1"" à un élément enfant de l'élément Header, cela indique que le récepteur qui traite cet en-tête doit reconnaître cet élément. Si le récepteur ne peut pas reconnaître cet élément, il doit échouer lors du traitement de cet en-tête.

Syntaxe

soap:mustUnderstand="0|1"

Exemple

<?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.w3schools.com/transaction/"
  soap:mustUnderstand="1">234
  </m:Trans>
</soap:Header>
...
...
</soap:Envelope>


Attribut actor

En parcourant le chemin du message à travers différents points de terminaison, un message SOAP peut se propager d'un expéditeur à un destinataire. Toutes les parties d'un message SOAP ne sont pas destinées au point de terminaison final du message SOAP, mais d'un autre côté, elles peuvent être destinées à un ou plusieurs points de terminaison sur le chemin du message.

L'attribut actor de SOAP peut être utilisé pour adresser un élément Header à un point de terminaison spécifique.

Syntaxe

soap:actor="URI"

Exemple

<?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.w3schools.com/transaction/"
  soap:actor="http://www.w3schools.com/appml/">234
  </m:Trans>
</soap:Header>
...
...
</soap:Envelope>


Attribut encodingStyle

L'attribut encodingStyle de SOAP est utilisé pour définir les types de données utilisés dans le document. Cet attribut peut apparaître dans n'importe quel élément SOAP, et il sera appliqué au contenu de l'élément et à tous les éléments enfants de l'élément.

Les messages SOAP n'ont pas de méthode d'encodage par défaut.

Syntaxe

soap:encodingStyle="URI"

Autres extensions