第四十二章 使用 WS-ReliableMessaging

IRIS 支持 WS-ReliableMessaging 规范的部分内容，如简介中所述。此规范提供了一种按顺序可靠地传递一系列消息的机制。本页介绍如何手动使用可靠消息传递。

从 Web 客户端发送一系列消息

要将一系列消息从 IRIS Web 客户端可靠地发送到支持 WS-ReliableMessaging 的 Web 服务，请执行以下操作：

1. 根据需要指定 Web 客户端的安全标头元素。

如果正在使用 WS-SecureConversation，请启动安全对话。

2. 调用 %SOAP.RM.CreateSequence的 Create() 类方法。这将返回该类的一个实例。

此方法具有以下签名：

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 支持的命名空间。默认值为“http://www.w3.org/2005/08/addressing”
• 如果仅创建请求序列，则 oneWay 为真。
• retryInterval 是重试之前等待的间隔（以秒为单位）。
• maxRetryCount 是未发生任何活动时的最大重试次数。
• expires 是 XML 格式的持续时间，用于指定要发送的序列的请求持续时间。
• SSLSecurity 指定 Web 客户端是否使用 SSL 连接到 Web 服务。

3. 调用 Web 客户端的 %StartRMSession() 方法，并的 %SOAP.RM.CreateSequence例作为参数传递。

请注意，使用 %SOAP.RM.CreateSequence 实例一次。也就是说，不能稍后使用它来创建另一个会话。

4. 根据需要调用 Web 方法。

每次使用相同的 Web 客户端实例。

5. 发送消息完成后，调用 Web 客户端的 %CloseRMSession() 方法。

重要提示：还要确保按照下一节中的说明签署 WS-ReliableMessaging 标头。