‹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›.
Этот элемент указывает точный формат обмена 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›, который указывает характеристики самого 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-код (можете проверить сами, если вас это интересует).
Снова о протоколах связи Web-сервисов XML
Строго говоря, Web-сервисы XML могут использовать для коммуникации любой RPC-протокол (например, DCOM или CORBA). Однако большинство Web-серверов встраивает соответствующие данные в тело HTTP-запроса и переправляет их адресату, используя для этого один из трех базовых способов связи (табл. 25.4).
Хотя каждый из подходов обеспечивает один и тот же результат (вызов Web-метода), от выбора протокола зависит то, какие типы параметров (и типы возвращаемых значений) могут пересылаться между заинтересованными сторонами. Протокол SOAP предлагает наибольшую гибкость, поскольку сообщения SOAP позволяют осуществлять обмен сложными типами данных (а также двоичными файлами) между вызывающей стороной и Web-сервисом XML. Однако для полноты давайте выясним роль стандартных HTTP-методов GET и POST.
Таблица 25.4. Режимы связи Web-сервисов XML
Режим связи Описание HTTP-метод GET В режиме обмена GET параметры добавляются к строке запроса данного URL HTTP-метод POST В режиме обмена POST данные встраиваются в заголовок HTTP-сообщения, а не добавляются к строке запроса SOAP SOAP является протоколом связи, определяющим правила передачи данных и вызова методов в сети с помощью XML
Связь HTTP GET и HTTP POST
Хотя GET и POST кажутся привычными конструкциями, этот метод пересылки недостаточно гибок для обслуживания таких сложных элементов, как структуры и классы. При использовании SET и POST вы можете взаимодействовать с Web-методами, используя только типы, указанные в табл. 25.5.
Таблица 25.5. Типы данных, поддерживаемые методами GET и POST
Типы данных Описание Перечни GET и POST поддерживают передачу типов System.Enum.NET, поскольку эти типы представляются в виде статических строковых констант Простые массивы Вы можете использовать массивы любых примитивных типов Строки GET и POST осуществляют передачу любых числовых данных в виде строковых маркеров.
Строка здесь на самом деле обозначает строковое представление среды CLR для таких примитивов, как Int16, Int32, Int64, Boolean
, Single, Double, Decimal и т.д.
По умолчанию HTTP-связь GET и POST не разрешена для удаленного вызова Web-сервисов XML. Однако HTTP-связь POST активизирована для вызова машиной локальных Web-сервисов (на самом деле именно этот режим использует автоматически генерируемая страница тестирования). Эти установки указываются в файле machine.config с помощью элемента ‹protocols›. Вот как выглядит соответствующий фрагмент
‹!-- В файле machine. config --›
‹webServices›
‹protocols›
‹add name="HttpSoap1.2" /›
‹add name="HttpSoap" /›
‹add name="Documentation" /›
‹!-- HTTP GET/POST отключены! --›
‹!-- ‹add name="HttpPost''/› --›
‹!-- ‹add name="HttpGet"/› --›
‹!-- Используется страницей тестирования Web-сервиса --›
‹add name="HttpPostLocalhost" /›
‹/protocols›
‹/webServiсes›
Чтобы снова разрешить использование HTTP-методов GET или POST для Web-сервиса, добавьте имена HttpPost и HttpGet в соответствующий локальный файл Web.config.
‹configuration›
‹system.web›
‹webServices›
‹protocols›
‹add name="HttpPost"/›
‹add name="HttpGet"/›
‹/protocols›
‹/webServices›
‹/system.web›
‹/configuration›
Снова напоминаем, что при использовании стандартных HTTP-методов GET и POST у вас нет возможности строить Web-методы, допускающие использование составных типов (например, DataSet ADO.NET или пользовательский тип структуры) в качестве параметров или возвращаемых значений. Для простых Web-сервисов это ограничение может быть вполне приемлемым. Однако при использовании связи SOAP вы можете строить гораздо более совершенные Web-сервисы XML.
Полный анализ возможностей SOAP выходит за рамки этого текста, однако следует понимать, что SOAP нельзя назвать специальным протоколом, который может использоваться наряду с другими существующими протоколами Интернет (HTTP, SMTP и др.). Общая задача SOAP, тем не менее, остается той же: обеспечить независимый от языка и платформы механизм вызова методов, использующих составные типы. Для этого SOAP преобразует каждый метод в сообщение SOAP.
Сообщение SOAP состоит из двух основных секций. Во-первых, есть конверт SOAP, который можно понимать, как абстрактный контейнер для соответствующей информации. Во-вторых, есть правила, которые используются для описания информации в сообщении (размещаемой в теле сообщения SOAP). Необязательная третья секция (заголовок SOAP) может использоваться для того, чтобы указать общую информацию, касающуюся самого сообщения (например, информацию безопасности или транзакции).
‹soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"›
‹soap:Header›
‹!-- Необязательная информация заголовка --›
‹/soap:Header›
‹soap:Body›
‹!-- Информация вызова метода --›
‹/soap:Body›
‹/soap:Envelope›
Просмотр сообщения SOAP
Хотя при создании Web-сервиcов XML в рамках платформы .NET от вас не требуется понимания всех деталей SOAP, вы можете увидеть формат сообщения SOAP дня каждого доступного Web-метода с помощью автоматически генерируемой страницы тестирования. Например, если щелкнуть на ссылке для метода Add() нашего CalculatorWebService, вы увидите следующий запрос SOAP 1.1.
