Поделиться через

Протокол надежного обмена сообщениями, версия 1.1

  • Статья

В этом разделе описаны особенности реализации в Windows Communication Foundation (WCF) протокола WS-ReliableMessaging (версия 1.1, февраль 2007), необходимого для взаимодействия с использованием транспорта HTTP. В реализации WCF соблюдена спецификация WS-ReliableMessaging с учетом описанных в этом разделе ограничений и разъяснений. Обратите внимание, что протокол WS-ReliableMessaging версии 1.1 реализуется начиная с версии .NET Framework, версия 3.5.

Версия протокола WS-ReliableMessaging от февраля 2007 г. реализована в WCF с помощью класса ReliableSessionBindingElement.

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

  • инициатор: клиент, инициирующий создание последовательности сообщений WS-Reliable;

  • респондент: служба, получающая запросы инициатора.

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

Префикс

Пространство имен

wsrm

http://docs.oasis-open.org/ws-rx/wsrm/200702

netrm

https://schemas.microsoft.com/ws/2006/05/rm

s

http://www.w3.org/2003/05/soap-envelope

wsa

https://schemas.xmlsoap.org/ws/2005/08/addressing

wsse

http://docs.oasis-open.org/wss/2004/01/oasis-200401-wssecurity-secext-1.0.xsd

wsrmp

http://docs.oasis-open.org/ws-rx/wsrmp/200702

netrmp

https://schemas.microsoft.com/ws-rx/wsrmp/200702

wsp

(WS-Policy 1.2 или WS-Policy 1.5)

Обмен сообщениями

Создание последовательности

В WCF реализованы сообщения CreateSequence и CreateSequenceResponse, позволяющие установить последовательность системы надежного обмена сообщениями. Действуют следующие ограничения.

  • B1101: инициатор WCF использует одну и ту же ссылку в качестве конечных точек ReplyTo, AcksTo и Offer/Endpoint в сообщении CreateSequence.

  • R1102: адреса ссылок на конечные точки AcksTo, ReplyTo и Offer/Endpoint в сообщении CreateSequence должны иметь идентичные строковые представления, чтобы они совпадали на уровне октетов.

    • Респондент WCF перед созданием последовательности проверяет, что фрагменты ссылок на конечные точки AcksTo, ReplyTo и Endpoint, обозначающие универсальный код ресурса (URI), совпадают.

  • R1103: ссылки на конечные точки AcksTo, ReplyTo и Offer/Endpoint в сообщении CreateSequence должны иметь один и тот же набор параметров ссылок.

    • В WCF предполагается, что параметры ссылок на конечные точки AcksTo, ReplyTo и Offer/Endpoint в сообщении CreateSequence совпадают, поэтому в подтверждениях и сообщениях встречной последовательности используются параметры ссылки на конечную точку ReplyTo.

  • B1104: инициатор WCF не создает необязательный элемент Expires или Offer/Expires в сообщении CreateSequence.

  • B1105: при обращении к сообщению CreateSequence респондент WCF использует значение Expires в элементе CreateSequence в качестве значения Expires в элементе CreateSequenceResponse. В противном случае респондент WCF считывает и игнорирует значения Expires и Offer/Expires.

  • B1106: при обращении к сообщению CreateSequenceResponse инициатор WCF считывает необязательное значение Expires, но не использует его.

  • B1107: инициатор и респондент WCF всегда создают необязательный элемент IncompleteSequenceBehavior в элементах CreateSequence/Offer и CreateSequenceResponse.

  • B1108: в WCF в элементе IncompleteSequenceBehavior используются только значения DiscardFollowingFirstGap и NoDiscard.

    • Протокол WS-ReliableMessaging использует механизм Offer для формирования двух связанных встречных последовательностей, которые составляют сеанс.

  • B1109: если сообщение CreateSequence содержит элемент Offer, то односторонний респондент WCF отклоняет предложенную последовательность, отправляя в ответ сообщение CreateSequenceResponse без элемента Accept.

  • B1110: если респондент отклоняет предложенную последовательность, инициатор WCF прерывает созданную последовательность.

  • B1111: если сообщение CreateSequence не содержит элемент Offer, двусторонний респондент WCF отклоняет предложенную последовательность, отправляя в ответ ошибку CreateSequenceRefused.

  • R1112: при установке с помощью механизма Offer двух встречных последовательностей, свойство [address] ссылки на конечную точку CreateSequenceResponse/Accept/AcksTo должно с точностью до байта совпадать с универсальным кодом ресурса (URI) назначения сообщения CreateSequence.

  • R1113: при установке с помощью механизма Offer двух встречных последовательностей, все сообщения от инициатора к респонденту в обеих последовательностях должны отправляться по одной и той же ссылке на конечную точку.

В WCF протокол WS-ReliableMessaging используется для установки надежных сеансов между инициатором и респондентом. Реализация протокола WS-ReliableMessaging в WCF обеспечивает создание надежного сеанса для односторонней связи, обмена запросами и ответами и для полностью двустороннего обмена сообщениями. Механизм Offer в сообщениях CreateSequence и CreateSequenceResponse протокола WS-ReliableMessaging позволяет устанавливать две связанные встречные последовательности и обеспечивает протокол сеанса, который можно использовать во всех конечных точках обмена сообщениями. Поскольку платформа WCF гарантирует безопасность таких сеансов, включая сквозную защиту для обеспечения целостности сеанса, она позволяет проверять, что сообщения, предназначенные одной и той же стороне, достигнут одной и той же точки назначения. Кроме того, это делает возможным передачу подтверждений последовательностей в сообщениях приложений. Таким образом, ограничения R1102, R1112 и R1113 относятся к WCF.

Пример сообщения CreateSequence.

<s:Envelope>
  <s:Header>
    <wsa:Action s:mustUnderstand="1">http://docs.oasis-open.org/ws-rx/wsrm/200702/CreateSequence</wsa:Action>
    <wsa:MessageID>urn:uuid:949cca61-8813-42ff-ab33-18d9e3fa82fa</wsa:MessageID>
    <wsa:ReplyTo>
        <wsa:Address>http://Business456.com/clientA</wsa:Address> 
    </wsa:ReplyTo>
    <wsa:To s:mustUnderstand="1">http://BusinessABC.com/serviceA</wsa:To>
  </s:Header>
  <s:Body>
    <wsrm:CreateSequence>
      <wsrm:AcksTo>
        <wsa:Address>http://Business456.com/clientA</wsa:Address>
      </wsrm:AcksTo>
      <wsrm:Offer>
        <wsrm:Identifier>urn:uuid:066b4730-fc82-458a-a5c1-210be4fb4e4e</wsrm:Identifier>
        <wsrm:Endpoint>
          <wsa:Address>http://Business456.com/clientA</wsa:Address>
        </wsrm:Endpoint>
        <wsrm:IncompleteSequenceBehavior>DiscardFollowingFirstGap</wsrm:IncompleteSequenceBehavior>
      </wsrm:Offer>
    </wsrm:CreateSequence>
  </s:Body>
</s:Envelope>

Пример сообщения CreateSequenceResponse.

<s:Envelope>
  <s:Header>
    <wsa:Action s:mustUnderstand="1">http://docs.oasis-open.org/ws-rx/wsrm/200702/CreateSequenceResponse</wsa:Action>
    <wsa:RelatesTo>urn:uuid:949cca61-8813-42ff-ab33-18d9e3fa82fa</wsa:RelatesTo>
    <wsa:To s:mustUnderstand="1">http://Business456.com/clientA</wsa:To>
  </s:Header>
  <s:Body>
    <wsrm:CreateSequenceResponse>
      <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>
      <wsrm:IncompleteSequenceBehavior>DiscardFollowingFirstGap</wsrm:IncompleteSequenceBehavior>
      <wsrm:Accept>
        <wsrm:AcksTo>
          <wsa:Address>http://BusinessABC.com/serviceA</wsa:Address>
        </wsrm:AcksTo>
      </wsrm:Accept>
    </wsrm:CreateSequenceResponse>
  </s:Body>
</s:Envelope>

Закрытие последовательности

В WCF для закрытия последовательности системы надежного обмена сообщениями по инициативе источника используются сообщения CloseSequence и CloseSequenceResponse. Точка назначения системы надежного обмена сообщениями WCF не инициирует закрытие сеанса, а источник системы надежного обмена сообщениями WCF не поддерживает закрытие последовательности, инициируемое точкой назначения. Действуют следующие ограничения.

  • B1201: источник системы надежного обмена сообщениями WCF для закрытия последовательности всегда отправляет сообщение CloseSequence.

  • B1202: источник системы надежного обмена сообщениями перед отправкой сообщения CloseSequence ждет подтверждения от всех сообщений последовательности.

  • B1203: источник системы надежного обмена сообщениями всегда включает необязательный элемент LastMsgNumber, если в последовательности есть хотя бы одно сообщение.

  • R1204: точка назначения системы надежного обмена сообщениями не должна инициировать закрытие последовательности путем отправки сообщения CloseSequence.

  • B1205: после получения сообщения CloseSequence источник системы надежного обмена сообщениями WCF полагает, что последовательность не завершена, и отправляет ошибку.

Пример сообщения CloseSequence.

<s:Envelope>
  <s:Header>
    <wsa:Action s:mustUnderstand="1">http://docs.oasis-open.org/ws-rx/wsrm/200702/CloseSequence</wsa:Action>
    <wsa:MessageID>urn:uuid:6ce1d4c3-e1c1-474f-a8c9-4210e37f7877</wsa:MessageID>
    <wsa:ReplyTo>
      <wsa:Address>http://Business456.com/clientA</wsa:Address>
    </wsa:ReplyTo>
    <wsa:To s:mustUnderstand="1">http://BusinessABC.com/serviceA</wsa:To>
  </s:Header>
  <s:Body>
    <wsrm:CloseSequence>
      <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>
      <wsrm:LastMsgNumber>30</wsrm:LastMsgNumber>
    </wsrm:CloseSequence>
  </s:Body>
</s:Envelope>
Example CloseSequenceResponse message:
<s:Envelope>
  <s:Header>
    <wsrm:SequenceAcknowledgement>
      <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>
      <wsrm:AcknowledgementRange Lower="1" Upper="30"></wsrm:AcknowledgementRange>
      <wsrm:Final></wsrm:Final>
      <netrm:BufferRemaining>8</netrm:BufferRemaining>
    </wsrm:SequenceAcknowledgement>
    <wsa:Action s:mustUnderstand="1">http://docs.oasis-open.org/ws-rx/wsrm/200702/CloseSequenceResponse</wsa:Action>
    <wsa:RelatesTo>urn:uuid:6ce1d4c3-e1c1-474f-a8c9-4210e37f7877</wsa:RelatesTo>
    <wsa:To s:mustUnderstand="1">http://Business456.com/clientA</wsa:To>
  </s:Header>
  <s:Body>
    <wsrm:CloseSequenceResponse>
      <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>
    </wsrm:CloseSequenceResponse>
  </s:Body>
</s:Envelope>

Завершение последовательности

В WCF после подтверждения CloseSequence/CloseSequenceResponse в первую очередь используется подтверждение TerminateSequence/TerminateSequenceResponse. Точка назначения системы надежного обмена сообщениями WCF не инициирует завершение последовательности, а источник системы надежного обмена сообщениями не поддерживает завершение последовательности, инициируемое точкой назначения. Действуют следующие ограничения.

  • B1301: инициатор WCF отправляет сообщение TerminateSequence только после успешного подтверждения CloseSequence/CloseSequenceResponse.

  • R1302: среда WCF проверяет, что элемент LastMsgNumber одинаков для всех сообщений CloseSequence и TerminateSequence в заданной последовательности. Это значит, что значения LastMsgNumber либо отсутствуют во всех сообщениях CloseSequence и TerminateSequence, либо присутствуют и идентичны во всех сообщениях CloseSequence и TerminateSequence.

  • B1303: при получении сообщения TerminateSequence после подтверждения CloseSequence/CloseSequenceResponse точка назначения системы надежного обмена сообщениями отправляет в ответ сообщение TerminateSequenceResponse. Поскольку перед отправкой сообщения TerminateSequence у источника системы надежного обмена сообщениями имеется последнее подтверждение, точка назначения системы надежного обмена сообщениями точно знает, что последовательность завершается, и немедленно высвобождает ресурсы.

  • B1304: при получении сообщения TerminateSequence до подтверждения CloseSequence/CloseSequenceResponse точка назначения системы надежного обмена сообщениями WCF отправляет в ответ сообщение TerminateSequenceResponse. Если точка назначения системы надежного обмена сообщениями определяет, что в последовательности нет противоречий, она, прежде чем высвободить ресурсы, ждет в течение времени, заданного точкой назначения приложения, чтобы клиент мог получить последнее подтверждение. В противном случае точка назначения системы надежного обмена сообщениями сразу же высвобождает ресурсы и сообщает точке назначения приложения, что последовательность завершена, но не гарантированно, вызывая для этого событие Faulted.

Пример сообщения TerminateSequence.

<s:Envelope>
  <s:Header>
    <wsa:Action s:mustUnderstand="1">http://docs.oasis-open.org/ws-rx/wsrm/200702/TerminateSequence</wsa:Action>
    <wsa:MessageID>urn:uuid:3597a398-4f3c-40f4-9335-8f1515572fdf</wsa:MessageID>
    <wsa:ReplyTo>
      <wsa:Address>http://Business456.com/clientA</wsa:Address>
    </wsa:ReplyTo>
    <wsa:To s:mustUnderstand="1">http://BusinessABC.com/serviceA</wsa:To>
  </s:Header>
  <s:Body>
    <wsrm:TerminateSequence>
      <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>
      <wsrm:LastMsgNumber>30</wsrm:LastMsgNumber>
      </wsrm:TerminateSequence>
  </s:Body>
</s:Envelope>
Example TerminateSequenceResponse message:
<s:Envelope>
  <s:Header>
    <wsrm:SequenceAcknowledgement>
      <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>
      <wsrm:AcknowledgementRange Lower="1" Upper="30"></wsrm:AcknowledgementRange>
      <wsrm:Final></wsrm:Final>
      <netrm:BufferRemaining>8</netrm:BufferRemaining>
    </wsrm:SequenceAcknowledgement>
    <wsa:Action s:mustUnderstand="1">http://docs.oasis-open.org/ws-rx/wsrm/200702/TerminateSequenceResponse</wsa:Action>
    <wsa:RelatesTo>urn:uuid:3597a398-4f3c-40f4-9335-8f1515572fdf</wsa:RelatesTo>
    <wsa:To s:mustUnderstand="1">://Business456.com/clientA</wsa:To>
  </s:Header>
  <s:Body>
    <wsrm:TerminateSequenceResponse>
      <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>
    </wsrm:TerminateSequenceResponse>
  </s:Body>
</s:Envelope>

Последовательности

Ниже приведен список ограничений, относящихся к последовательностям.

  • B1401: в WCF создаются и используются номера последовательностей, не превышающие максимального значения типа xs:long (9223372036854775807).

Пример заголовка Sequence.

<wsrm:Sequence s:mustUnderstand="1">
  <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>
  <wsrm:MessageNumber>1</wsrm:MessageNumber>
</wsrm:Sequence>

Запрос подтверждения

В WCF в качестве механизма поддержки активности используется заголовок AckRequested.

Пример заголовка AckRequested.

<wsrm:AckRequested>
  <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>
</wsrm:AckRequested>

SequenceAcknowledgement

В WCF для передачи подтверждений последовательностей протокола WS-ReliableMessaging используются сообщения приложений. Действуют следующие ограничения.

  • R1601: при установке двух встречных последовательностей с помощью механизма Offer заголовок SequenceAcknowledgement может включаться в любое сообщение приложения, передаваемое определенному получателю. Удаленная конечная точка должна иметь возможность получения доступа к передаваемому таким образом заголовку SequenceAcknowledgement.

  • B1602: в WCF не создаются заголовки SequenceAcknowledgement, содержащие элементы Nack. Среда WCF проверяет, что каждый элемент Nack содержит номер последовательности, в противном случае элемент и значение Nack игнорируются.

Пример заголовка SequenceAcknowledgement.

<wsrm:SequenceAcknowledgement>
  <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>
  <wsrm:AcknowledgementRange Lower="1" Upper="1"></wsrm:AcknowledgementRange>
</wsrm:SequenceAcknowledgement>

Ошибки протокола WS-ReliableMessaging

Ниже приведен список ограничений, относящихся к реализации ошибок протокола WS-ReliableMessaging в WCF. Действуют следующие ограничения.

  • B1701: в WCF не создаются ошибки MessageNumberRollover.

  • B1702: в SOAP 1.2, когда в конечной точке службы достигается максимальное число подключений и обработка новых подключений становится невозможной, среда WCF создает вложенный код ошибки CreateSequenceRefused, netrm:ConnectionLimitReached, как показано в следующем примере.

<s:Envelope>
  <s:Header>
    <wsa:Action>http://docs.oasis-open.org/ws-rx/wsrm/200702/fault</wsa:Action>
  </s:Header>
  <s:Body>
    <s:Fault>
      <s:Code>
        <s:Value>s:Receiver</s:Value>
        <s:Subcode>
          <s:Value>wsrm:CreateSequenceRefused</s:Value>
          <s:Subcode>
            <s:Value>netrm:ConnectionLimitReached</s:Value>
          </s:Subcode>
        </s:Subcode>
      </s:Code>
      <s:Reason>
        <s:Text xml:lang="en">Server 'http://BusinessABC.com/serviceA' is too busy to process this request. Try again later.</s:Text>
      </s:Reason>
    </s:Fault>
  </s:Body>
</s:Envelope>

Ошибки WS-Addressing

Поскольку протокол WS-ReliableMessaging использует протокол WS-Addressing, реализация WS-ReliableMessaging WCF может создавать и передавать ошибки WS-Addressing. В этом разделе описаны ошибки WS-Addressing, которые среда WCFявным образом создает и передает на уровне WS-ReliableMessaging.

  • B1801: WCF создает и передает ошибку Message Addressing Header Required, если выполняется одно из следующих условий:

    • в сообщении CreateSequence, CloseSequence или TerminateSequence отсутствует заголовок MessageId;

    • в сообщении CreateSequence, CloseSequence или TerminateSequence отсутствует заголовок ReplyTo;

    • в сообщении CreateSequenceResponse, CloseSequenceResponse или TerminateSequenceResponse отсутствует заголовок RelatesTo.

  • B1802: WCF создает и передает ошибку Endpoint Unavailable, чтобы показать, что отсутствует ожидающая передачи данных конечная точка, которая могла бы обработать последовательность на основании проверки заголовков адресов в сообщении CreateSequence.

Сочетаемость протокола

Сочетаемость с WS-Addressing

WCF поддерживает две версии протокола WS-Addressing: WS-Addressing 2004/08 [WS-ADDR] и рекомендации консорциума W3C по протоколу WS-Addressing версии 1.0 [WS-ADDR-CORE] и [WS-ADDR-SOAP].

Поскольку в спецификации протокола WS-ReliableMessaging указана только версия WS-Addressing 2004/08, он не накладывает ограничений на используемую версию WS-Addressing. Ниже приведен список ограничений, относящихся к WCF.

  • R2101: с протоколом WS-ReliableMessaging можно использовать как версию WS-Addressing 2004/08, так и версию WS-Addressing 1.0.

  • R2102: в рамках заданной последовательности WS-ReliableMessaging или пары встречных последовательностей, связанных с помощью механизма Offer, следует использовать только одну версию WS-Addressing.

Сочетаемость с SOAP

WCF поддерживает использование с протоколом WS-Reliable Messaging как версии SOAP 1.1, так и версии SOAP 1.2.

Сочетаемость с WS-Security и WS-SecureConversation

WCF обеспечивает защиту последовательностей WS-ReliableMessaging с помощью безопасного транспорта (HTTPS) и совместимости с протоколами WS-Security и WS-Secure Conversation. Протоколы WS-ReliableMessaging 1.1, WS-Security 1.1 и WS-Secure Conversation 1.3 необходимо использовать совместно. Ниже приведен список ограничений, относящихся к WCF.

  • R2301: в дополнение к обеспечению целостности и конфиденциальности отдельных сообщений для защиты целостности последовательности WS-ReliableMessaging в WCF требуется использовать протокол WS-Secure.

  • R2302: перед установкой последовательностей WS-ReliableMessaging должен быть установлен сеанс WS-Secure Conversation.

  • R2303: если время существования последовательности WS-ReliableMessaging превышает время существования сеанса WS-Secure Conversation, необходимо с помощью привязки обновления WS-Secure Conversation обновить маркер SecurityContextToken, созданный протоколом WS-Secure Conversation.

  • B2304: последовательность WS-ReliableMessaging или пара встречных последовательностей всегда связаны с одним сеансом WS-SecureConversation.

  • R2305: при использовании с протоколом WS-Secure Conversation респонденту WCF необходимо, чтобы сообщение CreateSequence содержало элемент wsse:SecurityTokenReference и заголовок wsrm:UsesSequenceSTR.

Пример заголовка UsesSequenceSTR.

<wsrm:UsesSequenceSTR></wsrm:UsesSequenceSTR>

Сочетаемость с сеансами SSL/TLS

WCF не поддерживает совместное использование с сеансами SSL/TLS.

  • B2401: в WCF не создаются заголовки wsrm:UsesSequenceSSL.

  • R2402: инициатор системы надежного обмена сообщениями не должен отправлять сообщение CreateSequence с заголовком wsrm:UsesSequenceSSL респонденту WCF.

Сочетаемость с WS-Policy

WCF поддерживает две версии протокола WS-Policy: WS-Policy 1.2 и WS-Policy 1.5.

Утверждение WS-ReliableMessaging WS-Policy

В WCF утверждение WS-ReliableMessaging WS-Policy wsrm:RMAssertion используется для описания возможностей конечных точек. Ниже приведен список ограничений, относящихся к WCF.

  • B3001: WCF прикрепляет утверждение WS-Policy wsrmn:RMAssertion к элементам wsdl:binding. WCF поддерживает прикрепление как к элементам wsdl:binding, так и к элементам wsdl:port.

  • B3002: WCF никогда не создает тег wsp:Optional.

  • B3003: при обращении к утверждению WS-Policy wsrmp:RMAssertion WCF игнорирует тег wsp:Optional и трактует политику WS-RM Policy как обязательную.

  • R3004: поскольку WCF не может использоваться совместно с сеансами SSL/TLS, WCF не принимает политики, задающие wsrmp:SequenceTransportSecurity.

  • B3005: WCF всегда создает элемент wsrmp:DeliveryAssurance.

  • B3006: WCF всегда задает гарантию доставки wsrmp:ExactlyOnce.

  • B3007: WCF создает и считывает следующие свойства утверждения WS-ReliableMessaging и реализует управление над ними через элемент WCF ReliableSessionBindingElement.

    • netrmp:InactivityTimeout

    • netrmp:AcknowledgementInterval

    Пример RMAssertion.

    <wsrmp:RMAssertion>
  <wsp:Policy>
    <wsrmp:SequenceSTR/>
    <wsrmp:DeliveryAssurance>
      <wsp:Policy>
        <wsrmp:ExactlyOnce/>
        <wsrmp:InOrder/>
      </wsp:Policy>
    </wsrmp:DeliveryAssurance>
  </wsp:Policy>
  <netrmp:InactivityTimeout Milliseconds="600000"/>
  <netrmp:AcknowledgementInterval Milliseconds="200"/>
</wsrmp:RMAssertion>

Расширение WS-ReliableMessaging для управления потоком

WCF использует расширяемость WS-ReliableMessaging, чтобы обеспечить более строгое управление над потоком сообщений последовательности.

Чтобы включить управление потоком, необходимо присвоить свойству FlowControlEnabled типа boolean элемента ReliableSessionBindingElement значение true. Ниже приведен список ограничений, относящихся к WCF.

  • B4001: если управление потоком системы надежного обмена сообщениями включено, WCF создает элемент netrm:BufferRemaining, используя возможности расширения элемента заголовка SequenceAcknowledgement, как показано в следующем примере.

    <wsrm:SequenceAcknowledgement>
  <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>
  <wsrm:AcknowledgementRange Upper="1" Lower="1"/>           
  <netrm:BufferRemaining>8</netrm:BufferRemaining>
</wsrm:SequenceAcknowledgement>

  • B4002: даже если управление потоком системы надежного обмена сообщениями включено, WCF не требует наличия в заголовке SequenceAcknowledgement элемента netrm:BufferRemaining.

  • B4003: точка назначения системы надежного обмена сообщениями WCF использует элемент netrm:BufferRemaining, чтобы задать число новых сообщений, которые она может поместить в буфер.

  • B4004: если управление потоком системы надежного обмена сообщениями включено, источник системы надежного обмена сообщениями WCF использует значение netrm:BufferRemaining, чтобы управлять скоростью передачи сообщений.

  • B4005: WCF создает целые значения элемента netrm:BufferRemaining в интервале от 0 до 4096 включительно и считывает целые значения в интервале от 0 до максимального значения типа xs:int (maxInclusive, 214748364) включительно.

Шаблоны обмена сообщениями

В этом разделе описана работа среды WCF при использовании протокола WS-ReliableMessaging для различных шаблонов обмена сообщениями. Для каждого шаблона обмена сообщениями рассматриваются два варианта развертывания:

  • неадресуемый инициатор — инициатор расположен за брандмауэром, респондент может отправлять инициатору сообщения только с HTTP-ответами;

  • адресуемый инициатор — как инициатор, так и респондент могут принимать HTTP-запросы, т. е. можно установить два встречных HTTP-подключения.

Односторонний неадресуемый инициатор

Привязка

WCF поддерживает шаблон одностороннего обмена сообщениями с использованием одной последовательности через канал HTTP. WCF использует HTTP-запросы для передачи всех сообщений от инициатора респонденту и HTTP-ответы для передачи всех сообщений от респондента инициатору.

Обмен сообщениями CreateSequence

Инициатор WCF передает сообщение CreateSequence без элемента Offer в HTTP-запросе и ожидает сообщения CreateSequenceResponse в HTTP-ответе. Респондент WCF создает последовательность и передает сообщение CreateSequenceResponse без элемента Accept в HTTP-ответе.

SequenceAcknowledgement

Инициатор WCF обрабатывает подтверждения при ответе на все сообщения, кроме сообщения CreateSequence и сообщений об ошибках. Респондент WCF всегда передает отдельное подтверждение в HTTP-ответе для всех сообщений последовательности и сообщений AckRequested.

Обмен сообщениями CloseSequence

Инициатор WCF передает сообщение CloseSequence в HTTP-запросе и ожидает сообщения CreateSequenceResponse в HTTP-ответе. Респондент WCF передает сообщение CloseSequenceResponse в HTTP-ответе.

Обмен сообщениями TerminateSequence

Инициатор WCF передает сообщение TerminateSequence в HTTP-запросе и ожидает сообщения TerminateSequenceResponse в HTTP-ответе. Респондент WCF передает сообщение TerminateSequenceResponse в HTTP-ответе.

Односторонний адресуемый инициатор

Привязка

WCF поддерживает шаблон одностороннего обмена сообщениями с использованием одной последовательности через один входящий и один исходящий канал HTTP. WCF использует для передачи всех сообщений HTTP-запросы. Все HTTP-ответы имеют пустое тело и код состояния HTTP 202.

Обмен сообщениями CreateSequence

Инициатор WCF передает сообщение CreateSequence без элемента Offer в HTTP-запросе. Респондент WCF создает последовательность и передает сообщение CreateSequenceResponse без элемента Accept в HTTP-запросе.

Двусторонний адресуемый инициатор

Привязка

WCF поддерживает шаблон полностью асинхронного двустороннего обмена сообщениями с использованием двух последовательностей через один входящий и один исходящий канал HTTP. Этот шаблон обмена сообщениями можно ограниченным образом объединить с шаблоном "Адресуемый инициатор, запрос-ответ" (Request/Reply, Addressable). WCF использует для передачи всех сообщений HTTP-запросы. Все HTTP-ответы имеют пустое тело и код состояния HTTP 202.

Обмен сообщениями CreateSequence

Инициатор WCF передает сообщение CreateSequence с элементом Offer в HTTP-запросе. Респондент WCF проверяет, что сообщение CreateSequence содержит элемент Offer, после чего создает последовательность и передает сообщение CreateSequenceResponse с элементом Accept.

Время существования последовательности

В WCF две последовательности рассматриваются в качестве одного полностью двустороннего сеанса.

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

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

Односторонний обмен сообщениями запрос-ответ, неадресуемый инициатор

Привязка

WCF поддерживает шаблон одностороннего обмена сообщениями запрос-ответ с использованием двух последовательностей через канал HTTP. WCF использует HTTP-запросы для передачи всех сообщений от инициатора респонденту и HTTP-ответы для передачи всех сообщений от респондента инициатору.

Обмен сообщениями CreateSequence

Инициатор WCF передает сообщение CreateSequence с элементом Offer в HTTP-запросе и ожидает сообщения CreateSequenceResponse в HTTP-ответе. Респондент WCF создает последовательность и передает сообщение CreateSequenceResponse с элементом Accept в HTTP-ответе.

Односторонний обмен сообщениями

Для одностороннего обмена сообщениями инициатор WCF передает сообщение последовательности запросов в HTTP-запросе и получает отдельное сообщение SequenceAcknowledgement в HTTP-ответе. Сообщение SequenceAcknowledgement должно подтвердить передачу сообщения.

Респондент WCF может ответить на запрос подтверждением, ошибкой или ответом с пустым телом и кодом состояния HTTP 202.

Двусторонний обмен сообщениями

Для реализации протокола двустороннего обмена сообщениями инициатор WCF передает сообщение последовательности запросов в HTTP-запросе и получает сообщение последовательности ответов в HTTP-ответе. Ответ должен содержать подтверждение SequenceAcknowledgement того, что сообщение последовательности запросов было передано.

Респондент WCF может ответить на запрос ответом приложения, ошибкой или ответом с пустым телом и кодом состояния HTTP 202.

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

Повторные попытки ответов

В WCF для обеспечения корреляции между сообщениями протокола двустороннего обмена сообщениями используется корреляция между HTTP-запросами и ответами. Поэтому инициатор WCF не прекращает попытки отправки сообщения последовательности запросов в случае подтверждения этого сообщения, а дожидается HTTP-ответа, содержащего элемент SequenceAcknowledgement, ответ приложения или ошибку. Респондент WCF повторяет в HTTP-ответе ответы на запрос, с которым связан этот ответ.

Обмен сообщениями CloseSequence

После получения всех сообщений последовательности ответов и подтверждений для всех сообщений односторонней последовательности запросов инициатор WCF в HTTP-запросе передает сообщение CloseSequence для данной последовательности запросов и ожидает сообщения CloseSequenceResponse в HTTP-ответе.

Закрытие последовательности запросов неявным образом закрывает последовательность ответов. Это значит, что инициатор WCF включает последнее подтверждение SequenceAcknowledgement последовательности ответов в сообщение CloseSequence, а в последовательности ответов нет ответного сообщения CloseSequence.

Респондент WCF проверяет все ответы и подтверждения и в HTTP-ответе передает сообщение CloseSequenceResponse.

Обмен сообщениями TerminateSequence

После получения сообщения CloseSequenceResponse инициатор WCF передает сообщение TerminateSequence для последовательности запросов в HTTP-запросе и ожидает сообщения TerminateSequenceResponse в HTTP-ответе.

Как и в случае обмена сообщениями CloseSequence, завершение последовательности запросов неявным образом завершает последовательность ответов. Это значит, что инициатор WCF включает последнее подтверждение SequenceAcknowledgement последовательности ответов в сообщение TerminateSequence, и что в последовательности ответов нет ответного сообщения TerminateSequence.

Респондент WCF передает сообщение TerminateSequenceResponse в HTTP-ответе.

Обмен сообщениями запрос-ответ, адресуемый инициатор

Привязка

WCF поддерживает шаблон обмена сообщениями запрос-ответ с использованием двух последовательностей через один входящий и один исходящий канал HTTP. Этот шаблон обмена сообщениями можно ограниченным образом объединить с шаблоном "Двусторонний обмен сообщениями, адресуемый инициатор" (Duplex, Addressable). WCF использует для передачи всех сообщений HTTP-запросы. Все HTTP-ответы имеют пустое тело и код состояния HTTP 202.

Обмен сообщениями CreateSequence

Инициатор WCF передает сообщение CreateSequence с элементом Offer в HTTP-запросе. Респондент WCF проверяет, что сообщение CreateSequence содержит элемент Offer, после чего создает последовательность и передает сообщение CreateSequenceResponse с элементом Accept.

Корреляция запросов и ответов

Следующие действия относятся ко всем связанным запросам и ответам.

  • WCF проверяет, что все сообщения с запросами приложения содержат ссылку на конечную точку ReplyTo и значение MessageId.

  • WCF применяет ссылку на локальную конечную точку в качестве значения ReplyTo каждого сообщения с запросом приложения. Ссылка на локальную конечную точку является значением ReplyTo сообщения CreateSequence для инициатора и значением To сообщения CreateSequence для респондента.

  • WCF проверяет, что все сообщения входящих запросов содержат значения MessageId и ReplyTo.

  • WCF проверяет, что значения универсальных кодов ресурсов (URI) в ссылке на конечную точку ReplyTo всех сообщений запросов приложения совпадают с определенной выше ссылкой на локальную конечную точку.

  • WCF проверяет, что все ответы содержат правильные заголовки RelatesTo и To, соответствующие правилам связывания запросов и ответов wsa.