第四十二章 使用 WS-ReliableMessaging
文章目录
- 第四十二章 使用 WS-ReliableMessaging
- 从 `Web` 客户端发送一系列消息
第四十二章 使用 WS-ReliableMessaging
IRIS 支持 WS-ReliableMessaging 规范的部分内容，如简介中所述。此规范提供了一种按顺序可靠地传递一系列消息的机制。本页介绍如何手动使用可靠消息传递。
从 Web 客户端发送一系列消息
要将一系列消息从 IRIS Web 客户端可靠地发送到支持 WS-ReliableMessaging 的 Web 服务，请执行以下操作：
- 根据需要指定
Web客户端的安全标头元素。
如果正在使用 WS-SecureConversation，请启动安全对话。
- 调用
%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服务。
- 调用
Web客户端的%StartRMSession()方法，并的%SOAP.RM.CreateSequence例作为参数传递。
请注意，使用 %SOAP.RM.CreateSequence 实例一次。也就是说，不能稍后使用它来创建另一个会话。
- 根据需要调用
Web方法。
每次使用相同的 Web 客户端实例。
- 发送消息完成后，调用
Web客户端的%CloseRMSession()方法。
重要提示：还要确保按照下一节中的说明签署 WS-ReliableMessaging 标头。