Reliable Messaging Protocol 1.0 版
本主題涵蓋了 WS-Reliable Messaging February 2005 (1.0 版) 通訊協定的 Windows Communication Foundation (WCF) 實作詳細資料，此通訊協定是使用 HTTP 傳輸來進行交互操作時的必要項。WCF 遵循本主題所述 WS-Reliable Messaging 規格的相關限制與說明。請注意，.NET Framework 3.0 中開始實作 WS-ReliableMessaging 1.0 版通訊協定。
WS-Reliable Messaging February 2005 通訊協定可透過 ReliableSessionBindingElement 在 WCF 中實作。
為了方便起見，本主題將使用下列角色：
- 啟動器：啟動 WS-Reliable 訊息序列建立作業的用戶端
- 回應程式：接收啟動器要求的服務
本文件會使用下表的前置詞和命名空間。
| 前置詞 | 命名空間 |
|---|---|
wsrm |
https://schemas.xmlsoap.org/ws/2005/02/rm |
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 |
訊息
序列建立訊息
WCF 會實作 CreateSequence 和 CreateSequenceResponse 訊息以建立可靠訊息序列。以下是適用的條件約束：
- B1101：WCF 啟動器不會在 CreateSequence 訊息中產生選用的 Expires 項目，或當 CreateSequence 訊息包含 Offer 項目時，在 Offer 項目中產生選用的 Expires 項目。
- B1102：在存取 CreateSequence 訊息時，WCF Responder 會同時傳送與接收 Expires 項目 (如果兩者都存在的話)，但是不會使用它們的值。
WS-Reliable 訊息會使用 Offer 機制來建立兩個反向關聯序列以形成工作階段。
- R1103：如果 CreateSequence 包含 Offer 項目，則可信賴傳訊回應程式必須接收序列並以包含 wsrm:Accept 項目的 CreateSequenceResponse 來回應，以形成兩個相互關聯的反向序列，或是拒絕 CreateSequence 要求。
- R1104：流經反向序列的 SequenceAcknowledgement 和應用程式訊息必須傳送到 CreateSequence 的 ReplyTo 端點參考。
- R1105：CreateSequence 中的 AcksTo 和 ReplyTo 端點參考必須具有位址值以符合八位元規格。
WCF 回應程式會在建立序列之前，先驗證 AcksTo、ReplyTo EPR 的 URI 部分是否相同。 - R1106：CreateSequence 訊息中的 AcksTo 和 ReplyTo 端點參照應該具有相同的參照參數集合。
WCF 不會強制執行，但會假定 CreateSequence 上的 AcksTo 和 ReplyTo 之 [reference parameters] 都是一樣，並且使用來自 ReplyTo 端點參照的 [reference parameters]，以認可並與序列訊息對話。 - R1107：當兩個反向序列都是透過 Offer 機制建立時，流經反向序列的 SequenceAcknowledgement 和應用程式訊息必須傳送至 CreateSequence 的 ReplyTo 端點參考。
- R1108：當兩個反向序列都透過 Offer 機制建立時，wsrm:AcksTo 端點參考子項目 (屬於 CreateSequenceResponse 的 wsrm:Accept 項目) 的 [address] 屬性必須符合 CreateSequence 的目的地 URI 的位元組規格。
- R1109：當兩個反向序列都是透過 Offer 機制建立時，從啟動器傳送的訊息以及透過回應程式對訊息的認可，必須傳送至相同的端點參考。
WCF 使用 WS-Reliable 訊息在啟動器與回應程式之間建立可靠工作階段。WCF 的 WS-Reliable 訊息實作會針對單向、要求-回覆與全雙工訊息模式提供可靠工作階段。CreateSequence/CreateSequenceResponse 上的 WS-Reliable 訊息 Offer 機制可讓您建立兩個相互關聯的反向序列，並提供適用於所有訊息端點的工作階段通訊協定。由於 WCF 會針對此類工作階段提供安全性保證，包含工作階段完整性的端對端保護，因此可以實際地確保訊息會抵達預定的相同目的地。這麼做也可以針對應用程式訊息進行 Piggy-Backing 的序列認可作業。因此，R1104、R1105，和 R1108 的約束條件適用於 WCF。
CreateSequence 訊息的範例。
<s:Envelope>
<s:Header>
<a:Action s:mustUnderstand="1">
https://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">
https://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>
Sequence
下列清單列出適用於序列的條件約束：
- B1201：WCF 會產生並存取不超過 xs:long 最大含括值 (9223372036854775807) 的序號。
- B1202： WCF 一律使用 https://schemas.xmlsoap.org/ws/2005/02/rm/LastMessage 的動作 URI 來產生最後一則主體空白的訊息。
- B1203：只要動作 URI 不是 https://schemas.xmlsoap.org/ws/2005/02/rm/LastMessage，WCF 會透過序列標頭 (其中包含 LastMessage 項目) 來接收與傳遞訊息。
序列標頭的範例。
<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 標頭做為 Keep-Alive 機制。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 訊息所提供的序列認可使用 Piggy-Back 機制。
R1401：當兩個反向序列透過 Offer 機制建立時，SequenceAcknowledgement 標頭可以包含在任何傳送至目的收件者的應用程式訊息中。
B1402：當 WCF 在收到任何序列訊息之前必須先產生認可時 (例如，為了滿足 AckRequested 訊息)，WCF 會產生包含範圍 0-0 的 SequenceAcknowledgement 標頭，如下列範例所示。
<wsrm:SequenceAcknowledgement> <wsrm:Identifier> urn:uuid:addabbbf-60cb-44d3-8c5b-9e0841629a36 </wsrm:Identifier> <wsrm:AcknowledgementRange Upper="0" Lower="0"/> </wsrm:SequenceAcknowledgement>B1403：WCF 不會產生包含 Nack 項目的 SequenceAcknowledgement 標頭，但是支援 Nack 項目。
WS-ReliableMessaging 錯誤
下列清單列出適用於 WCF 之 WS-Reliable 訊息錯誤實作的條件約束：
B1501：WCF 不會產生 MessageNumberRollover 錯誤。
B1502： WCF 端點可能會產生 CreateSequenceRefused 錯誤，如規格所述。
B1503：當服務端點抵達自身的連線限制，而且無法處理新的連線時，WCF 就會產生額外的 CreateSequenceRefused 錯誤子代碼 (netrm:ConnectionLimitReached)，如下列範例所示。
<s:Envelope> <s:Header> <wsa:Action> https://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 訊息是使用 WS-Addressing，WCF WS-Reliable 訊息實作可能會產生並傳送 WS-Addressing 錯誤。本節涵蓋 WCF 在 WS-Reliable 訊息層明確產生的 WS-Addressing 錯誤：
- B1601：當下列任一情形發生時，WCF 就會產生「需要訊息定址標頭」錯誤：
- 訊息缺少 Sequence 標頭和 Action 標頭。
- CreateSequence 訊息缺少 MessageId 標頭。
- CreateSequence 訊息缺少 ReplyTo 標頭。
- B1602：WCF 會產生「操作不受支援」錯誤以回應訊息 (此訊息缺少了 Sequence 標頭並具有無法被 WS-Reliable 訊息規格所識別的 Action 標頭)。
- B1603：WCF 會產生「無法使用端點」錯誤，表示端點不會根據 CreateSequence 訊息的定址標頭檢查結果來處理序列。
通訊協定組合
與 WS-Addressing 組合
WCF 支援兩種版本的 WS-Addressing：WS-Addressing 2004/08 [WS-ADDR] 和 W3C WS-Addressing 1.0 建議 [WS-ADDR-CORE] 和 [WS-ADDR-SOAP]。
儘管 WS-Reliable 訊息規格只提到 WS-Addressing 2004/08，它並未限制要使用的 WS-Addressing 版本。下列清單列出適用於 WCF 的條件約束：
- R2101：WS-Addressing 2004/08 和 WS-Addressing 1.0 皆可搭配 WS-Reliable 訊息一起使用。
- R2102：****單一版本的 WS-Addressing 必須透過 wsrm:Offer 機制，用在整個特定的 WS-Reliable 訊息序列或是一對相關聯的反向序列上。
與 SOAP 組合
WCF 同時支援 SOAP 1.1 和 SOAP 1.2 搭配 WS-Reliable 訊息一起使用。
與 WS-Security 和 WS-SecureConversation 組合
WCF 透過安全傳輸 (HTTPS)、與 WS-Security 組合，以及與 WS-Secure Conversation 組合，為 WS-Reliable 訊息序列提供保護。下列清單列出適用於 WCF 的條件約束：
- R2301：為了在個別訊息的完整性與機密性之外保護 WS-Reliable 訊息序列的完整性，WCF 要求必須使用 WS-Secure Conversation。
- R2302：在建立 WS-Reliable 訊息序列之前，必須先建立 ****WS-Secure Conversation 工作階段。
- R2303：如果 WS-Reliable 訊息序列的存留期超過 WS-Secure Conversation 工作階段的存留期，則使用 WS-Secure Conversation 建立的 SecurityContextToken 必須透過對應的 WS-Secure Conversation 更新繫結來加以更新。
- B2304：WS-Reliable 訊息序列或是一對相互關聯的反向序列一律繫結至單一 WS-SecureConversation 工作階段。
WCF 來源會在 CreateSequence 訊息的項目擴充性區段中產生 wsse:SecurityTokenReference 項目。 - R2305：一旦與 WS-Secure Conversation 組合，CreateSequence 訊息必須包含 wsse:SecurityTokenReference 項目。
WS-Reliable 訊息 WS-Policy 判斷提示
WCF 使用 WS-Reliable 訊息 WS-Policy 判斷提示 wsrm:RMAssertion 來描述各項端點功能。下列清單列出適用於 WCF 的條件約束：
B3001：WCF 會將 wsrm:RMAssertion WS-Policy 判斷提示附加至 wsdl:binding 項目。WCF 同時支援附加至 wsdl:binding 和 wsdl:port 項目。
B3002：WCF 支援下列選用的 WS-Reliable 訊息判斷提示屬性，並在 WCF ReliableMessagingBindingElement 上針對它們提供控制：
- wsrm:InactivityTimeout
- wsrm:AcknowledgementInterval
範例如下。
<wsrm:RMAssertion> <wsrm:InactivityTimeout Milliseconds="600000" /> <wsrm:AcknowledgementInterval Milliseconds="200" /> </wsrm:RMAssertion>
WS-Reliable 訊息延伸的流量控制
WCF 會透過 WS-Reliable 訊息擴充性，針對序列訊息流量提供其他更嚴格的選擇性控制。
您可以將 ReliableSessionBindingElement 的 FlowControlEnabled bool 屬性設為 true 來啟用流量控制。下列清單列出適用於 WCF 的條件約束：
B4001：一旦啟用了可信賴傳訊流量控制，WCF 就會在 SequenceAcknowledgement 標頭的項目擴充性中產生 netrm:BufferRemaining 項目。
B4002：一旦啟用了可信賴傳訊流量控制，WCF 不會要求 SequenceAcknowledgement 中一定得存在 netrm:BufferRemaining 項目，如下列範例所示。
<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 會產生介於 0 到 4096 (含) 之間的 netrm:BufferRemaining 整數值，並讀取介於 0 和 xs:int 的 maxInclusive 值 214748364 (含) 之間的整數值。
訊息交換模式
本節將說明當不同訊息交換模式使用 WS-Reliable 訊息時，WCF 的行為。在每個訊息交換模式中，會考慮下列兩種部署案例：
- 不可定址的啟動器：啟動器位於防火牆後方，回應程式只能透過 HTTP 回應將訊息傳送至啟動器。
- 可定址的啟動器：可將 HTTP 要求同時傳送給啟動器與回應程式，亦即可建立兩個反向 HTTP 連線。
單向、不可定址啟動器
繫結
WCF 透過在一個 HTTP 通道上使用一個序列的方式，提供單向的訊息交換模式。WCF 會使用 HTTP 要求將所有訊息從 RMS 傳送至 RMD，並透過 HTTP 回應將所有訊息從 RMD 傳送至 RMS。
CreateSequence 交換
WCF 啟動器會產生不含提議的 CreateSequence 訊息。WCF 回應程式會在建立序列之前，確保 CreateSequence 不含提議。WCF 回應程式會以 CreateSequenceResponse 訊息來回覆 CreateSequence 要求。
SequenceAcknowledgement
WCF 啟動器會處理所有訊息回覆的認可，除了 CreateSequence 訊息與錯誤訊息以外。WCF 回應程式一律產生獨立認可，以同時回應序列和 AckRequested 訊息。
TerminateSequence 訊息
WCF 會將 TerminateSequence 視為單向作業，代表 HTTP 回應具有空白主體與 HTTP 202 狀態碼。
單向、可定址啟動器
繫結
WCF 透過在一個傳入與一個傳出 HTTP 通道上使用一個序列的方式，提供單向的訊息交換模式。WCF 會使用 HTTP 要求來傳送所有訊息。所有的 HTTP 回應都有空本文和 HTTP 202 狀態碼。
CreateSequence 交換
WCF 啟動器會產生不含提議的 CreateSequence 訊息。WCF 回應程式會在建立序列之前，確保 CreateSequence 不含提議。WCF 回應程式會透過以 ReplyTo 端點參考發出的 HTTP 要求來傳送 CreateSequenceResponse 訊息。
雙工、可定址啟動器
繫結
WCF 透過在一個傳入與一個傳出 HTTP 通道上使用兩個序列的方式，提供完整非同步的雙向訊息交換模式。WCF 會使用 HTTP 要求來傳送所有訊息。所有的 HTTP 回應都有空本文和 HTTP 202 狀態碼。
CreateSequence 交換
WCF 啟動器會產生內含提議的 CreateSequence 訊息。WCF 回應程式會在建立序列之前，確定 CreateSequence 含有提議。WCF 會依定址為 CreateSequence 之 ReplyTo 端點參考的 HTTP 要求傳送 CreateSequenceResponse。
序列存留期
WCF 會將兩個序列視為一個全雙工工作階段。
在產生可挑剔某個序列的錯誤時，WCF 預期遠端端點將同時挑剔兩個序列。在讀取可挑剔某個序列的錯誤時，WCF 將同時挑剔兩個序列。
WCF 可關閉本身的傳出序列並繼續處理其傳入序列中的訊息。反之，WCF 可以處理傳入序列的關閉作業並繼續傳送其傳出序列中的訊息。
要求-回覆、不可定址啟動器
繫結
WCF 透過在一個 HTTP 通道上使用兩個序列的方式，提供單向、要求-回覆的訊息交換模式。WCF 會使用 HTTP 要求來傳送要求序列的訊息，並透過 HTTP 回應來傳送回覆序列的訊息。
CreateSequence 交換
WCF 啟動器會產生內含提議的 CreateSequence 訊息。WCF 回應程式會在建立序列之前，確保 CreateSequence 包含提議。WCF 回應程式會以 CreateSequenceResponse 訊息來回覆 CreateSequence 要求。
單向訊息
為了成功完成單向訊息交換通訊協定，WCF 啟動器會透過 HTTP 要求傳送要求序列訊息，並透過 HTTP 回應接收獨立的 SequenceAcknowledgement 訊息。SequenceAcknowledgement 必須認可傳送的訊息。
WCF 回應程式可透過認可、錯誤或是內含空白主體與 HTTP 202 狀態碼的回應來回覆要求。
雙向訊息
為了成功完成雙向訊息交換通訊協定，WCF 啟動器會透過 HTTP 要求傳送要求序列訊息，並透過 HTTP 回應接收回覆序列訊息。回應中必須包含認可傳輸之要求序列訊息的 SequenceAcknowledgement。
WCF 回應程式可透過應用程式回覆、錯誤或是內含空本文與 HTTP 202 狀態碼的回應來回覆要求。
由於單向訊息與應用程式回覆時機的緣故，要求序列訊息的序號與回應訊息的序號彼此並未互相關聯。
重試回覆
WCF 仰賴 HTTP 要求-回覆相互關聯來執行雙向訊息交換通訊協定的相互關聯作業。由於這個緣故，WCF 啟動器不會在認可要求序列訊息時停止重試要求序列訊息，而會在 HTTP 回應內含認可、使用者訊息，或是錯誤時，才停止重試要求序列訊息。WCF 回應程式會在與回覆相互關聯之要求的 HTTP 要求階段上重試回覆。
LastMessage 交換
WCF 啟動器會產生主體空白的最後一則訊息，並透過 HTTP 要求階段來傳送。WCF 需要回應，但會忽略實際的回應訊息。WCF 回應程式會透過回覆序列中主體空白的最後一則訊息，回覆要求序列中主體空白的最後一則訊息。
如果 WCF 回應程式收到的最後一則訊息所包含的動作 URI 不是 https://schemas.xmlsoap.org/ws/2005/02/rm/LastMessage，則 WCF 會透過最後一則訊息來回覆。在雙向訊息交換通訊協定的情況中，最後一則訊息包含應用程式訊息；在單向訊息交換通訊協定的情況中，最後一則訊息包含空白主體。
WCF 回應程式不會要求針對回覆序列中主體空白的最後一則訊息進行認可。
TerminateSequence 交換
一旦所有要求都收到有效回覆，WCF 啟動器會產生要求序列的 TerminateSequence 訊息，並透過 HTTP 要求階段來傳送。WCF 需要回應，但會忽略實際回應訊息。WCF 回應程式會透過回覆序列的 TerminateSequence 訊息，回覆要求序列的 TerminateSequence 訊息。
在正常的關機序列中，兩個 TerminateSequence 訊息會同時包含完整範圍的 SequenceAcknowledgement。
要求/回覆、可定址啟動器
繫結
WCF 透過在一個傳入與一個傳出 HTTP 通道上使用兩個序列的方式，提供單要求-回覆訊息交換模式。WCF 會使用 HTTP 要求來傳送所有訊息。所有的 HTTP 回應都有空本文和 HTTP 202 狀態碼。
CreateSequence 交換
WCF 啟動器會產生內含提議的 CreateSequence 訊息。WCF 回應程式會在建立序列之前，確定 CreateSequence 含有提議。WCF 會依定址為 CreateSequence 之 ReplyTo 端點參考的 HTTP 要求傳送 CreateSequenceResponse。
要求/回覆相互關聯
WCF 啟動器會確保所有應用程式要求訊息都帶有 MessageId 和 ReplyTo 端點參考。WCF 啟動器會將 CreateSequence 訊息的 ReplyTo 端點參照套用到每個應用程式要求訊息上。WCF 回應程式會要求傳入的要求訊息都帶有 MessageId 和 ReplyTo。WCF 回應程式會確保 CreateSequence 和所有應用程式要求訊息的端點參照一模一樣。