WikiDer > Язык описания веб-сервисов
Расширение имени файла | .wsdl |
---|---|
Тип интернет-СМИ | приложение / wsdl + xml |
Разработан | Консорциум World Wide Web |
Содержится | XML |
Стандарт | 2.0 Рекомендация |
В Язык описания веб-сервисов (WSDL /ˈшɪzdəl/) является XML-основан язык описания интерфейса который используется для описания функциональности, предлагаемой веб-сервис. Акроним также используется для любого конкретного WSDL-описания веб-службы (также называемого WSDL файл), который предоставляет машиночитаемое описание того, как может быть вызвана служба, какие параметры она ожидает и какие структуры данных возвращает. Таким образом, его цель примерно такая же, как у подпись типа на языке программирования.
Текущая версия WSDL - WSDL 2.0. Значение аббревиатуры изменилось по сравнению с версией 1.1, где «D» означало «Определение».
Описание
WSDL описывает службы как наборы конечных точек сети или портов. Спецификация WSDL предоставляет XML формат для документов с этой целью. Абстрактные определения портов и сообщений отделены от их конкретного использования или экземпляра, что позволяет повторно использовать эти определения. Порт определяется путем связывания сетевой адрес с многоразовой привязкой, а набор портов определяет службу. Сообщения - это абстрактные описания данных, которыми обмениваются, а типы портов - это абстрактные наборы поддерживаемых операций. Спецификации конкретного протокола и формата данных для конкретного типа порта представляют собой повторно используемую привязку, в которой операции и сообщения затем привязываются к конкретному сетевому протоколу и формату сообщения. Таким образом, WSDL описывает открытый интерфейс веб-службы.
WSDL часто используется в сочетании с МЫЛО и Схема XML для предоставления веб-сервисов через Интернет. Клиентская программа, подключающаяся к веб-службе, может читать файл WSDL, чтобы определить, какие операции доступны на сервере. Любые специальные типы данных используемые, встроены в файл WSDL в виде схемы XML. Затем клиент может использовать SOAP для фактического вызова одной из операций, перечисленных в файле WSDL, например, используя XML через HTTP.
Текущая версия спецификации - 2.0; версия 1.1 не была одобрена W3C но версия 2.0 - это Рекомендация W3C.[1] WSDL 1.2 был переименован в WSDL 2.0 из-за его существенных отличий от WSDL 1.1. Принимая привязку ко всем Методы HTTP-запроса (не только GET и POST, как в версии 1.1), спецификация WSDL 2.0 предлагает лучшую поддержку для RESTful веб-сервисы, и его гораздо проще реализовать.[2][3] Однако поддержка этой спецификации все еще недостаточна. комплекты для разработки программного обеспечения для веб-служб, которые часто предлагают инструменты только для WSDL 1.1.[нуждается в обновлении][нужна цитата] Например, версия 2.0 Язык выполнения бизнес-процессов (BPEL) поддерживает только WSDL 1.1.
Срок действия WSDL 1.1 | Срок действия WSDL 2.0 | Описание |
---|---|---|
Служба | Служба | Содержит набор системных функций, которые были доступны для веб-протоколов. |
Порт | Конечная точка | Определяет адрес или точку подключения к веб-службе. Обычно он представлен простой строкой URL-адреса HTTP. |
Привязка | Привязка | Задает интерфейс и определяет МЫЛО стиль привязки (RPC/ Документ) и транспорт (МЫЛО Протокол). Раздел привязки также определяет операции. |
PortType | Интерфейс | Определяет веб-службу, операции, которые могут быть выполнены, и сообщения, которые используются для выполнения операции. |
Операция | Операция | Определяет действия SOAP и способ кодирования сообщения, например, «буквальный». Операция похожа на вызов метода или функции в традиционном языке программирования. |
Сообщение | н / д | Обычно сообщение соответствует операции. Сообщение содержит информацию, необходимую для выполнения операции. Каждое сообщение состоит из одной или нескольких логических частей. Каждая часть связана с атрибутом типа сообщения. Атрибут имени сообщения обеспечивает уникальное имя среди всех сообщений. Атрибут имени части обеспечивает уникальное имя среди всех частей включающего сообщения. Части - это описание логического содержания сообщения. В привязке RPC привязка может ссылаться на имя части, чтобы указать специфичную для привязки информацию о части. Часть может представлять параметр в сообщении; привязки определяют фактическое значение детали. Сообщения были удалены в WSDL 2.0, в котором XML Типы схем для определения тел входов, выходов и отказов упоминаются просто и напрямую. |
Типы | Типы | Описывает данные. В Схема XML язык (также известный как XSD) для этой цели используется (встроенный или упоминаемый). |
Подмножество WSDL
Подмножество WSDL (SWSDL)[4] представляет собой WSDL с подмножеством операций исходного WSDL. Разработчик может использовать SWSDL для доступа к подмножеству сервиса, таким образом обрабатывая подмножество кода веб-сервиса. Подмножество WSDL можно использовать для тестирования веб-сервисов и разработки сверху вниз. Нарезка веб-службы может быть выполнена с помощью WSDL подмножества для доступа к подмножеству службы. Служба подмножества может быть разделена на уровни с помощью SWSDL. SWSDL используются для анализа, тестирования и разработки веб-сервисов сверху вниз. AWSCM[5] является новаторским инструментом для успешного построения SWSDL.
Пример файла WSDL
<?xml version="1.0" encoding="UTF-8"?><описание xmlns ="http://www.w3.org/ns/wsdl" xmlns: tns ="http://www.tmsws.com/wsdl20sample" xmlns: whttp ="http://schemas.xmlsoap.org/wsdl/http/" xmlns: wsoap ="http://schemas.xmlsoap.org/wsdl/soap/" targetNamespace ="http://www.tmsws.com/wsdl20sample"><documentation> Это образец документа WSDL 2.0. </documentation><!-- Abstract type --> <types> xmlns: xs ="http://www.w3.org/2001/XMLSchema" xmlns ="http://www.tmsws.com/wsdl20sample" targetNamespace ="http://www.example.com/wsdl20sample"> имя ="запрос"> ... </xs:element> имя ="отклик"> ... </xs:element> </xs:schema> </types><!-- Abstract interfaces --> <интерфейс имя =«Интерфейс1»> <ошибка имя =«Ошибка1» element ="tns: response"/> <операция имя ="Получать" шаблон ="http://www.w3.org/ns/wsdl/in-out"> <ввод messageLabel ="В" element ="tns: запрос"/> <вывод messageLabel ="Из" element ="tns: response"/> </operation> </interface><!-- Concrete Binding Over HTTP --> <привязка имя =«HttpBinding» interface ="tns: Interface1" type ="http://www.w3.org/ns/wsdl/http"> <операция ref ="tns: Get" whttp: method ="ПОЛУЧАТЬ"/> </binding> <!-- Concrete Binding with SOAP--> <привязка имя ="SoapBinding" interface ="tns: Interface1" type ="http://www.w3.org/ns/wsdl/soap" wsoap: протокол ="http://www.w3.org/2003/05/soap/bindings/HTTP/" wsoap: mepDefault ="http://www.w3.org/2003/05/soap/mep/request-response"> <операция ref ="tns: Get" /> </binding><!-- Web Service offering endpoints for both bindings--> <сервис имя =«Сервис1» interface ="tns: Interface1"> <конечная точка имя ="HttpEndpoint" привязка ="tns: HttpBinding" адрес ="http://www.example.com/rest/"/> <конечная точка имя ="SoapEndpoint" привязка ="tns: SoapBinding" адрес ="http://www.example.com/soap/"/> </service></description>
История
WSDL 1.0 (сентябрь 2000 г.) был разработан IBM, Microsoft, и Ариба чтобы описать веб-службы для их набора инструментов SOAP. Он был построен путем объединения двух языков описания сервисов: NASSL (Язык спецификации сетевых приложений) от IBM и SDL (Язык описания службы) от Microsoft.
WSDL 1.1, опубликованный в марте 2001 года, является формализацией WSDL 1.0. Никаких серьезных изменений между 1.0 и 1.1 внесено не было.
WSDL 1.2 (июнь 2003 г.) был рабочим проектом на W3C, но стал WSDL 2.0. Согласно W3C: WSDL 1.2 проще и гибче для разработчиков, чем предыдущая версия. WSDL 1.2 пытается удалить несовместимые функции, а также лучше определяет привязку HTTP 1.1. WSDL 1.2 не поддерживался большинством серверов / поставщиков SOAP.
WSDL 2.0 стал рекомендацией W3C в июне 2007 года. WSDL 1.2 был переименован в WSDL 2.0, поскольку он существенно отличается от WSDL 1.1. Изменения следующие:
- Добавлена дополнительная семантика в язык описания
- Удалены конструкции сообщений
- Перегрузка оператора не поддерживается
- PortTypes переименован в интерфейсы
- Порты переименованы в конечные точки
Соображения безопасности
Поскольку файлы WSDL представляют собой спецификацию на основе XML для описания веб-службы, файлы WSDL уязвимы для атак.[6] Чтобы уменьшить уязвимость этих файлов, рекомендуется ограничивать доступ к сгенерированным файлам WSDL, устанавливать надлежащие ограничения доступа для определений WSDL и избегать ненужных определений в веб-службах.
Смотрите также
Рекомендации
- ^ «Язык определения веб-служб (WSDL), версия 2.0, часть 1: Базовый язык». Получено 2007-06-27.
- ^ «Язык определения веб-служб (WSDL), версия 2.0, часть 2: Дополнения».
- ^ «Привязка WITW WSDL 2.0 HTTP».
- ^ Чатурведи, Анимеш (2014). Подмножество WSDL для доступа к подмножеству службы для анализа. 2014 IEEE 6-я Международная конференция по технологиям и науке облачных вычислений. п. 688. Дои:10.1109 / CloudCom.2014.149. ISBN 978-1-4799-4093-6.
- ^ Чатурведи, Анимеш (2014). Автоматизированное управление изменениями веб-сервисов AWSCM - инструмент. 2014 IEEE 6-я Международная конференция по технологиям и науке облачных вычислений. п. 715. Дои:10.1109 / CloudCom.2014.144. ISBN 978-1-4799-4093-6.
- ^ «Раскрытие WSDL». Получено 2017-05-31.
внешняя ссылка
- Спецификация WSDL 1.0
- Спецификация WSDL 1.1
- Спецификация WSDL 2.0
- Рабочая группа описания веб-сервисов
- Активность протокола XML
- JSR-110: API Java для WSDL
- JSR 172: Спецификация веб-служб Java ME
- Онлайн-валидатор WSDL
- Веб-браузер WSDL и тестовый клиент
- Программная визуализация WSDL с помощью Linguine Maps
- SSDL - язык описания службы SOAP
- Привязки WSDL Java для XMLBeans и JAXB.
- RELAX-WS: простой язык определения веб-сервисов на основе компактного синтаксиса RELAX NG