Елементы SOAP

Элемент <Envelope> является корневым элементом SOAP сообщения. <Header>, <Body> и <Fault> являются дочерними элементами.

Шаблон SOAP

Ниже представлен шаблон SOAP сообщения:

<soap:Envelope
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
  soap:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  <soap:Header>
  ...
  Здесь находится информация заголовка
  ...
  </soap:Header>
  <soap:Body>
  ...
  Здесь находится информация тела
  ...
  </soap:Body>
  <soap:Fault>
  ...
  Здесь находится информация, связанная с ошибками
  ...
  </soap:Fault>
  </soap:Envelope>

Элемент Envelope

Элемент <Envelope> должен быть корневым элементом в SOAP сообщении. Он определяет XML документ как SOAP сообщение. Область имен должна быть установлена как "http://schemas.xmlsoap.org/soap/envelope/" и атрибут encodingStyle должен быть установлен как "http://schemas.xmlsoap.org/soap/encoding/".

<soap:Envelope
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
  soap:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  ...
  Здесь располагается информация сообщения
  ...
</soap:Envelope>

Элемент Header

Элемент <Header&пt может содержать дополнительную для приложения специфическую информацию о SOAP сообщении.
Пример:

<soap:Header>
<m:local xmlns:m="http://www.w3schools.com/local/">
  <m:language&rten</m:language>
  <m:currency&rtUSD</m:currency>
</m:local>
</soap:Header>

Элемент Header, в примере выше, содержит информацию о языке и типе валюты, используемой в SOAP сообщении. Примечание. Элементы <language> и <currency> - элементы определяемые пользователем. Они не являются частью стандарта SOAP.

Элемент Body

Элемент <Body> всегда должен быть в SOAP сообщении. Именно в нем содержится само SOAP сообщение.
Пример:

<soap:Body>
   <GetPrice>
      <Item>Apples</Item>
   </GetPrice>
</soap:Body>

Примечание. Элементы <GetPrice> и <Item> - это элементы специфичные для приложения. Они не являются частью стандарта SOAP.

Элемент Fault

Элемент <Fault> используется для предоставления информации об ошибках, которые случаются во время обработки сообщения. Данный элемент может применяться только в сообщениях ответах.
Пример:

<soap:Fault>
   <faultcode>Client</faultcode>
   <faultstring>Invalid Request<</faultstring>
</soap:Fault>

Коды, возвращаемые в случае ошибок, будут описаны далее.

Используются технологии uCoz