WSDL
XML "Swagger"
WSDL (Web Services Description Language) — это язык описания веб-сервисов, основанный на XML. На нем описываются методы, входные и результирующие структуры данных, типы данных, сетевые адреса для обращения к сервису и другое.
SOAP связан с WSDL по той части, что SOAP обеспечивает транспорт, а WSDL обеспечивает объявление веб-сервиса.
Элементы WSDL
Существуют две версии языка:
версия 1.1 от 2001 года, https://www.w3.org/TR/wsdl.html
версия 2.0 от 2007 года, https://www.w3.org/TR/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> | Протоколы и адреса, по которым выполняются запросы к веб-сервису |
Источники:
https://systems.education/soap-integration (подробнее)
Last updated