Модель обработки soap

После того как были установлены различные синтаксические аспекты SOAP-сообщения наряду с некоторыми простыми шаблонами обмена сообщениями, в этом разделе дается общий обзор модели обработки SOAP (определенной в SOAP Часть 1 Раздел 2). Модель обработки SOAP описывает действия SOAP-узла при получении SOAP-сообщения.

Пример 7aдемонстрирует SOAP-сообщение с несколькими заголовочными блоками (их содержимое для краткости опущено). Различные варианты этого сообщения будут использованы для иллюстрации различных аспектов модели обработки в этом разделе и в дальнейшем.

Пример 7a

<?xml version="1.0" ?>

<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope">

<env:Header>

<p:oneBlock xmlns:p="http://example.com"

env:role="http://example.com/Log">

...

...

</p:oneBlock>

<q:anotherBlock xmlns:q="http://example.com"

env:role="http://www.w3.org/2003/05/soap-envelope/role/next">

...

...

</q:anotherBlock>

<r:aThirdBlock xmlns:r="http://example.com">

...

...

</r:aThirdBlock>

</env:Header>

<env:Body >

...

...

</env:Body>

</env:Envelope>

SOAP-сообщение, показывающее многообразие заголовочных блоков.

Модель обработки SOAP описывает (логические) действия, предпринимаемые SOAP-узлом при получении SOAP-сообщения. От узла требуется проанализировать SOAP-составляющие сообщения, а именно те элементы, которые находятся в пространстве имен SOAP "env". Такие элементы являются оболочками сами для себя - они имеют и заголовок и тело. Первым шагом, конечно, является общая проверка синтаксической правильности SOAP-сообщения. То есть проверки того, что оно соответствует информационному множеству XML SOAP при условии соблюдения ограничений использования определенных XML-конструкций - Инструкций Обработки и Определений Типов Документа - как это определено вSOAP Часть 1, Раздел 5.

Атрибут "role"

Дальнейшая обработка заголовочных блоков и тела зависит от роли(ролей), исполняемой SOAP-узлом при обработке данного сообщения. SOAP определяет (необязательный) атрибут заголовочного блокаenv:role- синтаксическиxs:anyURI- идентифицирующий роль, которую исполняет предполагаемый пункт назначения этого заголовочного блока. SOAP-узел нужен для обработки заголовочного блока, если он исполняет роль, идентифицируемую URI. То, каким образом SOAP-узел исполняет некоторую определенную роль, не является предметом рассмотрения спецификации SOAP.

Определены три стандартизованные роли (см. SOAP Часть 1 Раздел 2.2):

• "http://www.w3.org/2003/05/soap-envelope/role/none" (далее просто "none");

• "http://www.w3.org/2003/05/soap-envelope/role/next" (далее просто "next");

• "http://www.w3.org/2003/05/soap-envelope/role/ultimateReceiver" (далее просто "ultimateReceiver").

В примере 7aзаголовочный блокoneBlockадресован любому SOAP-узлу, играющему определенную приложением роль, определяемуюURI http://example.com/Log. Для целей иллюстрации предполагается, что спецификация этого заголовочного блока требует от любого SOAP-узла, играющего эту роль, протоколировать сообщение полностью.

Каждый SOAP-узел, получающий сообщение с заголовочным блоком, имеющим атрибут env:role"next", должен быть в состоянии обработать содержимое элемента, так как это стандартизованная роль, которую каждый SOAP-узел обязан исполнять. Заголовочный блок, имеющий этот атрибут, ожидает рассмотрения и (возможно) будет обработан следующим SOAP-узлом на пути сообщения. (Предполагается, что такой заголовок не был удален в результате обработки каким-либо предшествующим узлом.)

В примере 7aзаголовочный блокanotherBlockадресован следующему узлу на пути сообщения. В этом случае, SOAP-сообщение, получено узлом, играющим определенную приложением роль "http://example.com/Log", и этот узел должен быть также способен исполнять определеннуюSOAP роль "next". Сказанное справедливо и для узла-конечного получателя сообщения, так как он, очевидно (и полностью), также исполняет роль "next" в силу того, что является следующим на пути сообщения.

Третий заголовочный блок в примере 7а,aThirdBlock, не имеет атрибутаenv:role. Он адресован SOAP-узлу, исполняющему роль "ultimateReceiver". Роль "ultimateReceiver" (эта роль может быть объявлена явно или подразумеваться, если в заголовочном блоке атрибутenv:roleотсутствует) исполняется SOAP-узлом, являющимся конечным получателем SOAP-сообщения. Отсутствие атрибутаenv:roleв заголовочном блокеaThirdBlockозначает, что этот заголовочный блок адресован SOAP-узлу, исполняющего роль "ultimateReceiver".

Необходимо отметить, что элемент env:Bodyне имеет атрибутаenv:role. Элемент тела сообщениявсегдаадресован SOAP-узлу, исполняющему роль "ultimateReceiver". В этом смысле элемент тела сообщения, как и заголовочный блок, адресован конечному получателю, но отличен от него тем, что проходит сквозь SOAP-узлы (как правило, SOAP-посредники) неизмененным, если они исполняют роль иную, нежели роль конечного получателя. SOAP не устанавливает какой-либо структуры элементаenv:Body. Существует лишь рекомендация, что любой субэлемент должен удовлетворять пространству имен XML. Некоторые приложения, например, впримере 1, могут выбирать каким образом организовывать субэлементыenv:Bodyв блоки, однако этот вопрос не имеет отношения к модели обработки SOAP.

Другая отличительная роль элемента env:Body, - роль контейнера, куда помещается информация о SOAP-специфичных ошибках, т. е. об ошибках, возникающих в случае неудачного завершения обработки элементов SOAP-сообщения - была описана ранее вразделе 2.3.

Если заголовочный элемент имеет стандартизованный атрибут env:roleсо значением "none", ни один SOAP-узел не должен обрабатывать содержимое этого элемента, хотя может его просматривать, если это данные, ссылающиеся на другой заголовочный элемент, адресованный определенному SOAP-узлу.

Если атрибут env:roleимеет пустое значение, т. е.env:role="", это означает, что соответствующий идентифицирующий роль URI является исходным для SOAP-сообщения. SOAP Версия 1.2 не определяет исходный URI SOAP-сообщения, однако ссылается на механизмы получения исходного URI, определенные в [XMLBase] которые могут быть использованы для работы с любыми относительными URI как с абсолютными. Подобный механизм существует для протокольной привязки с целью определения исходного URI по ссылке на протокол, инкапсулирующий SOAP-сообщение для передачи. (В случае передачи SOAP-сообщений с помощью HTTP,SOAP Часть 2 Раздел 7.1.2dопределяет исходный URI как URI-запрос HTTP-запроса либо как значение заголовка HTTP Content-Location.)

Приведенная ниже таблица суммирует информацию о допустимых стандартизованных ролях, которые могут исполняться SOAP-узлами. ("Да" и "Нет" означают, что узлы соответственно могут или не могут исполнять указанную роль.)

Роль	отсутствует	"none"	"next"	"ultimateReceiver"
Узел
отправитель	неприменима	неприменима	неприменима	неприменима
посредник	нет	нет	да	нет
конечный получатель	да	нет	да	да