ГОСТ Р ИСО/МЭК 40220-2015. Национальный стандарт Российской Федерации. Информационные технологии. W3C SOAP. Версия 1.2. Часть 2. Дополнения (вторая редакция)

8.4. Функция SOAP "Веб-метод"

Данный раздел определяет функцию SOAP "Веб-метод".

8.4.1. Имя функции SOAP

Идентификатор функции SOAP "Веб-метод": URI [ИСО/МЭК 40210, подраздел 5.6] "http://www.w3.org/2003/05/soap/features/web-method/".

8.4.2. Описание

Нижележащие протоколы, разработанные для использования в сети Интернет, предусматривают для работы с ресурсами небольшой набор Веб-методов, таких как GET, PUT, POST и DELETE. Эти методы формально определены в спецификации HTTP [RFC 2616], но и нижележащие базовые протоколы могут также их поддерживать. Привязкам к HTTP или другим подобным протоколам СЛЕДУЕТ использовать функцию SOAP "Веб-метод" для предоставления приложениям контроля над Веб-методами, которые будут применяться при передаче сообщений SOAP.

Привязкам, поддерживающим эту функцию, СЛЕДУЕТ использовать подходящую реализацию этой функции, если она предоставляется базовым протоколом; например, привязка HTTP, описанная в данной спецификации, представляет метод "GET" как запрос HTTP GET и метод "POST" как запрос HTTP POST (см. раздел 9). Привязкам, поддерживающим эту функцию, СЛЕДУЕТ предоставлять получающему узлу информацию о Веб-методе, использованном для передачи.

Функция SOAP "Веб-метод" МОЖЕТ быть реализована привязкой к нижележащим транспортным протоколам, у которых нет предпочтительных реализаций определенных Веб-методов (например, не различающих GET и POST). Таким привязкам СЛЕДУЕТ предоставлять получающему узлу информацию о Веб-методе, использованном при передаче, но не требуется предпринимать дополнительных действий для поддержки данной функции.

8.4.3. Конечный автомат функции SOAP "Веб-метод"

Функция SOAP "Веб-метод" определяет единственное свойство, которое описано в таблице 13.

 

Таблица 13

 

Определение свойства для функции SOAP "Веб-метод"

 

Имя свойства	Описание свойства	Тип свойства
http://www.w3.org/2003/05/soap/features/web-method/Method	Один из "GET", "POST", "PUT", "DELETE" (или другие, которые позднее могут быть добавлены к набору Веб-методов)	Не определен

 

Данная спецификация предусматривает использование функции SOAP "Веб-метод" в сочетании с шаблонами обмена сообщениями (см. 8.2 и 8.3). Данная функция МОЖЕТ использоваться с другими ШОС тогда и только тогда, когда это предусмотрено в спецификациях других ШОС.

Узел, отправляющий сообщение запроса, ДОЛЖЕН предоставлять значение для свойства http://www.w3.org/2003/05/soap/features/web-method/Method. Привязке протокола, поддерживающей эту функцию, СЛЕДУЕТ установить значение свойства http://www.w3.org/2003/05/soap/features/web-method/Method в получающем узле, чтобы оно соответствовало значению, указанному отправителем; средство передачи этого свойства определяется привязкой.

Отвечающему узлу СЛЕДУЕТ отвечать способом, согласующимся с запрашиваемым Веб-методом (например, вызов метода "GET" должен привести к извлечению представления идентифицированного ресурса), или, если Веб-метод не поддерживается, СЛЕДУЕТ произвести отказ специфичным для приложения способом.

Привязки, реализующие эту функцию, ДОЛЖНЫ использовать шаблон обмена сообщениями с семантикой, которая совместима с выбранным Веб-методом. Например, шаблон обмена сообщениями SOAP "ответ SOAP" (см. 8.3) совместим с "GET".