附录 C. 集群连接配置元素

地址

每个集群连接仅适用于与 address 字段中指定的值匹配的地址。如果未指定地址，则所有地址都将进行负载平衡。

address 字段还支持以逗号分隔的地址列表。使用排除语法 ！ 以防止地址被匹配。以下是一些示例地址：

call-failover-timeout

在故障切换尝试期间发出调用时使用。默认值为 -1，或者没有超时。

call-timeout

当数据包通过集群连接发送时，且它是一个阻止调用，则 call-timeout 将确定代理在引发异常前等待（以毫秒为单位）回复的时长。默认值为 30000。

check-period

查看集群连接是否无法从另一个代理接收 ping 之间的检查间隔，以毫秒为单位。默认值为 30000。

confirmation-window-size

用于从连接到的代理发送确认的窗口的大小（以字节为单位）。当代理收到 确认-window-size 字节时，它会通知其客户端。默认值为 1048576。值 -1 表示没有窗口。

connector-ref

标识要传输到集群中的其他代理的 连接器，以便它们具有正确的集群拓扑。此参数是必需的。

connection-ttl

如果集群连接停止从集群中的特定代理接收消息，则决定集群连接应保持活动的时间。默认值为 60000。

discovery-group-ref

指向用于与群集中其他代理通信的 discovery-group。此元素必须包含属性 discovery-group-name，它必须匹配之前配置的 discovery-group 的 name 属性。

initial-connect-attempts

设置系统最初在集群中连接代理的次数。如果实现 max-retry，则这个代理会被视为永久停机，系统不会将消息路由到这个代理。默认值为 -1，这意味着无限重试。

max-hops

将代理配置为向代理加载均衡消息，这些代理只能作为链中的中间器间接连接到代理。这可以实现更复杂的拓扑结构，同时仍然提供消息负载平衡。默认值为 1，这意味着信息只分发到直接连接到这个代理的其他代理中。这个参数是可选的。

max-retry-interval

重试的最大延迟，以毫秒为单位。默认值为 2000。

message-load-balancing

决定消息是否以及如何在集群中的其他代理之间分发。包含 message-load-balancing 元素，以启用负载平衡。默认值为 ON_DEMAND。您还可以提供值。有效值为：

min-large-message-size

如果消息大小（以字节为单位）大于 min-large-message-size，则消息大小将在通过网络发送到其他群集成员时被分成多个网段。默认值为 102400。

notification-attempts

设置集群连接在连接到集群时应自行广播的次数。默认值为 2。

notification-interval

设置在附加到集群时，以毫秒为单位的集群连接广播本身的频率。默认值为 1000。

producer-window-size

集群连接的制作者流控制大小，以字节为单位。默认情况下禁用，但如果您在集群中使用真正大的消息，可能需要设置一个值。值 -1 表示没有窗口。

reconnect-attempts

设置系统尝试重新连接到集群中的代理的次数。如果实现 max-retry，则这个代理将被视为永久停机，系统将停止将信息路由到这个代理。默认值为 -1，这意味着无限重试。

retry-interval

以毫秒为单位确定重试尝试之间的间隔。如果创建了集群连接且目标代理还没有启动或正在引导，则来自其他代理的集群连接会重试连接到目标直到恢复。这个参数是可选的。默认值为 500 毫秒。

retry-interval-multiplier

用于在每次 重新连接尝试后增加重试间隔 的倍数。默认值为 1。

use-duplicate-detection

群集连接使用网桥连接代理，并且可以将网桥配置为在转发的每一消息中添加重复的 ID 属性。如果桥接的目标代理崩溃，然后恢复，则信息可能会从源代理中返回。通过将 use-duplicate-detection 设置为 true，任何重复的信息都会在目标代理接收时过滤并忽略。默认值为 true。