← Все гайды

Просмотр WSDL онлайн: операции, сообщения и типы

· 2 мин чтения

WSDL

Как разобраться в WSDL-описании SOAP-сервиса: схема интерфейсов, привязок и сервисов, операции с сообщениями и диаграммы типов из wsdl:types.

WSDL описывает SOAP-сервис, но читать его как текст тяжело: операции, сообщения, привязки и типы разнесены по разным разделам и связаны ссылками. Редактор WSDL собирает их в наглядную схему.

Как открыть WSDL

  1. Откройте песочницу WSDL.
  2. Вставьте описание или откройте файл .wsdl. Если WSDL доступен только по адресу вида ?wsdl, сохраните его из браузера в файл.
  3. Справа появятся вкладки Сервис и Типы (схема).
Схема WSDL: интерфейсы, привязки и сервисы
Вкладка «Сервис»: интерфейсы → привязки → сервисы и порты

Вкладка «Сервис»

  • Интерфейсы (portType) → привязки (binding) → сервисы и порты связаны линиями, как они ссылаются друг на друга в описании.
  • У привязки виден стиль (например, SOAP document) и транспорт, у порта — адрес сервиса.
  • Операции раскрываются в входное и выходное сообщения и ошибки (fault).

Вкладка «Типы (схема)»

Схемы из wsdl:types показываются диаграммой — так же, как в редакторе XSD. Щелчок по элементу части сообщения на вкладке «Сервис» открывает его диаграмму.

WSDL с внешними схемами

Часто типы вынесены в отдельные файлы XSD (xs:import schemaLocation="types.xsd"). Положите WSDL и схемы в проект с той же структурой папок — импорты разрешатся по относительным путям, и диаграммы покажут все типы. Схема проверяется на сервере по мере ввода.

Что дальше

Пример: что смотреть в первую очередь

  1. На вкладке «Сервис» найдите порт и адрес сервиса — куда отправлять запросы.
  2. Посмотрите привязку: стиль document/literal или rpc и версию SOAP (1.1 или 1.2) — это влияет на формат конверта и заголовок SOAPAction.
  3. Раскройте нужную операцию: какое сообщение на входе, какое на выходе, какие ошибки (fault) возможны.
  4. Щёлкните по элементу части сообщения — откроется его диаграмма на вкладке «Типы (схема)».

Вопросы и ответы

Поддерживается ли WSDL 2.0? Просмотр рассчитан на WSDL 1.1 — его используют практически все SOAP-сервисы. Отличия версий описаны в документации по WSDL.

Можно ли отправить запрос к сервису? Нет, редактор описывает и показывает сервис; для вызовов используйте SoapUI, Postman или curl. Пример тела запроса можно получить из схемы (гайд).