Элемент Header даёт нам возможность определять дополнительные свойства приложения. Например, мы можем использовать его для определния сигнатуры сервисов защищённых паролем.
Ключевые аспекты:
При работе с SOAP стоит учитывать следующие моменты
- Элемент Header является не обязательным.
- Этот элемент используется для добавления новых возможностей и функциональности.
- Элемент header можно использовать несколько раз в файле.
- Header является первым к прочтению файлом внутри элемента envelope.
Аттрибуты элемента Header
Элемент Header может иметь слудующие два аттрибута:
- Actor
Протокол SOAP определяет расположение сообщения, как список сервисов SOAP. Каждый из этих промежуточных сервисов может выполнять опредлеённую работу, а затем передавать сообщение следующему сервису по цепочке. С помощью аттрибута Actor, клиент может определить получателя элемента header. - MustUnderstand
Этот аттрибут показывает, является ли элемент обязательным или опциональным (true – обязательный, false – нет). Если элемент обязательный, то получатель ведомляется об этом и обрабатывает элемент header соответственно указанной семантике, илбо взвращает ошибку.
Ниже приведён пример простого SOAP сообщения с элементом Header:
<?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://proselyte.net/tutorials/" SOAP-ENV:mustUnderstand="true">4</t:Transaction>
</SOAP-ENV:Header>
</SOAP-ENV:Envelope>
На этом мы заканчиваем изучение элемента Header.
В следущей статье мы рассмотрим такой элемент SOAP сообщения, как Body.