SRMP

發行項
05/10/2023

SRMP 範例會示範如何透過 HTTP 使用訊息佇列 (MSMQ) 來執行交易佇列通訊。

在佇列通訊中，用戶端會使用佇列與服務通訊。更精確地說，用戶端會傳送訊息至佇列。服務會接收來自佇列的訊息。因此，服務與用戶端不需同時執行，就能使用佇列通訊。

MSMQ 允許使用 HTTP (包括使用 HTTPS) 傳送訊息至佇列。在此範例中，我們會示範如何使用 Windows Communication Foundation (WCF) 佇列通訊，以及如何透過 HTTP 來傳送訊息。 MSMQ 會使用稱為 SRMP 的通訊協定，這是適用在透過 HTTP 進行通訊的 SOAP 通訊協定。

若要安裝、建置及執行範例

確定您已執行 Windows Communication Foundation 範例的一次性安裝程序。
若要建置方案的 C# 或 Visual Basic .NET 版本，請遵循 Building the Windows Communication Foundation Samples中的指示。
若要在單一或多部電腦組態中執行此範例，請遵循執行 Windows Communication Foundation 範例中的指示進行。
執行範例之前，請在 [新增/移除 Windows 元件] 中確認 MSMQ 已隨 HTTP 支援一併安裝。安裝 HTTP 支援時，會自動安裝網際網路資訊服務 (IIS)，並在 IIS 中為 MSMQ 新增通訊協定支援。
如果您想要確定會在通訊時使用 HTTP，則可以讓 MSMQ 在固定模式中執行。這可以確保任何訊息都無法使用非 HTTP 傳輸進到電腦上裝載的佇列中。
選好要在固定模式中的 MSMQ 之後，電腦會要求重新啟動 Windows Server 2003。
執行服務。
執行該用戶端。確定您已將端點位址改為指向電腦名稱或 IP 位址，而非指向 localhost。用戶端便會傳送訊息並結束。

需求

若要執行這個範例，除了安裝 MSMQ 之外，還必須在服務及用戶端機器兩端都安裝 IIS。

示範

範例會透過 HTTP 使用 MSMQ 示範傳送 WCF 佇列訊息。這也會呼叫 SRMP 訊息處理。傳送佇列訊息時，在傳送端電腦上的 MSMQ 會透過 TCP 或 HTTP 傳輸，將訊息傳輸至接收端佇列管理員。如果使用者選擇 SRMP，就表示他選擇了 HTTP 做為佇列傳輸的傳輸機制。 SRMP Secure (SRMPS) 會啟用 HTTPS。

範例

此範例程式碼是以交易範例為基礎。當傳送訊息至佇列以及從佇列接收訊息時，其使用 SRMP 的方式，與使用原生通訊協定傳送和接收訊息的方式相同。

您可以變更用戶端的組態，指定所選擇的佇列傳輸通訊協定。佇列傳輸通訊協定可以是原生、SRMP 或 SrmpSecure 的其中一種通訊協定。根據預設，傳輸通訊協定為「原生」。在這個範例中，用戶端和服務會在組態中指定使用 SRMP。

相對於傳輸安全性，SRMP 會有一些限制。預設的 MSMQ 傳輸安全性需要有 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

共用方式為

SRMP

若要安裝、建置及執行範例

需求

示範

範例

其他資源