第四十二章 使用 WS-ReliableMessaging

IRIS 支持 WS-ReliableMessaging 規(guī)范的部分內(nèi)容，如簡介中所述。此規(guī)范提供了一種按順序可靠地傳遞一系列消息的機(jī)制。本頁介紹如何手動使用可靠消息傳遞。

從 Web 客戶端發(fā)送一系列消息

要將一系列消息從 IRIS Web 客戶端可靠地發(fā)送到支持 WS-ReliableMessaging 的 Web 服務(wù)，請執(zhí)行以下操作：

1. 根據(jù)需要指定 Web 客戶端的安全標(biāo)頭元素。

如果正在使用 WS-SecureConversation，請啟動安全對話。

2. 調(diào)用 %SOAP.RM.CreateSequence的 Create() 類方法。這將返回該類的一個(gè)實(shí)例。

此方法具有以下簽名：

classmethod Create(addressingNamespace As %String, oneWay As %Boolean = 0, retryInterval As %Float = 1.0, maxRetryCount As %Integer = 8, expires As %xsd.duration, SSLSecurity As %Boolean = 0) as %SOAP.RM.CreateSequence

• addressingNamespace 是用于 WS-Addressing 支持的命名空間。默認(rèn)值為“http://www.w3.org/2005/08/addressing”
• 如果僅創(chuàng)建請求序列，則 oneWay 為真。
• retryInterval 是重試之前等待的間隔（以秒為單位）。
• maxRetryCount 是未發(fā)生任何活動時(shí)的最大重試次數(shù)。
• expires 是 XML 格式的持續(xù)時(shí)間，用于指定要發(fā)送的序列的請求持續(xù)時(shí)間。
• SSLSecurity 指定 Web 客戶端是否使用 SSL 連接到 Web 服務(wù)。

3. 調(diào)用 Web 客戶端的 %StartRMSession() 方法，并的 %SOAP.RM.CreateSequence例作為參數(shù)傳遞。

請注意，使用 %SOAP.RM.CreateSequence 實(shí)例一次。也就是說，不能稍后使用它來創(chuàng)建另一個(gè)會話。

4. 根據(jù)需要調(diào)用 Web 方法。

每次使用相同的 Web 客戶端實(shí)例。

5. 發(fā)送消息完成后，調(diào)用 Web 客戶端的 %CloseRMSession() 方法。

重要提示：還要確保按照下一節(jié)中的說明簽署 WS-ReliableMessaging 標(biāo)頭。