Для реферата / Radchenko_Distributed_Computer_Systems

Веб-сервисы

Рис. 29. Стек протоколов веб-сервисов

9.2 Стандарт WSDL

Рассмотрим пример простейшего веб-сервиса. Данный сервис будет обес-

печивать возведение в квадрат переданного числа. На языке Java этот сервис можно было бы описать в виде следующего исходного кода.

public class MyMath

{

public int squared(int x)

{

return x * x;

}

}

Рис. 30. Пример исходного кода для тестового веб-сервиса

Предположим, что данный веб-сервис мы будем размещать в интернете по

адресу http://supercomputer.susu.ru/MyMath.

Для того чтобы любой клиент мог получить информацию о том, какие ме-

тоды предоставляет веб-сервис и как к ним необходимо обращаться, используется WSDL-документ , описывающий полную спецификацию методов взаимо-

действия с указанным сервисом. Соответственно, нам необходимо сформировать (вручную или автоматически) WSDL-документ и поместить его по адресу

http://supercomputer.susu.ru/MyMath.wsdl.

Как уже было сказано в начале главы, стандарт WSDL обеспечивает опи-

сание веб-сервиса в виде сообщений, которые может отправить или же принять веб-сервис. Также, он отвечает за методы связывания данных сообщений с ба-

95

Глава 9

зовой средой передачи данных (чаще всего используется протокол HTTP). В

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

−Блок types – типы данных, используемые веб-сервисом;

−Блок message – сообщения, используемые веб-сервисом;

−Блок portType – методы, предоставляемые веб-сервисом;

−Блок binding – протоколы связи, используемые веб-сервисом.

9.2.1 Порты WSDL <portType>

Элемент <portType> является наиболее важным элементом WSDL. Он определяет сам веб-сервис, предоставляемые им операции и используемые сообщения. Этот элемент можно сравнить с библиотекой функций, в которой ука-

заны входные параметры и результаты работы функции. Рассмотрим, каким об-

разом будет описываться наш сервис “ MyMath”:

<wsdl:portType name="MyMath">

<wsdl:operation name="squared" parameterOrder="in0"> <wsdl:input message="impl:squaredRequest“

name="squaredRequest"/>

<wsdl:output message="impl:squaredResponse“ name="squaredResponse"/>

</wsdl:operation>

</wsdl:portType>

Рис. 31. Пример описания блока portType

Как видно из описания, в блоке portType описан интерфейс нашего серви-

са MyMath, состоящий из одной операции squared. Также из описания видно, что данная операция должна выполняться с одним параметром in0 (его описание будет дано в следующем разделе WSDL-документа, блоке <message>). Наша операция состоит из двух сообщений: входного (wsdl:input

message="impl:squaredRequest") и выходного (wsdl:output message= "impl:squaredResponse"). Входное сообщение "squaredRequest" – это то сооб-

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

"squaredResponse" – это сообщение, которое будет возвращено пользователю после того, как наша операция возведения в квадрат успешно завершится. Ин-

терфейс этих сообщений будет описан в блоке <message> WSDL-документа.

9.2.2 Сообщения WSDL <message>

Элемент <message> определяет элементы данных операции. Каждое сооб-

щение может содержать одну или несколько частей. Эти части можно сравнить с параметрами вызываемых функций в традиционных языках программирова-

ния.

96

Веб-сервисы

<wsdl:message name="squaredRequest"> <wsdl:part name="in0" type="xsd:int"/>

</wsdl:message>

<wsdl:message name="squaredResponse">

<wsdl:part name="squaredReturn" type="xsd:int"/> </wsdl:message>

Рис. 32. Пример описания блока message

Как можно заметить, в блоке <message> приводится описание всех частей

сообщений "squaredRequest" и "squaredResponse", интерфейс которых мы опи-

сали ранее в блоке <portType>. Каждая часть сообщения – это параметр вызова метода нашего сервиса. В соответствии с этим легко расшифровать, что для проведения нашей операции возведения в квадрат, пользователь должен пере-

дать нам 1 входной параметр "in0" в виде целого числа, что определяется атри-

бутом type="xsd:int". Результатом же операции также будет целое число, что

описано в блоке <wsdl:part name="squaredReturn" type="xsd:int"/>.

9.2.3 Связи WSDL <binding>

Элемент <binding> определяет формат сообщения и детали протокола для каждого порта. Он отвечает за то, каким образом элементы абстрактного ин-

терфейса в блоке <portType> преобразуются в массивы информации в формате протоколов взаимодействия, например SOAP.

<wsdl:binding name="MyMathSoapBinding" type="impl:MyMath"> <wsdlsoap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/> <wsdl:operation name="squared">

<wsdlsoap:operation soapAction=""/> <wsdl:input name="squaredRequest">

<wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"

namespace="http://DefaultNamespace" use="encoded"/> </wsdl:input>

<wsdl:output name="squaredResponse"> <wsdlsoap:body

encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://DefaultNamespace" use="encoded"/>

</wsdl:output>

</wsdl:operation>

</wsdl:binding>

Рис. 33. Пример описания блока binding

Основной частью блока <binding> является элемент <soap:binding>, опре-

деляющий конкретный протокол передачи данных. Атрибут style определяет тип запроса и может иметь два значения: "rpc" и "document". Также, в блоке

<soap:binding> является transport, определяющий протокол, на основе которого будет производиться взаимодействие (обычно HTTP). Внутри

97

Глава 9

<soap:operation> находится элемент, который описывает значение поля soapAction HTTP-запроса (если вы знакомы с SOAP). Элементы input и output

определяют как будут декодироваться входные и выходные сообщения этой операции.

9.2.4Блоки <port> и <service>

Вданных блоках происходит определение, где находится сервис: port – описывает расположение и способ доступа к конечной точке, service – имено-

ванная коллекция портов.

<wsdl:service name="MyMathService">

<wsdl:port binding="impl:MyMathSoapBinding“ name="MyMath"> <wsdlsoap:address location="http://supercomputer.susu.ru/MyMath"/>

</wsdl:port>

</wsdl:service>

</wsdl:definitions>

Рис. 34. Пример блока service

Как можно видеть из примера, в блоке <port> не происходит непосредственного описания методов взаимодействия с веб-сервисом. Они описываются ранее, в блоке <binding>, а в блоке <port> только дается ссылка на описанный метод связи binding.

9.2.5Стандарт WSDL 2.0

В2004 году был принят черновой вариант стандарта WSDL 2.0. WSDL 1.2 была переименована WSDL 2.0 из-за существенных отличий от WSDL 1.1. Не смотря на то, что до сих пор нет финальной спецификации данного стандарта, консорциум W3C в 2007 году рекомендовал использовать именно тот формат

WSDL документов, который описан в стандарте WSDL 2.0.

В качестве основных изменений в стандарте WSDL 2.0 можно отметить следующее:

−многие блоки WSDL-документа были переименованы в соответствии с устоявшейся терминологией разработчиков распределенных приложений: Port превратился в Endpoint, PortType – в Interface;

−исчез блок Message, слившись с блоком Types (который стал обязательным);

−при описании методов связывания в блоке binding появилась возможность указывать любой метод HTTP запросов (GET, POST, PUT, DELETE) по-

средством атрибута whttp:method. Это сделало стандарт WSDL гораздо ближе к идеологии взаимодействия посредством веб.

98

Глава 9

<?xml version="1.0"?> <soap:Envelope

xmlns:soap=http://www.w3.org/2001/12/soap-envelope soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding">

<soap:Header>

...

...

</soap:Header>

<soap:Body>

...

...

</soap:Body>

</soap:Envelope>

Рис. 36. Шаблон SOAP-сообщения

В заголовке SOAP-сообщения мы имеем возможность ввести новые эле-

менты сообщения, не предусмотренные стандартом SOAP. Эти элементы играют утилитарную роль по отношению к основному сообщению, содержащемуся в теле SOAP. Например, мы можем передать номер транзакции, в рамках которой пришло то или иное сообщения, передать информацию, необходимую для авторизации пользователя и др.

<soap:Header>

<trans:Transaction

xmlns:trans="http://www.host.com/namespaces/space/"

soap:mustUnderstand=“1”>

12

</trans:Transaction>

</soap:Header>

Рис. 37. Пример заголовка SOAP-сообщения

У каждого элемента, введенного в заголовок SOAP-сообщения, мы можем

указать значения следующих атрибутов:

−mustUnderstand – если значение данного атрибута равно 1, получатель обя-

зан обрабатывать этот элемент заголовка. Если он не умеет этого делать, то он обязан отбросить полученное сообщение;

−actor – указывает название конкретного приложения-получателя если

SOAP-сообщение проходит цепочку приложений при обработке.

В теле SOAP-сообщения производится передача сообщения по формату,

определенному в блоках <porttype> и <message> WSDL-документа. Имя основного блока, находящегося в теле SOAP-сообщения соответствует имени сооб-

щения, которое определено в интерфейсе веб-сервиса.

100

Веб-сервисы

Запрос

<soap:Envelope

xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

<soap:Body>

<getProductDetails xmlns="http://warehouse.example.com/ws">

<productID>12345</productID>

</getProductDetails>

</soap:Body>

</soap:Envelope>

Ответ

<soap:Envelope

xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

<soap:Body>

<getProductDetailsResponse

xmlns="http://warehouse.example.com/ws">

<getProductDetailsResult>

<productID>12345</productID> <productName>Роутер NoName</productName>

<description>Роутер NoName, WiFi, LAN</description> <price>550</price>

<inStock>true</inStock>

</getProductDetailsResult>

</getProductDetailsResponse>

</soap:Body>

</soap:Envelope>

Рис. 38. Пример запроса и ответа посредством SOAP-сообщений

Как уже было сказано, стандарт SOAP обеспечивает одностороннюю пере-

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

зации связи в сети Интернет, т.к. большинство клиентов не имеют выделенных статических IP-адресов. Даже наоборот, чаще всего входящие соединения бло-

кируются сетевыми брандмауэрами.

Данная проблема решена в рамках стандартного связывания протокола

SOAP и протокола HTTP, реализующего паттерн поведения «запрос-ответ»

(анг. SOAP HTTP Binding).

101