SOAP HeaderElemento
El elemento SOAP Header opcional contiene información de cabecera.
Elemento SOAP Header
El elemento SOAP Header opcional puede contener información específica de la aplicación sobre el mensaje SOAP (como autenticación, pagos, etc.).
Si se proporciona el elemento Header, debe ser el primer elemento hijo del elemento Envelope.
Nota:Todos los elementos hijos directos del elemento Header deben ser calificados con un espacio de nombres.
<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>
El ejemplo anterior contiene una cabecera con un elemento "Trans", cuyo valor es 234, y el valor del atributo "mustUnderstand" de este elemento es "1".
SOAP define tres atributos en el espacio de nombres predeterminado ("http://www.w3.org/2001/12/soap-envelope").
Estos tres atributos son: actor, mustUnderstand y encodingStyle. Estos atributos, definidos en la cabecera SOAP, definen cómo el contenedor procesa el mensaje SOAP.
Atributo mustUnderstand
El atributo mustUnderstand de SOAP se puede utilizar para identificar si un elemento de encabezado es obligatorio u opcional para el receptor que debe procesarlo.
Si añade `mustUnderstand="1"` a un elemento hijo del elemento Header, esto indica que el receptor que procesa esta cabecera debe comprender este elemento. Si este receptor no puede comprenderlo, debe fallar al procesar esta cabecera.
Sintaxis
Ejemplo
<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>
Atributo actor
A través de diferentes puntos finales a lo largo de la ruta del mensaje, un mensaje SOAP puede transmitirse de un remitente a un receptor. No todas las partes de un mensaje SOAP están destinadas a llegar al punto final final del mensaje SOAP, pero, por otro lado, algunas pueden estar destinadas a uno o más puntos finales en la ruta del mensaje.
El atributo actor de SOAP se puede utilizar para direccionar el elemento Header a un punto final específico.
Sintaxis
Ejemplo
<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>
Atributo encodingStyle
El atributo encodingStyle de SOAP se utiliza para definir los tipos de datos utilizados en el documento. Este atributo puede aparecer en cualquier elemento SOAP y se aplicará al contenido del elemento y a todos los elementos secundarios del elemento.
Los mensajes SOAP no tienen una codificación predeterminada.
Sintaxis
Otras extensiones