Симон Робинсон - C# для профессионалов. Том II

По этой причине здесь не будет представлено подробное рассмотрение, но будет показано несколько простых запросов и ответов SOAP, чтобы можно было получить некоторое представление о том, что происходит за сценой.

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

int DoSomething(String stringParam, int intParam)

Далее представлены требуемые для этого заголовки SOAP и body. Вверху указан адрес службы Web (об этом больше будет сказано далее):

POST /SomeLocation/myWebService.asmx HTTP/1.1

Host: karlivaio

Content-Type: text/xml; charset=utf-8

Content-Length: length

SOAPAction: "http://tempuri.org/DoSomething"

xmlns:xsd="http://www.w3.org/2000/10/XMLSchema"

xmlns:soap="http://schemas.xmlsoap.org/soap/envelope">

string

int

Параметр length определяет здесь общую длину содержимого в байтах и будет меняться в зависимости от значений, посланных в параметрах string и int.

Используемое пространство имен soap определяет различные элементы, которые применяются для создания сообщения. При отправке этого кода через HTTP реальные посылаемые данные будут несколько другими. Например, можно было бы вызвать приведенный выше метод с помощью простого метода GET:

GET /PCSWebSrv1/Service1.asmx/AddEvent?stringParam=string&intParam= int HTTP/1.1 Host.: hostname

Ответ SOAP этого метода будет следующим:

HTTP/1.1 200 OK

Content-Type: text/xml; charset=utf-8

Content-Length: length

xmlns:xsd="http://www.w3.org/2000/10/XMLSchema"

xmlns:soap="http://schemas.xmlsoap.org/soap/envelope">

int

где length снова изменяется согласно содержимому, в этом случае int.

И снова реальный ответ через HTTP может быть значительно проще, например:

HTTP/1.1 200 OK

Content-Type: text/xml; charset=utf-8

Content-Length: length

int

Это совсем простой формат XML.

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

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

WSDL имеет синтаксис, полностью соответствующий XML, и определяет службы Web по доступным методам, типам данных, используемых этими методами, форматам сообщений запросов и ответов, посылаемых методам и из методов с помощью различных протоколов (чистый SOAP, HTTP GET и т.д.), и различным связываниям между упомянутыми выше элементами.

Возможно, что наиболее важной частью файла WSDL является раздел определения типов данных. Он использует схемы XML для описания формата обмена данными и их отношениями с помощью элементов XML.

Например, метод службы Web, использованной в качестве примера в последнем разделе:

int DoSomething(string stringParam, int intParam)

будет иметь типы, объявленные для запроса следующим образом:

xmlns="http://schemas.xmlsoap.org/wsdl/"

... другие пространства имен ... >

targetNamespace="http://tempuri.org/">

... другие определения ...

Все, что требуется для запросов и ответов SOAP и HTTP, которые мы видели ранее, определяется этими типами, которые далее в этом файле связываются с такими операциями. Все типы определяются с помощью стандартного синтаксиса схемы XML, например:

Этот код определяет, что элемент с именем имеет элемент-потомок с именем , который содержит целое число.

Если мы имеем доступ к коду WSDL для службы Web, то мы можем его использовать. Как мы скоро увидим, это не так уж трудно сделать.

Теперь, когда мы кратко ознакомились с SOAP и WSDL, пришло время посмотреть, как создаются и используются службы Web.

Обсуждение служб Web включает два вопроса:

□ Создание служб Web, которое связано с написанием служб Web и размещением их на серверах Web.

□ Использование служб Web, которое связано с применением на стороне клиента созданных служб.

Службы Web создают, либо помещая код прямо в файлы .asmx, либо, ссылаясь на классы службы Web из этих файлов. Как и со страницами ASP.NET, создание службы Web в VS.NET применяет последний подход, и он также будет использоваться для целей демонстрации.

Создание проекта службы Web, называемой PCSWebSrv1, как показано выше, приводит, как и для проекта приложения Web, к аналогичному множеству созданных файлов. Фактически, единственное различие состоит в том, что вместо создания файла с именем WebForm1.aspxсоздается файл с именем Service1.asmx. Созданный файл .vsdiscoотвечает за идентификацию службы Web, чтобы система Visual Studio .NET, как мы вскоре увидим, могла добавить на него ссылку Web.