调用事务

调用事务用于在目标节点上调用一个或多个集群命令。它类似于对集群中定义的命令进行的远程过程调用。

与写入事务类似,调用事务支持定时事务和非定时事务。如需详细了解限时事务,请参阅限时和不限时操作部分。

非定时调用事务

非定时调用事务的操作序列
图 1:非定时调用事务

调用请求操作

方向:发起方 -> 目标

与读取请求操作和写入请求操作类似,在此操作中,发起方会向目标提供:

  • 调用请求:指向集群命令的路径列表,以及命令的可选参数(名为命令字段)。
  • Timed Request:一个标志,用于指示此操作是否属于定时调用事务。
  • Suppress Response:一个标志,用于指示是否应抑制 Invoke Response Action。
  • 互动 ID:一个整数,用于将调用请求操作与调用响应操作进行匹配。

调用回答操作

方向:目标 -> 发起方

目标收到调用请求操作后,将使用调用响应操作完成事务,该操作包含:

  • 调用响应:针对每个发送的调用请求的命令响应或状态列表。
  • 互动 ID:一个整数,用于将调用响应操作与调用请求操作进行匹配。

非定时调用限制

调用请求操作可以是群播,但在这种情况下,必须设置禁止响应标志。其理由是,否则网络可能会被群组中每个成员的同时响应所淹没。

如需启用此行为,Invoke Requests 列表中使用的路径可以包含组,也可以包含通配符,但只能在 Endpoint 字段中。此外,如果操作是组播,则此事务会终止,且不返回任何响应。

定时调用事务

与定时写入事务类似,定时调用事务也从定时请求操作开始。

定时调用事务的操作顺序
图 2:定时调用事务

定时请求操作

方向:发起方 -> 目标

发起方通过发送包含以下内容的操作来启动事务:

  • 超时:此事务可以保持打开状态的毫秒数。在此期间,发起方发送的下一个操作将被视为有效。

收到定时请求操作后,目标必须通过状态响应操作确认定时请求操作。发起方收到报告无错误的状态响应操作后,将发送调用请求操作。

调用请求操作

与前面介绍的调用请求操作相同。

调用回答操作

与前面介绍的调用响应操作相同。

定时调用限制

所有调用命令都可以在定时互动中调用。定时请求操作、调用请求操作和调用响应操作仅限 Unicast,因此不能用作定时调用事务上的组播。

Invoke Request Action 支持使用包含群组的路径以及通配符,但 Invoke Response Action 不支持使用通配符。