Что такое Microsoft.NET?

  35790931     

Язык описания Webслужб (Web Services



Язык описания Web-служб (Web Services Description Language — WSDL)

Протокол SOAP описывает передаваемые данные Интерфейс Web-служб он не описывает Данные, передаваемые по протоколу SOAP, можно закодировать и самостоятельно Но лучше для этой цели создать вспомогательные классы (классы-заместители), которые будет использовать программа-клиент Ведь чтобы самостоятельно закодировать данные, необхсцшо знать спецификацию SOAP до мельчайших подробностей и провести синтаксичесий разбор возвращаемого XML-пакета.
Язык WSDl(Web Services Description Language — язык описания Web-служб) предназначен для опиания интерфейса Web-служб. В качестве примера мы опишем с помощью языка WSDL нтерфейс Web-службы SimpleWebService, имеющей один метод Add (Сложение). Ипользовать язык WSDL для описания интерфейса Web-служб, которые для передачи днных используют другие протоколы, а не протокол SOAP, мы не будем. Чтобы увидетюписание на языке WSDL Web-службы SimpleWebService, введите в адресной строе броузера следующий унифицированный указатель информационного ресурса (URL)http: //localhost/SimpleWebService/Add.asmx?WSDL. Описание Web-службы в языке WSDL состоит из нескольких разделов. В разделе <types> (<типы>) опредлены следующие типы:

  • Add (Сложение). Описывает данные, передаваемые Web-службе по протоколу SOAP;
  • Addresponse. Описывает результаты, возвращаемые Web-службой клиенту по протжолу SOAP.

Тип Add (Сложение) имеет два элемента, каждый из которых встречается лишь один раз. Элементьимеют имена х и у и принадлежат типу long, определенному спецификацией XSD (XMLSchema Definition — Определение схемы XML). Возвращаемый параметр AddResponsecoдepжит один элемент AddResult, который встречается один раз и также принадлеэмт типу long, определенному, как мы уже знаем, в спецификации XSD (XML SchemaDefinition — Определение схемы XML). Обратите внимание, как рассмотренные типы >ке использовались ранее, при описании протокола SOAP.

<types>
<s:elemerz name="Add"> <s: comjl.exType> <s: sequence>
<salement 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>
<s:element name="AddResponse">
<s:complexType>
<s:sequence>
<s:element minOccurs="1" maxOccurs="1"
name="AddResult" type="s:int" />
</s:sequence>
</s:complexType>
</s :elment>
</types>



В разделе :message> (<сообщение>) описывается использование этих типов в качестве параметре.

<message name="AddSoapIn"> <!-- сообщение -->
<part name="parameters" element="s0:Add" /> <!-- параметры -->
</message> <!-- сообщение -->
<message name="AddSoapOut"> <!-- сообщение -->
<part name="parameters" element="s0:AddResponse" />
<!-- параметры -->
</message> <!-- сообщение -->

В разделе <portType> (тип порта) с Web-службой сопоставляются отдельные Web-методы, которые описаны в элементах <operation> (<действие>). Если бы данная Web-служба использовала большее количество методов, тогда в разделе <portType> (тип порта) было бы больше элементов operation (действие) [Читатели, склонные проводить параллели, увидят здесь аналогию с интерфейсом модели компонентных объектов Microsoft (COM). ]. Операции ввода и вывода каждого метода связаны с соответствующими сообщениями, которые были определены раньше.

<portType name="TestSoap">
<operation name="Add"> <!-- операция -->
<input message="s0:AddSoap!n" />
<output message="s0:AddSoapOut" />
</operation> <!-- операция -->
</portType>

В разделе <binding> (<связывание>) каждому действию ставится в соответствие способ кодирования и протокол передачи данных.

<binding name="TestSoap" type="s0:TestSoap">
<soap:binding
transport="http://sohemas.xmlsoap.org/soap/http"
style="dooument" /> <!-- стиль = "документ" -->
<operation name="Add"> <!-- название операции -->
<soap:operation soapAction="http://tempuri.org/Add" style="document" />
<!-- стиль = "документ -->
<input> <!-- ввод -->
<soap:body use="literal" />
</input> <!-- ввод -->
<output> <!-- вывод -->
<soap:body use="literal" />
</output> <!-- вывод -->
</operation> <!-- операция -->
</binding>

В разделе <service> (<служба>) указывается порт, используемый Web-службой, и адрес, по которому можно активизировать Web-службу.

<service name="Test"> <!-- имя = "Испытание -->
<
port name="ТезtSoap" binding="s0:TestSoap">
<!-- порт -->
<soap:address location=
"http://localhost/SimpleWebService/Add.asmx" />
</port> <!-- порт -->
</service>




Содержание раздела