Элемент ‹portType›

Элемент ‹portType› определяет различные связи, которые могут возникать между клиентом и сервером, и каждая такая связь представляется вложенным элементом ‹operation›. Несложно догадаться, что самыми типичными операциями здесь должны быть SOAP, HTTP GET и HTTP POST. Однако есть и другие операции. Например, односторонняя операция позволяет клиенту отправить сообщение данному Web-серверу, но не получить ответ (это похоже на вызов метода без ожидания возвращаемого значения). Операция "требование-ответ" позволяет серверу отправить, запрос во время ответа клиента (что можно рассматривать, как дополнение операции "запрос-ответ").

Чтобы проиллюстрировать формат необязательного вложенного элемента ‹operation›, рассмотрим WSDL-определение для метода Subtract().

‹wsdl portType name="CalculatorWebServiceSoap"›

 ‹wsdl:operation name="Subtract"›

  ‹wsdl:input message="tns:SubtractSoapIn" /›

  ‹wsdl:output message="tns:SubtractSoapOut" /›

 ‹/wsdl:operation›

‹wsdl:/portType›

Обратите внимание на то, как элементы ‹input› и ‹output› ссылаются на соответствующее имя сообщения, определенное в рамках элемента ‹message›. Если бы для метода Subtract() был разрешен HTTP-метод POST, вы бы увидели следующий дополнительный элемент ‹operation›.

‹wsdl:portType name="CalculatorWebServiceHttpPost"›

 <wsdl:operation name="Subtract" ›

  ‹wsdl:input message="s0:SubtractHttpPostIn" /›

  ‹wsdl:output message= "s0:SubtractHttpPostOut" /›

 ‹wsdl:/operation›

‹wsdl:/portType›

Наконец, учтите то, что если данный Web-метод описан с помощью свойства Description, элемент ‹operation› будет содержать вложенный элемент ‹documentation›.

Элемент ‹binding›

Этот элемент указывает точный формат обмена GET, POST и SOAP. Это самый "многословный" из всех элементов, содержащихся в контексте корневого элемента ‹definition›. Вот, например, определение элемента ‹binding› с описанием того, как вызывающая сторона может взаимодействовать с Web-методом MyMethod(). используя SOAP.

‹wsdl:binding name="СаlculatorWebServiceSoap12" type="tns:CalculatorWebServiceSoap"›

 ‹soap12:binding transport="http://schemas.xmlsoap.org/soap/http" /›

  ‹wsdl:operation name= "Subtract"›

  ‹soap12:operation soapAction="http://www.IntertechTraining.com/Subtract" style="document" /›

  ‹wsdl:input›

   ‹soap12:body use="literal" /›

  ‹/wsdl:input›

  ‹wsdl:output›

   ‹soap12:body use="literal" /›

  ‹/wsdl:output›

 ‹/wsdl:operation›

‹/wsdl:binding›

Элемент ‹service›

Наконец, у нас есть элемент ‹service›, который указывает характеристики самого Web-сервиса (например, его URL). Главной задачей этого элемента является описание множества портов, открытых данным Web-сервером. Для этого элемент ‹services› может использовать любое число вложенных элементов ‹port› (не путайте их с элементом ‹portType›). Вот как выглядит элемент ‹service› для CalculatorWebService.

‹wsdl:service name="CalculatorWebService"›

 ‹wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"›

Чудесный Web-сервис калькулятора

 ‹/wsdl:documentation›

 ‹wsdl:port name="CalculatorWebServiceSoap" binding="tns:CalculatorWebServiceSoap" ›

  ‹soap:address location="http://localhost:1109/CalculatorWebService/ Service.asmx" /›

 ‹/wsdl:port›

 ‹wsdl:port name="CalculatorWebServiceSoap12" binding= "tns:CalculatorWebServiceSoap12"›

  ‹soap12:address location="http://localhost:1109/CalculatorWebService/Service.asmx" /›

 ‹/wsdl:port›

‹/wsdl:service›

Итак, как видите, WSDL-код, автоматически возвращаемый сервером ITS, не является сверхсложным, но, поскольку WSDL представляет собой грамматику на основе XML, этот код достаточно "многословен". Тем не менее, теперь вы должны лучше понимать роль WSDL, так что давайте рассмотрим немного подробнее протоколы связи Web-сервисов XML.

Замечание. Напомним, что пространство имен System.Web.Services.Description содержит множество типов, которые позволяют программно читать и обрабатывать "сырой" WSDL-код (можете проверить сами, если вас это интересует).