WSDL

XML "Swagger"

WSDL (Web Services Description Language) — это язык описания веб-сервисов, основанный на XML. На нем описываются методы, входные и результирующие структуры данных, типы данных, сетевые адреса для обращения к сервису и другое.

SOAP связан с WSDL по той части, что SOAP обеспечивает транспорт, а WSDL обеспечивает объявление веб-сервиса.

Элементы WSDL

Существуют две версии языка:

Документы WSDL состоят из следующих разделов:

Раздел
Версия 1.1
Версия 2.0

<definitions>

Задает пространства имен для документа WSDL, XML-схемы и SOAP

Отсутствует. Вместо него существует раздел <description>

<description>

Отсутствует. Вместо него существует раздел <definitions>

Задает пространства имен для документов WSDL, XML и SOAP

<types>

Элементы (данные), с которыми работает веб-сервис

Аналогично

<message>

Сообщения, с которыми работает веб-сервис

Отсутствует

<portType>

Операции, которые могут проводиться с сообщениями из раздела <message>

Отсутствует. Вместо него существует раздел <interface>

<interface>

Отсутствует. См. раздел <portType>

Операции, которые могут проводиться с элементами (данными) из раздела <types>

<binding>

Определение сетевого протокола и формат данных, используемых для операций из раздела <portType>

Аналогично

<operation>

Абстрактное определение операции (функции), в которой указываются входящее и исходящее сообщения, а так же сообщение об ошибке.

Аналогично

<service>

Объединяет конечные точки (адреса), реализующие общий интерфейс веб-сервиса. В разделе указывается общий адрес веб-сервиса

Аналогично

<port>

Протоколы и адреса, по которым выполняются запросы к веб-сервису

Отсутствует

<endpoint>

Отсутствует. Вместо него существует раздел <port>

Протоколы и адреса, по которым выполняются запросы к веб-сервису

Источники:

Last updated