Élément SOAP Header

Les éléments Header SOAP optionnels contiennent des informations d'en-tête.

Élément SOAP Header

Les éléments Header SOAP optionnels peuvent contenir des informations spécifiques à l'application du message SOAP (comme l'authentification, le paiement, etc.). Si l'élément Header est fourni, il doit être le premier élément de l'élément Envelope.

Remarque :Tous les éléments directs des éléments Header doivent être dans des espaces de noms valides.

<?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'exemple ci-dessus contient un en-tête avec un élément "Trans" portant la valeur 234, et l'attribut "mustUnderstand" de cet élément a la valeur "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 définissent comment le conteneur doit traiter le message SOAP.

Attribut actor

En suivant le chemin du message à travers différents points de terminaison, le message SOAP peut être propagé d'un émetteur à un destinataire. Pas toutes les parties du message SOAP sont destinées à être livrées au point de terminaison final du message SOAP, mais d'un autre côté, il pourrait être destiné à être livré à un ou plusieurs points de terminaison sur le chemin du message.

L'attribut actor de SOAP peut être utilisé pour adresser l'é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.codew3c.com/transaction/"
soap:actor="http://www.codew3c.com/appml/">
234
</m:Trans>
</soap:Header>
...
...
</soap:Envelope>

Attribut mustUnderstand

L'attribut mustUnderstand de SOAP peut être utilisé pour indiquer si un élément de titre est obligatoire ou optionnel pour le destinataire qui doit le traiter.

Si vous ajoutez "mustUnderstand="1" à un sous-élément de l'élément Header, cela peut indiquer au destinataire qui traite ce header qu'il doit reconnaître cet élément. Si ce destinataire ne peut pas reconnaître cet élément, il doit être désactivé lors du traitement de ce header.

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

Attribut encodingStyle

L'attribut encodingStyle de SOAP a été expliqué dans l'alinéa précédent.