大网数据广告活动
.NET 与 C# 开发

可靠消息传送协议版本 1.0

· 52CE 我爱测

本主题介绍 Windows Communication Foundation (WCF) 实现的详细信息,为 Ws-reliable Messaging 2005 年 2 月 (版本 1.0) 协议需要使用 HTTP 传输进行互操作。 WCF 遵循 Ws-reliable Messaging 规范的约束和澄清,本主题中所述。 请注意,从开始 WinFX 实现 WS-ReliableMessaging 版本 1.0 协议。

本主题介绍 Windows Communication Foundation (WCF) 实现的详细信息,为 Ws-reliable Messaging 2005 年 2 月 (版本 1.0) 协议需要使用 HTTP 传输进行互操作。 WCF 遵循 Ws-reliable Messaging 规范的约束和澄清,本主题中所述。 请注意,从开始 WinFX 实现 WS-ReliableMessaging 版本 1.0 协议。

Ws-reliable Messaging February 2005 协议实现中情况下,WCF xref:System.ServiceModel.Channels.ReliableSessionBindingElement。

为方便起见,本主题使用以下角色:

  • 发起方:启动 WS-Reliable Message 序列创建的客户端

  • 响应方:接收发起方的请求的服务

本文档使用下表中的前缀和命名空间。

前缀 命名空间
wsrm http://schemas.xmlsoap.org/ws/2005/02/rm
netrm http://schemas.microsoft.com/ws/2006/05/rm
秒 http://www.w3.org/2003/05/soap-envelope
wsa http://schemas.xmlsoap.org/ws/2005/08/addressing
wsse http://docs.oasis-open.org/wss/2004/01/oasis-200401-wssecurity-secext-1.0.xsd

消息

序列建立消息

WCF 实现CreateSequence和CreateSequenceResponse消息以建立可靠的消息序列。 适用以下约束:

  • B1101:WCF 发起方不会生成可选的 Expires 元素CreateSequence消息,或者在情况时CreateSequence消息中包含Offer元素中,可选Expires中的元素Offer元素。

  • B1102:访问时CreateSequence消息,WCFResponder发送和接收都Expires元素如果它们存在,但不使用它们的值。

WS-Reliable Messaging 引入了 Offer 机制来建立两个形成会话的反向相关的序列。

  • R1103:如果CreateSequence包含Offer元素中,可靠消息响应方必须接受序列并使用响应CreateSequenceResponse,其中包含wsrm:Accept元素形成两个相关反向序列或拒绝CreateSequence请求。

  • R1104:在反向序列上流动的 SequenceAcknowledgement 和应用程序消息必须发送到 ReplyTo 的 CreateSequence 终结点引用。

  • R1105:AcksTo 中的 ReplyTo 和 CreateSequence 终结点引用必须具有与八进制识别匹配的地址值。

    WCF 响应方验证的 URI 部分AcksTo和ReplyTo创建序列之前 Epr 是否相同。

  • R1106:AcksTo 中的 ReplyTo 和 CreateSequence 终结点引用应具有相同的引用参数集。

    WCF 不强制但假定的该 [引用参数]AcksTo并ReplyTo上CreateSequence相同,并且使用 [reference parameters] 从ReplyTo确认和相反序列消息的终结点引用。

  • R1107:使用建立的两个相反序列时Offer机制SequenceAcknowledgement和反向序列上流动的应用程序消息必须发送到ReplyTo终结点引用CreateSequence。

  • R1108:使用 Offer 机制建立两个相反序列时[address]的属性wsrm:AcksTo终结点引用的子元素wsrm:Accept元素的CreateSequenceResponse必须匹配识别字节的目标URICreateSequence.

  • R1109:使用建立的两个相反序列时Offer机制、 发送的发起方和响应方的消息的确认消息必须发送到相同的终结点引用。

    WCF 使用 Ws-reliable Messaging 在发起方和响应方之间建立可靠会话。 WCF 的 Ws-reliable Messaging 实现提供了可靠会话为单向、 请求-答复和完全双工消息传递模式。 Ws-reliable MessagingOffer上的机制CreateSequence / CreateSequenceResponse ,便可以建立两个相关的相反序列,并提供适合于所有消息终结点的会话协议。 因为 WCF 提供了会话包括会话完整性的端到端保护的安全保障,是用于确保适用于同一参与方的消息到达同一目标。 这也允许在应用程序消息上捎带序列确认消息。 因此,约束 R1104、 R1105 和 R1108 适用于 WCF。

CreateSequence 消息的一个示例。

<s:Envelope>
  <s:Header>
    <a:Action s:mustUnderstand="1">
      http://schemas.xmlsoap.org/ws/2005/02/rm/CreateSequence
    </a:Action>
    <a:ReplyTo>
      <a:Address>
         http://Business456.com/clientA
      </a:Address>
    </a:ReplyTo>
    <a:MessageID>
      urn:uuid:addabbbf-60cb-44d3-8c5b-9e0841629a36
    </a:MessageID>
    <a:To s:mustUnderstand="1">
      http://Business456.com/clientA
    </a: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:0afb8d36-bf26-4776-b8cf-8c91fddb5496
      </wsrm:Identifier>
     </wsrm:Offer>
   </wsrm:CreateSequence>
  </s:Body>
</s:Envelope>

CreateSequenceResponse 消息的一个示例。

<s:Envelope>
  <s:Header>
    <a:Action s:mustUnderstand="1">
      http://schemas.xmlsoap.org/ws/2005/02/rm/CreateSequenceResponse
    </a:Action>
    <a:RelatesTo>
      urn:uuid:addabbbf-60cb-44d3-8c5b-9e0841629a36
    </a:RelatesTo>
    <a:To s:mustUnderstand="1">
      http://Business456.com/clientA
    </a:To>
  </s:Header>
  <s:Body>
   <wsrm:CreateSequenceResponse>
    <Identifier>
     urn:uuid:eea0a36c-b38a-43e8-8c76-2fabe2d76386
    </Identifier>
    <Accept>
    <AcksTo>
      <a:Address>
        http://BusinessABC.com/serviceA
      </a:Address>
    </AcksTo>
    </Accept>
   </wsrm:CreateSequenceResponse>
  </s:Body>
</s:Envelope>

序列

以下是适用于序列的约束的列表:

  • B1201:WCF 生成,并访问序列号不高于xs:long的最大包含值 9223372036854775807。

  • B1202:WCF 始终会生成正文为空的最后一个消息使用的操作 URI 的http://schemas.xmlsoap.org/ws/2005/02/rm/LastMessage。

  • B1203:WCF 接收和传送一条带有包含的序列标头LastMessage元素,只要操作 URI 不是http://schemas.xmlsoap.org/ws/2005/02/rm/LastMessage。

Sequence 标头的一个示例。

<wsrm:Sequence>
  <wsrm:Identifier>
    urn:uuid:addabbbf-60cb-44d3-8c5b-9e0841629a36
  </wsrm:Identifier>
  <wsrm:MessageNumber>
    10
  </wsrm:MessageNumber>
  <wsrm:LastMessage/>
 </wsrm:Sequence>

AckRequested 标头

WCF 使用AckRequested标头,因为保持活动状态的机制。 WCF 不会生成可选MessageNumber元素。 收到的消息AckRequested包含的标头MessageNumber元素中,WCF 将忽略MessageNumber元素的值,如下面的示例中所示。

<wsrm:AckRequested>
  <wsrm:Identifier>
    urn:uuid:addabbbf-60cb-44d3-8c5b-9e0841629a36
  </wsrm:Identifier>
</wsrm:AckRequested>

SequenceAcknowledgement 标头

WCF 将非法携带机制用于在 Ws-reliable Messaging 中提供的序列确认。

  • R1401:使用建立的两个相反序列时Offer机制,SequenceAcknowledgement可能传输到目标接收方的任何应用程序消息中包括标头。

  • B1402:当 WCF 必须之前生成确认消息接收任何序列消息 (例如,若要满足AckRequested消息),WCF 生成SequenceAcknowledgement标题,其中包含范围 0-0,如下面的示例中所示。

    <wsrm:SequenceAcknowledgement>
      <wsrm:Identifier>
        urn:uuid:addabbbf-60cb-44d3-8c5b-9e0841629a36
      </wsrm:Identifier>
      <wsrm:AcknowledgementRange Upper="0" Lower="0"/>
    </wsrm:SequenceAcknowledgement>
    
  • B1403:WCF 不会生成SequenceAcknowledgement包含的标头Nack元素,但支持Nack元素。

WS-ReliableMessaging 错误

下面是适用于 WCF 实现的 WS 可靠消息传送错误的约束的列表:

  • B1501:WCF 不会生成MessageNumberRollover故障。

  • B1502:WCF 终结点可能生成CreateSequenceRefused错误,如规范中所述。

  • B1503:When 服务终结点达到其连接限制,无法处理新连接时,WCF 将生成额外CreateSequenceRefused错误子代码netrm:ConnectionLimitReached,如以下示例所示。

    <s:Envelope>
      <s:Header>
        <wsa:Action>
          http://schemas.xmlsoap.org/ws/2005/08/addressing/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">
              [Reason]
            </s:Text>
          </s:Reason>
        </s:Fault>
      </s:Body>
    </s:Envelope>
    

WS-Addressing 错误

因为 Ws-reliable Messaging 使用 Ws-addressing,所以 WCF Ws-reliable Messaging 实现可能生成 Ws-addressing 错误。 本部分介绍了在 Ws-reliable Messaging 层显式生成 WCF Ws-addressing 错误:

  • B1601:WCF 生成错误消息寻址标头需要以下项之一为 true 时:

    • 消息缺少 Sequence 标头和 Action 标头。

    • CreateSequence 消息缺少 MessageId 标头。

    • CreateSequence 消息缺少 ReplyTo 标头。

  • B1602:WCF 生成缺少的消息的操作不受支持容错Sequence标头和具有Action不是可识别的 Ws-reliable Messaging 规范中的标头。

  • B1603:WCF 生成终结点不可用来指示终结点不会处理序列基于检查错误CreateSequence消息的寻址标头。

协议组合

与 WS-Addressing 组合

WCF 支持两个版本的 Ws-addressing:的 Ws-addressing 2004/08 [WS-ADDR] 以及 W3C Ws-addressing 1.0 建议 [WS ADDR 核] 和 [WS ADDR SOAP]。

尽管 WS-Reliable Messaging 规范只提及 WS-Addressing 2004/08,它并未限制要使用的 WS-Addressing 版本。 下面是适用于 WCF 的约束的列表:

  • R2101: 这两个可以与 Ws-reliable Messaging 使用 Ws-addressing 2004/08 和 Ws-addressing 1.0。

  • R2102:A 单一版本的 Ws-addressing 必须在整个给定的 Ws-reliable Messaging 序列或通过使用相关的反向序列对wsrm:Offer机制。

与 SOAP 组合

WCF 支持使用 SOAP 1.1 和 SOAP 1.2 与 Ws-reliable Messaging。

与 WS-Security 和 WS-SecureConversation 组合

WCF 提供了通过使用 Ws-secure Conversation 使用安全传输协议 (HTTPS)、 与 Ws-security 的组合和组合的 Ws-reliable Messaging 序列的保护。 下面是适用于 WCF 的约束的列表:

  • R2301: 为了保护单个消息的 Ws-reliable Messaging 序列的完整性的完整性和保密性,WCF 需要必须使用 Ws-secure Conversation。

  • R2302:AWS-必须在建立 Ws-reliable Messaging 序列之前建立安全对话会话中。

  • R2303:如果 Ws-reliable Messaging 序列生存期超过了 Ws-secure Conversation 会话的生存期,SecurityContextToken建立通过使用 Ws-secure Conversation 必须续订通过使用相应的 Ws-secure Conversation 续订绑定。

  • B2304:WS-Reliable Messaging 序列或一对相关的相反序列始终绑定到单个 Ws-secureconversation 会话。

    WCF 源生成wsse:SecurityTokenReference元素中的元素扩展性节CreateSequence消息。

  • 与 Ws-secure Conversation R2305:WhenCreateSequence消息必须包含wsse:SecurityTokenReference元素。

WS-Reliable Messaging WS-Policy 断言

WCF 使用 Ws-reliable Messaging Ws-policy 断言wsrm:RMAssertion来描述终结点功能。 下面是适用于 WCF 的约束的列表:

  • B3001:WCF 将附加wsrm:RMAssertionWs-policy 断言到wsdl:binding元素。 WCF 支持这两个附件wsdl:binding和wsdl:port元素。

  • B3002:WCF 支持 Ws-reliable Messaging 断言的以下可选属性,并在 WCF 提供对它们的控制ReliableMessagingBindingElement:

    • wsrm:InactivityTimeout

    • wsrm:AcknowledgementInterval

    下面是一个示例。

    <wsrm:RMAssertion>
      <wsrm:InactivityTimeout Milliseconds="600000" />
      <wsrm:AcknowledgementInterval Milliseconds="200" />
    </wsrm:RMAssertion>
    

流控制 WS-Reliable Messaging 扩展

WCF 使用 Ws-reliable Messaging 扩展性提供对序列消息流的可选更紧密控制。

设置启用流控制xref:System.ServiceModel.Channels.ReliableSessionBindingElement.FlowControlEnabled?displayProperty=nameWithType属性设置为true。 下面是适用于 WCF 的约束的列表:

  • B4001:当启用可靠消息流控制时,WCF 生成netrm:BufferRemaining元素的元素扩展性中SequenceAcknowledgement标头。

  • B4002:启用可靠消息流控制时,WCF 不需要netrm:BufferRemaining元素出现在SequenceAcknowledgement标头,如下面的示例中所示。

    <wsrm:SequenceAcknowledgement>
      <wsrm:Identifier>
        http://fabrikam123.com/abc
      </wsrm:Identifier>
      <wsrm:AcknowledgementRange Upper="1" Lower="1"/>
      <netrm:BufferRemaining>
        8
      </netrm:BufferRemaining>
    </wsrm:SequenceAcknowledgement>
    
  • B4003:WCF 使用netrm:BufferRemaining以指示多少新消息的可靠消息传递目标可以缓冲。

  • B4004: WCF 可靠消息传递服务限制的可靠消息传递目标应用程序不能快速接收消息时,传输的消息数。 可靠消息传递目标将缓冲消息,而该元素的值将下降为 0。

  • B4005:WCF 将生成netrm:BufferRemaining整数值介于 0 和 4096 (含),并读取介于 0 的整数值和xs:int的maxInclusive值 214748364 (含)。

消息交换模式

Ws-reliable Messaging 用于不同消息交换模式时,本部分将介绍 WCF 的行为。 对于每个消息交换模式,可以考虑下面的两个部署方案:

  • 不可寻址的发起方:发起方位于防火墙;响应方可以将消息传递到发起方,仅在 HTTP 响应上。

  • 可寻址的发起方:发起方和响应方都可以发送 HTTP 请求;换而言之,可以建立两个反向 HTTP 连接。

单向、不可寻址的发起方

绑定

WCF 提供了通过一个 HTTP 通道使用一个序列的单向消息交换模式。 WCF 使用 HTTP 请求传输所有消息从 RMS 到 RMD,并在 HTTP 响应向 RMS 的所有消息从 RMD 都都传输。

CreateSequence 交换

WCF 发起方生成CreateSequence与任何产品/服务的消息。 WCF 响应方确保CreateSequence不包含提议创建序列之前。 WCF 响应方答复CreateSequence请求与CreateSequenceResponse消息。

SequenceAcknowledgement

WCF 发起方处理除之外的所有消息的确认答复CreateSequence消息和错误消息。 WCF 响应方始终对这两个序列的响应中生成一个独立的确认和AckRequested消息。

TerminateSequence 消息

WCF 将TerminateSequence为单向操作,这意味着在 HTTP 响应具有空的正文和 HTTP 202 状态代码。

单向、可寻址的发起方

绑定

WCF 提供了一个序列通过一个入站和出站 Http 通道使用的单向消息交换模式。 WCF 使用 HTTP 请求传输所有消息。 所有 HTTP 响应的正文都为空,并且具有 HTTP 202 状态代码。

CreateSequence 交换

WCF 发起方生成CreateSequence与任何产品/服务的消息。 WCF 响应方确保CreateSequence不包含提议创建序列之前。 WCF 响应方传输CreateSequenceResponseHTTP 请求上的消息发送与ReplyTo终结点引用。

双工、可寻址的发起方

绑定

WCF 提供了通过一个入站和出站 HTTP 通道使用两个序列的完全异步的双向消息交换模式。 WCF 使用 HTTP 请求传输所有消息。 所有 HTTP 响应的正文都为空,并且具有 HTTP 202 状态代码。

CreateSequence 交换

WCF 发起方生成CreateSequence与产品/服务的消息。 WCF 响应方确保CreateSequence具有创建序列之前的产品/服务。 WCF 发送CreateSequenceResponseHTTP 请求上往CreateSequence的ReplyTo终结点引用。

序列生存期

WCF 将两个序列视为一个全双工会话。

在生成的错误,使一个序列,WCF 需要要故障这两个序列的远程终结点。 在读取的错误,使一个序列,WCF 会使故障这两个序列。

WCF 可以关闭其出站序列并继续处理其入站序列上的消息。 相反,WCF 可以处理入站序列的关闭和继续其出站序列上发送消息。

请求-答复、不可寻址的发起方

绑定

WCF 提供了单向和请求-答复消息交换模式使用两个序列通过一个 HTTP 通道。 WCF 使用 HTTP 请求来传输请求序列消息,并使用 HTTP 响应传输答复序列的消息。

CreateSequence 交换

WCF 发起方生成CreateSequence与产品/服务的消息。 WCF 响应方确保CreateSequence具有创建序列之前的产品/服务。 WCF 响应方答复CreateSequence请求与CreateSequenceResponse消息。

单向消息

若要成功完成单向消息交换协议,WCF 发起方传输请求序列消息在 HTTP 请求和接收独立SequenceAcknowledgementHTTP 响应上的消息。 SequenceAcknowledgement 必须确认已传输的消息。

WCF 响应来答复请求确认、 错误或正文为空且 HTTP 202 状态代码的响应。

双向消息

若要成功地完成双向消息交换协议,WCF 发起方传输请求序列消息在 HTTP 请求和接收答复序列消息在 HTTP 响应上。 响应必须包含一个确认已传输的请求序列消息的 SequenceAcknowledgement。

WCF 响应来答复请求与应用程序答复、 错误或正文为空且 HTTP 202 状态代码的响应。

由于存在单向消息和应用程序答复的计时,因此请求序列消息的序列号与响应消息的序列号不相关联。

重试答复

WCF 依赖于双向消息交换协议关联的 HTTP 请求-答复相关。 因此,WCF 发起方不会停止重试请求序列消息,而不是在 HTTP 响应携带确认、 用户消息或错误时确认请求序列消息。 WCF 响应方重试向其答复相关联的请求的 HTTP 请求路线上的答复。

LastMessage 交换

WCF 发起方生成并传输空的最后一条 HTTP 请求路线上。 WCF 需要一个响应,但忽略实际响应消息。 WCF 响应方答复请求序列的正文为空的最后一个消息使用答复序列的正文为空的最后一条消息。

如果 WCF 响应方接收在其中操作 URI 不是最后一条消息http://schemas.xmlsoap.org/ws/2005/02/rm/LastMessage,WCF 使用最后一条消息进行回复。 在双向消息交换协议中,最后一条消息携带应用程序消息;在单向消息交换协议中,最后一条消息为空。

WCF 响应方不需要确认答复序列的正文为空的最后一条消息。

TerminateSequence 交换

在所有请求已都接收一个有效答复时,WCF 发起方生成并传输请求序列的TerminateSequenceHTTP 请求路线上的消息。 WCF 需要一个响应,但忽略实际响应消息。 WCF 响应方答复请求序列TerminateSequence使用答复序列消息TerminateSequence消息。

在正常的关闭序列中,两个 TerminateSequence 消息都携带一个完整范围的 SequenceAcknowledgement。

请求/答复、可寻址的发起方

绑定

WCF 提供了两个序列通过一个入站和出站 HTTP 通道使用的请求-答复消息交换模式。 WCF 使用 HTTP 请求传输所有消息。 所有 HTTP 响应的正文都为空,并且具有 HTTP 202 状态代码。

CreateSequence 交换

WCF 发起方生成CreateSequence与产品/服务的消息。 WCF 响应方确保CreateSequence具有创建序列之前的产品/服务。 WCF 发送CreateSequenceResponseHTTP 请求上往CreateSequence的ReplyTo终结点引用。

请求/答复关联

WCF 发起方确保所有应用程序请求消息都具有MessageId和一个ReplyTo终结点引用。 WCF 发起方适用CreateSequence消息的ReplyTo上每个应用程序请求消息的终结点引用。 WCF 响应方要求传入的请求消息具有MessageId和一个ReplyTo。 WCF 响应方确保两个终结点引用的 URICreateSequence和应用程序请求的所有消息都都完全相同。

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。