SOAP - nagłówek

Opcjonalny element Header oferuje elastyczną strukturę do określania dodatkowych wymagań na poziomie aplikacji. Na przykład elementu Header można użyć do określenia podpisu cyfrowego dla usług chronionych hasłem. Podobnie można go użyć do określenia numeru konta dla płatnych usług SOAP.

Zwraca uwagę

Jest to opcjonalna część wiadomości SOAP.
Elementy nagłówka mogą występować wielokrotnie.
Nagłówki mają na celu dodanie nowych funkcji i funkcjonalności.
Nagłówek SOAP zawiera wpisy nagłówka zdefiniowane w przestrzeni nazw.
Nagłówek jest kodowany jako pierwszy bezpośredni element podrzędny koperty SOAP.
Gdy zdefiniowano wiele nagłówków, wszystkie bezpośrednie elementy podrzędne nagłówka SOAP są interpretowane jako bloki nagłówka SOAP.

Atrybuty nagłówka SOAP

Nagłówek SOAP może mieć następujące dwa atrybuty -

Atrybut aktora

Protokół SOAP definiuje ścieżkę wiadomości jako listę węzłów usług SOAP. Każdy z tych węzłów pośrednich może wykonać pewne przetwarzanie, a następnie przekazać wiadomość do następnego węzła w łańcuchu. Ustawiając atrybut Actor, klient może określić odbiorcę nagłówka SOAP.

Atrybut MustUnderstand

Wskazuje, czy element Header jest opcjonalny, czy obowiązkowy. Jeśli ma wartość true, odbiorca musi zrozumieć i przetworzyć atrybut Header zgodnie ze zdefiniowaną semantyką lub zwrócić błąd.

Poniższy przykład pokazuje, jak używać nagłówka w komunikacie SOAP.

<?xml version = "1.0"?>
<SOAP-ENV:Envelope 
   xmlns:SOAP-ENV = " http://www.w3.org/2001/12/soap-envelope"   
   SOAP-ENV:encodingStyle = " http://www.w3.org/2001/12/soap-encoding">

   <SOAP-ENV:Header>
      <t:Transaction 
         xmlns:t = "http://www.tutorialspoint.com/transaction/" 
         SOAP-ENV:mustUnderstand = "true">5
      </t:Transaction>
   </SOAP-ENV:Header>
   ...
   ...
</SOAP-ENV:Envelope>