ЯЗЫК ПРОГРАММИРОВАНИЯ С# 2005 И ПЛАТФОРМА .NET 2.0. 3-е издание

Как вы можете догадаться, для начала разработки Web-сервиса XML с создания WSDL-документа требуется очень хорошее знание грамматики WSDL, обсуждение которой в контексте этой главы не предусмотрено. Но мы рассмотрим базовую структуру WSDL-документа. Разобравшись в основах, вы сможете оценить пользу утилиты командной строки wsdl.exe.

Замечание. Самую свежую информацию о языке WSDL можно найти на страницах http://www.w3.org/tr/wsdl.

Определение WSDL-документа

Действительный документ WSDL открывается и закрывается корневым элементом ‹definitions›. В открывающем дескрипторе обычно определяются различные атрибуты xmlns. Они задают пространства имен XML, определяющие различные подчиненные элементы. Как минимум, элемент ‹definitions› должен указать пространство имен, где определены сами элементы WSDL . Для того чтобы быть полезным, открывающий дескриптор ‹definitions› должен, кроме того, указать пространства имен XML, определяющие простые типы данных WSDL, типы XML-схемы, элементы SOAP, а также целевое пространство имен. Например, вот как выглядит раздел ‹definitions› для нашего Web-сервиса калькулятора.

‹?xml version="1.0" encoding="utf-8"?›
‹wsdl:definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:tm="http://microsoft.com/wsdl/mime/textMatching/"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns-mime="http://schemas.xmlsoap.org/wsdl/mime/"
xmlns:tns="http://www.IntertechTraining.com/"
xmlns:s="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/"
xmlns:http="http://schemes.xmlsoap.оrg/wsdl/http/"
targetNamespace="http://www.IntertechTraining.com/"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"›
…
‹/wsdl:definitions›

В контексте корневого элемента вы можете найти пять подчиненных элементов. Общий вид WSDL-документа должен быть примерно таким.

‹?xml version="1.0" encoding="utf-8"?›
‹wsdl:definitions …›
 ‹wsdl:types›
 ‹!-- Список типов, доступных для данного Web-сервиса -– ›
 ‹wsdl:/types›
 ‹wsdl:message›
 ‹!-- Формат сообщений -– ›
 ‹wsdl:/message›
 ‹wsdl:portType›
 ‹!-- Информация портов -– ›
 ‹wsdl:/portType›
 ‹wsdl:binding›
 ‹!-- Информация связывания -– ›
 ‹wsdl:/binding›
 ‹wsdl:service›
 ‹!-– Информация о самом Web-сервисе XML -– ›
 ‹wsdl:/service›
‹wsdl:/definitions›

Как и следует ожидать, каждый из этих подчиненных элементов будет содержать дополнительные элементы и атрибуты, уточняющие описание имеющихся возможностей. Давайте по очереди рассмотрим наиболее важные из допустимых узлов.

Элемент ‹types›

Сначала мы рассмотрим элемент ‹types›, который содержит описания всех типов данных, предлагаемых Web-сервисом. Вы, возможно, знаете, что язык XML сам определяет ряд "базовых" типов данных, и все они определены в рамках пространства имен XML(которое должно быть указано в контексте корневого элемента ‹definitions›). Возьмем, например, метод Subtract нашего Web-сервиса калькулятора, имеющий два входных параметра целочисленного типа. В терминах WSDL тип System.Int32 среды CLR описывается в контексте элемента ‹complexType›.

‹s:еlement name= "Subtract"›
 <s:comlexType>
 ‹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:sequence›
 ‹/s:complexType›
‹/s:element›

Целое число, возвращаемое методом Subtract, также описывается в рамках элемента ‹types›.

‹s:element name= "SubtractResponse"›
 ‹s:complexType›
 ‹s:sequence›
 ‹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" /›