Иллюстрированный самоучитель по Architecture .NET

Особенности форматирования данных согласно спецификации SOAP

Если вы попытаетесь активизировать Web-службу прямо сейчас, то будет выдано следующее сообщение об ошибке:

System.Exception: There was an error generating the XML
document. – > System.Exception: A circular reference
was detected while serializing an object of type Customer.
at System.Xml.Serialization.XmlSerializationWriter.
WriteStartElement(String name, String ns, Object o,
Boolean writePrefixed)
…
at System.Xml.Serialization.XmlSerializer.Serialize
(XmlWriter xmlWriter, Object o,
XmlSerializerNamespaces namespaces)
…

Пере вод такой [Добавлен редактором русского перевода. – Прим. ред.]:

Система.Исключение: Была ошибка при генерации XML-
документа. 
Система.Исключение: циклическая ссылка
была обнаружена при преобразовании в последовательную
форму объекта типа
Клиент.
в Системе.Xml.Преобразование в последовательную
форму XmlSerializationWriter.
WriteStartElement (Строковое имя, Строка ns, Объект о,
Булева переменная wrxtePrefixed)
…
в Системе.Xml.Преобразование в последовательную
форму.XmlSerializer.Преобразовать в последовательную форму
(XmlWriter xmlWriter, Объект о,
XmlSerializerNamespaces пространство имен)
…

Причина ошибки в том, что параллельно-последовательный преобразователь языка XML, который используется Web-службой, не умеет обрабатывать циклические ссылки Если в тексте закомментировать строку cust2.next = custl, а затем снова скомпоновать проект и скопировать сборку WebService.dll в каталог bin, Web-служба возвратит следующий ответ [В приведенном ниже файле для удобства ориентирования вставлены комментарии вида < ' – комментарий – >, в самом файле, их, естественно, не будет – Прим ред].

<name>John Smith</name> <'– имя – Джон Смит – >
<id>l</id> <'– идентификатор › 
<next>
<name>Mary Smith</name> <'– имя – Мэри Смит › 
<id>2</id> <'– идентификатор › <next xsi:nil="true" />
</next>

В этом случае, в отличие от случая с распределенными приложениями, реальная взаимосвязь между объектами не имеет никакого значения. Но как объяснить то, что протокол SOAP, посредством которого обмениваются данными удаленные приложения, построенные на платформе NET, может передавать отношения между объектами, а протокол SOAP, используемый Web-службами, этого делать не умеет.

Протокол SOAP обрабатывает сложные отношения (множественное наследование, графы и тому подобное), существующие в объектной модели Схема XML (XML Schema) отражает наследование обрабатываемого XML-документа Документ при этом можно представить в виде дерева с единственным корнем В этом дереве каждый узел имеет одного родителя. Так как протокол SOAP разрабатывался тогда, когда Схема XML (XML Schema) еще не была завершена, в него вошли некоторые расширения, позволяющие обрабатывать подобные случаи. Эти расширения описаны в разделе 5 (Section 5) спецификации SOAP. Поэтому их часто называют правилами кодирования раздела 5 (Section 5 encoding rules).

Именно в правилах кодирования раздела 5 сказано, что расширения протокола SOAP нельзя использовать, если кодируемый документ будет проверяться на соответствие схеме. Следовательно, NET-XML-классы, выполняющие сериализацию (преобразование в последовательную форму), эти расширения и не используют. С другой стороны, параллельно-последовательный преобразователь, который обрабатывает удаленные объекты, развернутые на платформе NET, не производит проверку правильности схемы обрабатываемого документа. Для него первостепенную роль играет точность преобразования удаленных объектов.

Поэтому параллельно-последовательный преобразователь использует все правила раздела 5 Чтобы максимально расширить функциональную совместимость (способность взаимодействия), в реализации Web-служб стремятся использовать формы, совместимые со Схемой XML (XML Schema), то есть, формы, которые можно проверить на соответствие схеме [Читатели, знакомые с моделью компонентных объектов Microsoft (COM), могут попытаться вспомнить, как заместитель обрабатывает совпадение имен указателей в том случае, когда атрибут pomter_default(unique) не используется.]. Конечно, можно привести контраргумент, что в том случае, когда XML-код генерирует машина, проверка правильности схемы не так уж и важна Но в промышленности такой подход пока еще не используется [Здесь мы не будем детально обсуждать, а лишь упомянем о том, что существуют атрибуты, с помощью которых вы можете включить в класс вашей Web-службы методы, использующие правила кодирования раздела 5].

Чтобы приложения и Web-службы, построенные на платформе различных операционных систем, могли взаимодействовать, сначала опишите Web-службы с помощью Схемы XML (Schema XML), и лишь затем опишите их с помощью языка WSDL. Запустив сервисную программу Wsdl с ключом /server, вы можете создать абстрактный класс, который может быть использован в качестве основы для файла.asmx. Если же начать с объектной модели, а затем описать полученную модель с помощью Схемы XML (XML Schema), то полученные системы, скорее всего, будут несовместимы. Конечно, когда используются лишь простые типы и структуры данных, никаких проблем возникнуть не должно. Но если у вас уже имеются объектные модели, тогда вам может понадобиться дополнительный слой (упаковщик), который интерпретирует то, что происходит в слое Web-служб, в терминах объектной модели.

Иными словами, такой упаковщик переводит (транслирует) обращения Web-служб на язык объектной модели. Добиться нормальной совместной работы объектных моделей, построенных на разных платформах, – вот наиболее трудная техническая задача в технологии Web-служб [Рассматривать здесь вопросы безопасности Web-служб мы не планируем Отметим лишь, что если не удается построить даже объектные модели, работа которых подчинялась бы некоторым правилам, то говорить о безопасности уже не приходится.].

Если Вы заметили ошибку, выделите, пожалуйста, необходимый текст и нажмите CTRL + Enter, чтобы сообщить об этом редактору.