Elemento SOAP Header

O elemento Header SOAP opcional contém informações de cabeçalho.

Elemento SOAP Header

O elemento Header SOAP opcional pode conter informações específicas do aplicativo da mensagem SOAP (por exemplo, autenticação, pagamento, etc.). Se o elemento Header for fornecido, ele deve ser o primeiro filho do elemento Envelope.

Notas:Os elementos diretamente filhos de todos os elementos Header devem ser namespaces qualificados.

<?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>

O exemplo acima contém um cabeçalho com um elemento "Trans" que tem um valor de 234, e o valor do atributo "mustUnderstand" do elemento é "1".

O SOAP define três propriedades no espaço de nomes padrão ("http://www.w3.org/2001/12/soap-envelope"). Essas três propriedades são: actor, mustUnderstand e encodingStyle. Essas propriedades definidas no cabeçalho SOAP podem definir como o contêiner deve processar a mensagem SOAP.

Atributo actor

Através de diferentes pontos de extremidade ao longo do caminho da mensagem, a mensagem SOAP pode ser propagada de um remetente para um destinatário. Não todas as partes da mensagem SOAP são destinadas a serem transportadas para o ponto de extremidade final da mensagem SOAP, por outro lado, talvez sejam destinadas a serem enviadas para um ou mais pontos de extremidade ao longo do caminho da mensagem.

A propriedade actor do SOAP pode ser usada para endereçar o elemento Header para um ponto de extremidade específico.

Sintaxe

soap:actor="URI"

Exemplo

<?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>

Propriedade mustUnderstand

A propriedade mustUnderstand do SOAP pode ser usada para identificar se o item de cabeçalho é obrigatório ou opcional para o receptor que o trata.

Se você adicionar "mustUnderstand="1" a algum subelemento do elemento Header, ele pode indicar que o receptor que trata este cabeçalho deve aceitar este elemento. Se este receptor não puder aceitar este elemento, ele deve falhar ao tratar este cabeçalho.

Sintaxe

soap:mustUnderstand="0|1"

Exemplo

<?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>

Propriedade encodingStyle

A propriedade encodingStyle do SOAP foi explicada na seção anterior.