WCF: немного об интероперабильности

Часть 3: WSDL и document/literal

Итак, WSDL описывает веб-сервис, а WSDL binding описывает, каким образом сервис взаимодействует с протоколом SOAP, т.е. по каким правилам формируются SOAP сообщения. WSDL SOAP binding может соответствовать Remote Procedure Call (RPC) или document стилю. К этому еще добавляются encoded или literal свойства сериализации. Итого получаем четыре возможных варианта (на самом деле пять, т.к. еще есть document/literal wrapped), которые определяют каким образом WSDL binding "преобразовывается" в SOAP сообщение.

Document : <soap:Body> содержит один или несколько дочерних элементов (частей), <soap:Body> содержит те элементы, относительно которых договорились (знают) отправитель и получатель, т.е. других специальных указаний нет.
RPC: RPC подразумевает, что <soap:Body> содержит элемент с именем метода или удаленных процедур, которые будут вызываться. В свою очередь, этот элемент содержит элемент для каждого параметра процедуры/метода.

Endcoded: сериализация выполняется в соответствии со спецификацией SOAP. Правила указывают, каким образом должны быть сериализованы объекты, массивы и т.п.

Literal: сериализация данных выполняется в соответствии со некой схемой (например, W3C XML Schema).

Давайте посмотрим на примеры, чтобы на практике понять различия.

RPC/encoded

<soap:envelope> 
   <soap:body> 
      <myMethod> 
         <x xsi:type="xsd:int">5</x> 
         <y xsi:type="xsd:float">5.0</y> 
      </myMethod> 
   </soap:body> 
</soap:envelope> 

RPC/literal

<soap:envelope> 
   <soap:body> 
      <myMethod> 
         <x>5</x> 
         <y>5.0</y> 
      </myMethod> 
   </soap:body> 
</soap:envelope> 

Document/encoded
Исключаем, т.к. не поддерживается WS-I спецификацией.

Document/literal

<soap:envelope> 
   <soap:body> 
      <Element1>5</Element1> 
      <Element2>5.0</Element2> 
   </soap:body> 
</soap:envelope>

Document/literal wrapped

<soap:envelope> 
   <soap:body> 
      <myMethod> 
         <x>5</x> 
         <y>5.0</y> 
      </myMethod> 
   </soap:body> 
</soap:envelope>

По умолчанию WCF использует document/literal wraped представление, тогда как другие платформы могут использовать, например, rpc/literal. Для конечных клиентов и прокси все преобразования должны быть прозрачны, т.е. SOAP ответ ответы/запросы должны генерировать автоматически в соответствии с тем типом, который объявлен в WSDL сервиса. Но, к сожалению, так бывает не всегда и иногда возникают ошибки, связанные с тем, что та или иная платформа по умолчанию использует другой тип, а не тот, что объявлен в WSDL стороннего сервиса. Что можно сделать в такой ситуации? Например, указать WCF использовать RPC/encoded (и в очередной раз мы будем использовать XmlSerializer):

[OperationContract]  
[XmlSerializerFormat(Style = OperationFormatStyle.Rpc, Use = OperationFormatUse.Encoded)]  
string RPCEncoded(int value)