本部分介绍如何使用 Windows Communication Foundation (WCF) 中的排队的通信。
作为 WCF 传输绑定进行排队
在 WCF 中,协定指定要交换的内容。 协定是业务相关或应用程序特定的消息交换。 用于交换消息的机制(或“方式”)在绑定中指定。 WCF 中的绑定封装消息交换的详细信息。 它们为用户公开配置旋钮以控制绑定所表示的传输或协议的各个方面。 在 WCF 中排队都被视为其他任何传输绑定,这是很多排队应用程序一大优势。 当今,很多排队应用程序的编写方式不同于其他远程过程调用 (RPC) 样式的分布式应用程序,这使得遵循和维护更加困难。 使用 WCF,编写分布式应用程序的样式非常相似,使其更易于遵循和维护。 而且,将交换机制从业务逻辑中单独分离出来后,就可以更为轻松地配置传输或对其进行更改,而不会影响应用程序特定的代码。 下图演示将 MSMQ 用作传输的 WCF 服务和客户端的结构。
排队应用程序关系图
如前图所示,客户端和服务必须仅定义应用程序语义,即协定及实现。 服务用首选设置来配置排队绑定。 客户端使用ServiceModel Metadata Utility Tool (Svcutil.exe)生成 WCF 客户端到服务并生成描述用于将消息发送到服务的绑定的配置文件。 因此,若要发送排队的消息,客户端实例化 WCF 客户端并调用其上的操作。 这会导致将消息发送到传输队列,然后再传输到目标队列。 排队通信的所有复杂程度都将从发送和接收消息的应用程序中隐藏。
有关 WCF 中排队绑定需要注意的问题包括:
-
必须单向操作,因为默认排队绑定 WCF 中的所有服务不支持使用队列的双工通信。 双向通信示例 (双向通信) 说明了如何使用两个单向协定来实现使用队列的双工通信。
-
若要生成 WCF 客户端使用元数据交换需要服务上的其他 HTTP 终结点,以便它可以查询直接生成 WCF 客户端并获取用于适当配置排队的通信的绑定信息。
-
根据排队绑定,WCF 之外额外的配置是必需的。 例如,xref:System.ServiceModel.NetMsmqBinding随附于 WCF 的类需要配置绑定,以及按最小方式配置消息队列 (MSMQ)。
以下部分介绍的特定排队的绑定附带的 WCF 中,基于 MSMQ。
MSMQ
WCF 中的排队的传输使用 MSMQ 进行排队通信。
MSMQ 作为可选组件随 Windows 提供,并作为 NT 服务运行。 它在传输队列中捕获传输消息,并在目标队列中捕获传递消息。 MSMQ 队列管理器实现可靠的消息传输协议,以使消息不会在传输过程中丢失。 此协议可以是本机的,也可以是基于 SOAP 的,如 SOAP 可靠消息协议 (SRMP)。
在 MSMQ 中,队列可以是事务性的,也可以是非事务性的。 通过事务性队列,可以在事务中捕获和传递消息,然后将这些消息永久地存储在队列中。 发送至事务性队列的消息仅按顺序传输一次。 可以使用非事务性队列发送可变消息和持久性消息。 发送到非事务性队列的消息不具有任何可靠传输保证,因而消息可能会丢失。
也可以使用向 Active Directory 目录服务注册的 Windows 标识对 MSMQ 队列进行保护。 安装 MSMQ 时,可以安装 Active Directory 集成,这要求计算机加入 Windows 域网络。
有关 MSMQ 的详细信息,请参阅安装消息队列 (MSMQ)。
NetMsmqBinding
<NetMsmqBinding >是 WCF 提供了用于两个 WCF 终结点使用 MSMQ 进行通信的排队的绑定。 因此,该绑定将公开特定于 MSMQ 的属性。 然而,并非所有 MSMQ 功能和属性都在 NetMsmqBinding 中公开。 紧凑 NetMsmqBinding 设计为具有一组大多数客户都认为足够的最佳功能。
NetMsmqBinding 以绑定上的属性形式阐明了迄今为止所讨论的核心队列概念。 而这些属性又向 MSMQ 传达如何传输和传递消息。 后面几节将讨论属性类别。 有关详细信息,请参阅更完整地描述特定属性的概念性主题。
ExactlyOnce 和 Durable 属性
ExactlyOnce 和 Durable 属性影响消息在队列之间的传输方式:
-
ExactlyOnce:如果设置为true(默认值),则排队的通道可确保确认消息,如果传递,不重复。 还可确保消息不会丢失。 如果无法传递消息,或在传递消息前已超过消息的生存时间,则将在死信队列中记录传递失败的消息以及失败原因。 当设置为false时,排队通道将尽量传输消息。 在这种情况下,可以任意选择一个死信队列。 -
Durable::当设置为true(默认值)时,排队通道确保 MSMQ 将消息永久存储在磁盘上。 因而,如果 MSMQ 服务要停止并重新启动,则磁盘上的消息将传输到目标队列或传递到服务。 当设置为false时,消息将存储在可变存储区中,而且会在停止并重新启动 MSMQ 服务时丢失。
对于 ExactlyOnce 可靠传输,MSMQ 要求队列是事务性队列。 同时,MSMQ 还需要一个从事务性队列中进行读取的事务。 同样,在使用 NetMsmqBinding 时,请记住,如果将 ExactlyOnce 设置为 true,则需要使用事务来发送或接收消息。 与此类似,MSMQ 要求队列为非事务性队列来实现高效保证,例如,当 ExactlyOnce 为 false 以及进行可变消息传递时。 因此,将 ExactlyOnce 设置为 false,或将 durable 设置为 false 时,将无法使用事务发送或接收消息。
Note: 确保基于绑定中的设置创建正确的队列(事务性或非事务性)。 如果
ExactlyOnce为true,则使用事务性队列;否则,使用非事务性队列。
死信队列属性
死信队列用于存储传递失败的消息。 用户可以编写补偿逻辑来从死信队列中读取消息。
很多队列系统都提供系统级死信队列。 MSMQ 为向非事务性队列传递失败的消息提供一个系统级非事务性死信队列,为向事务性队列传递失败的消息提供一个系统级事务性死信队列。
如果向不同目标队列发送消息的多个客户端共享 MSMQ 服务,则客户端发送的所有消息将转到同一个死信队列。 这并不总是可取的。 为更好地隔离,WCF 和 MSMQ 中的Windows Vista提供自定义死信队列 (或特定于应用程序的死信队列),用户可以指定用于存储传递失败的消息。 因此,不同的客户端并不共享同一个死信队列。
绑定具有两个相关属性:
-
DeadLetterQueue:此属性是一个枚举,指示是否请求死信队列。 如果请求某类死信队列,则该枚举还包含这种死信队列。 该属性的值为None、System和Custom。 有关这些属性的解释的详细信息,请参阅使用死信队列来处理消息传输失败 -
CustomDeadLetterQueue:此属性是特定于应用程序的死信队列的统一资源标识符 (URI) 地址。 如果这是必需DeadLetterQueue。Custom选择。
病毒消息处理属性
当服务从事务中的目标队列读取消息时,服务可能由于种种原因而无法处理消息。 然后,将消息放回队列以备再次读取。 若要处理反复失败的消息,可以在绑定中配置一组病毒消息处理属性。 有如下四个属性:ReceiveRetryCount、MaxRetryCycles、RetryCycleDelay 和 ReceiveErrorHandling。 有关这些属性的详细信息,请参阅病毒消息处理。
安全属性
MSMQ 公开其自己的安全模型,如队列上的访问控制列表 (ACL) 或发送经过验证身份的消息。 NetMsmqBinding 将这些安全属性作为其传输安全设置的一部分而公开。 绑定中有两个用于传输安全的属性:MsmqAuthenticationMode 和 MsmqProtectionLevel。 这些属性中的设置取决于 MSMQ 的配置方式。 有关详细信息,请参阅使用传输安全保护消息。
除了传输安全,实际的 SOAP 消息本身也可以使用消息安全来进行保护。 有关详细信息,请参阅使用消息安全保护消息。
MsmqTransportSecurity 还公开两个属性,即 MsmqEncryptionAlgorithm 和 MsmqHashAlgorithm。 这些是要为消息的队列到队列传输加密和签名的哈希选择的不同算法的枚举。
其他属性
除了上述各属性,在绑定中公开的其他 MSMQ 特定的属性还包括:
-
UseSourceJournal:打开以指示源日记记录的属性。 源日记记录是一项 MSMQ 功能,用于跟踪从传输队列成功传输的消息。 -
UseMsmqTracing:要指示已打开 MSMQ 跟踪的属性。 每当消息离开或到达承载 MSMQ 队列管理器的计算机时,MSMQ 跟踪都会向报告队列发送报告消息。 -
QueueTransferProtocol:要用于队列到队列的消息传输协议的枚举。 MSMQ 实现本机队列到队列的传输协议和称为 SOAP 可靠消息传输协议 (SRMP) 的基于 SOAP 的协议。 当使用 HTTP 传输进行队列到队列的传输时将使用 SRMP。 当使用 HTTPS 进行队列到队列的传输时将使用 SRMP 安全。 -
UseActiveDirectory:一个布尔值以指示是否必须使用 Active Directory 进行队列地址解析。 默认情况下,此功能处于关闭状态。 有关详细信息,请参阅服务终结点和队列寻址。
MsmqIntegrationBinding
MsmqIntegrationBinding希望 WCF 终结点与在 C 中,编写的现有 MSMQ 应用程序进行通信时使用C++,COM 或 System.Messaging Api。
对于 NetMsmqBinding,绑定属性基本相同。 不过,存在以下差异:
-
将
MsmqIntegrationBinding的操作协定限制为采用一个类型为 xref:System.ServiceModel.MsmqIntegration.MsmqMessage`1 的参数,其中类型参数为正文类型。 -
很多 MSMQ 本机消息属性都在 xref:System.ServiceModel.MsmqIntegration.MsmqMessage`1 中公开以供使用。
-
为帮助对消息正文进行序列化和反序列化,提供了若干序列化程序,如 XML 和 ActiveX。
代码示例
有关编写使用 MSMQ 的 WCF 服务的分步指导,请参见下列主题:
有关说明 MSMQ 在 WCF 中的用法的完整代码示例,请参见下列主题:
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
