本示例演示如何使用 HTTP 上的消息队列 (MSMQ) 来执行事务处理排队通信。
在排队通信中,客户端使用队列与服务进行通信。 更确切地说,客户端向队列发送消息。 服务从队列接收消息。 因此不必同时运行服务和客户端便可使用队列进行通信。
MSMQ 启用 HTTP(包括启用 HTTPS)来向队列发送消息。 在此示例中,我们将演示使用 Windows Communication Foundation (WCF) 排队通信,以及如何通过 HTTP 发送消息。 MSMQ 使用一种称为 SRMP 的协议,此协议是一种用于通过 HTTP 进行通信的基于 SOAP 的协议。
设置、生成和运行示例
-
若要生成 C# 或 Visual Basic .NET 版本的解决方案,请按照 Building the Windows Communication Foundation Samples中的说明进行操作。
-
若要在单或跨计算机配置中运行示例,请按照中的说明运行 Windows Communication Foundation 示例。
-
运行示例之前添加/删除 Windows 组件,确保安装了 MSMQ 和 HTTP 支持。 安装 HTTP 支持时,会自动安装 Internet 信息服务 (IIS),并会在 IIS 中添加对 MSMQ 的协议支持。
-
如果想要确保使用 HTTP 进行通信,则可以启用 MSMQ 以便在加强模式中运行。 这可确保任何消息都不能使用任何非 HTTP 传输到达计算机上承载的任何队列。
-
选择 MSMQ 以在加强模式中运行后,如果系统为 Windows Server 2003,计算机需要重新启动。
-
运行服务。
-
运行客户端。 确保将终结点地址更改为指向计算机名或 IP 地址而不是 localhost。 客户端将发送消息并退出。
要求
若要运行此示例,服务计算机和客户端计算机上除了 MSMQ 外,还必须安装 IIS。
演示
此示例演示如何将 WCF 发送排队消息通过 HTTP 使用 MSMQ。 这也称为 SRMP 消息传递。 发送排队消息时,发送方计算机上的 MSMQ 通过 TCP 或 HTTP 传输将消息传送到接收队列管理器。 通过选择 SRMP,用户可以指示选择 HTTP 作为队列传送的传输协议。 SRMP 安全启用 HTTPS。
示例
示例代码基于事务处理示例。 使用 SRMP 将消息发送到队列和从队列中接收消息的方式与使用本机协议发送和接收消息的方式相同。
客户端的配置将会发生更改以指示选择队列传输协议。 队列传输协议可以是本机、SRMP 或 SrmpSecure 之一。 默认情况下,传输协议为“本机”。 在此示例中,客户端和服务在配置中指定使用 SRMP。
SRMP 存在与传输安全相关的限制。 默认 MSMQ 传输安全需要使用 Active Directory,而 Active Directory 要求发送队列管理器和接收队列管理器位于同一个 Windows 域中。 这在通过 HTTP 边界发送消息时是不可能的。 因此,无法使用默认传输安全。 如果需要传输安全,则传输安全必须设置为“证书”。 消息安全也可用于保护消息。 在本示例中,为说明 SRMP 消息传递,关闭了传输和消息安全。
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<system.serviceModel>
<client>
<!-- Define NetMsmqEndpoint -->
<endpoint name="OrderProcessorEndpoint"
address=
"net.msmq://localhost/private/ServiceModelSamplesSrmp"
bindingConfiguration="srmpBinding"
binding="netMsmqBinding"
contract="IOrderProcessor" />
</client>
<bindings>
<netMsmqBinding>
<binding name="srmpBinding"
queueTransferProtocol="Srmp">
<security mode="None" />
</binding>
</netMsmqBinding>
</bindings>
</system.serviceModel>
</configuration>
运行此示例可生成下面的输出。
Processing Purchase Order: 556b70be-31ee-4a3b-8df4-ed5e538015a4
Customer: somecustomer.com
OrderDetails
Order LineItem: 54 of Blue Widget @unit price: $29.99
Order LineItem: 890 of Red Widget @unit price: $45.89
Total cost of this order: $42461.56
Order status: Pending
Important: 您的计算机上可能已安装这些示例。 在继续操作之前,请先检查以下(默认)目录:
<InstallDrive>:\WF_WCF_Samples如果此目录不存在,请转到Windows Communication Foundation (WCF) 和.NET Framework 4 的 Windows Workflow Foundation (WF) 示例若要下载所有 Windows Communication Foundation (WCF) 和WF示例。 此示例位于以下目录:
<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\Net\MSMQ\SRMP
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
