‹s:element minOccurs="1" maxOccurs="1" name="SubtractResult" type="s:int"/›
‹/s:sequence›
‹/s:complexType›
‹/s:element›
Если вы имеете Web-метод, возвращающий или получающий пользовательские типы данных, они также появятся в контексте элемента ‹complexType›. Детали того, как с помощью Web-метода сделать доступными пользовательские типы данных .NET, мы рассмотрим позже. Для примера предположим, что вы определили Web-мeтод, возвращающий структуру с именем Point.
public struct Point {
public int x;
public int y;
public string pointName;
}
WSDL-описание для этой "сложной структуры" будет выглядеть примерно так.
‹s:complexType name="Point"›
‹s:sequence›
‹s:element minOccurs="1" maxOccurs="1" name="x" type="s:int" /›
‹s:element minOccurs="1'' maxOccurs="1" name="y" type= "s:int" /›
‹s:element minOccurs="0" maxOccurs="1" name="рointName" type="s:string" /›
‹/s:sequence›
‹/s:complexType›
Элемент ‹message›
Элемент ‹message› используется для определения формата обмена запросами и ответами данного Web-метода. Поскольку один Web-сервис позволяет передачу множества сообщений между отправителем и получателем, одному WSDL-документу позволяется определять множество элементов ‹message›. Как правило, в этих определениях используются типы, указанные в рамках элемента ‹types›.
Независимо от количества элементов ‹message›, определенных в документе WSDL, они обычно "присутствуют" парами. Первое определение представляет входной формат сообщения, а второе – выходной формат того же сообщения. Например, метод Subtract() Web-сервиса CalculatorWebService определяет следующие элементы ‹message›.
‹wsdclass="underline" message name="SubtractSoapIn"›
‹wsdclass="underline" part name="parameters" element="tns:Subtract" /›
‹/wsdclass="underline" message›
‹wsdclass="underline" message name="SubtractSoapOut"›
‹wsdclass="underline" part name="parameters" element="tns:SubtractResponse" /›
‹/wsdclass="underline" message›
Здесь вы видите только связь SOAP соответствующего сервиса. Как говорилось в начале этой главы, Web-сервисы XML могут вызываться с помощью SOAP или HTTP-методов GET и POST. Но если вы разрешите связь HTTP POST (соответствующие объяснения будут предложены позже), генерируемый WSDL-код должен продемонстрировать следующие данные ‹message›.
‹wsdclass="underline" message name="SubtractHttpPostIn"›
‹part name="n1" type="s:string" /›
‹part name="n2" type="s:string" /›
‹wsdclass="underline" /message›
‹wsdclass="underline" message name="SubtractHttpPostOut"›
‹part name="Body" element="s0:int" /›
‹wsdclass="underline" /message›
Элементы ‹message› сами по себе не слишком полезны. Однако на эти определения сообщений ссылаются другие части WSDL-документа.
Замечание. Не все Web-методы требуют и запроса, и ответа. Если Web-метод является "односторонним", для него необходим только элемент ‹message› запроса. Обозначить Web-метод, как односторонний, можно с помощью атрибута [SoapDocumentMethod].
Элемент ‹portType›
Элемент ‹portType› определяет различные связи, которые могут возникать между клиентом и сервером, и каждая такая связь представляется вложенным элементом ‹operation›. Несложно догадаться, что самыми типичными операциями здесь должны быть SOAP, HTTP GET и HTTP POST. Однако есть и другие операции. Например, односторонняя операция позволяет клиенту отправить сообщение данному Web-серверу, но не получить ответ (это похоже на вызов метода без ожидания возвращаемого значения). Операция "требование-ответ" позволяет серверу отправить, запрос во время ответа клиента (что можно рассматривать, как дополнение операции "запрос-ответ").
Чтобы проиллюстрировать формат необязательного вложенного элемента ‹operation›, рассмотрим WSDL-определение для метода Subtract().
‹wsdl portType name="CalculatorWebServiceSoap"›
‹wsdclass="underline" operation name="Subtract"›
‹wsdclass="underline" input message="tns:SubtractSoapIn" /›
‹wsdclass="underline" output message="tns:SubtractSoapOut" /›
‹/wsdclass="underline" operation›
‹wsdclass="underline" /portType›
Обратите внимание на то, как элементы ‹input› и ‹output› ссылаются на соответствующее имя сообщения, определенное в рамках элемента ‹message›. Если бы для метода Subtract() был разрешен HTTP-метод POST, вы бы увидели следующий дополнительный элемент ‹operation›.
‹wsdclass="underline" portType name="CalculatorWebServiceHttpPost"›
<wsdclass="underline" operation name="Subtract" ›
‹wsdclass="underline" input message="s0:SubtractHttpPostIn" /›
‹wsdclass="underline" output message= "s0:SubtractHttpPostOut" /›
‹wsdclass="underline" /operation›
‹wsdclass="underline" /portType›
Наконец, учтите то, что если данный Web-метод описан с помощью свойства Description, элемент ‹operation› будет содержать вложенный элемент ‹documentation›.
Элемент ‹binding›
Этот элемент указывает точный формат обмена GET, POST и SOAP. Это самый "многословный" из всех элементов, содержащихся в контексте корневого элемента ‹definition›. Вот, например, определение элемента ‹binding› с описанием того, как вызывающая сторона может взаимодействовать с Web-методом MyMethod(). используя SOAP.
‹wsdclass="underline" binding name="СаlculatorWebServiceSoap12" type="tns:CalculatorWebServiceSoap"›