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

address

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

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

call-failover-timeout

在故障转移尝试期间调用时，请使用。默认值为 -1， 或没有超时。

call-timeout

当数据包通过集群连接发送时，且是一个阻塞调用，call-timeout 决定代理在抛出异常前等待（毫秒）回复的时长。默认值为 30000。

check-period

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

confirmation-window-size

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

connector-ref

标识将传送到集群中的其他代理的 connector，以便它们具有正确的集群拓扑。这个参数是必需的。

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

在每次重新连接尝试后增加 retry-interval 的倍数。默认值为 1。

use-duplicate-detection

集群连接使用网桥来链接代理，网桥可以配置为在转发的每个消息中添加重复的 ID 属性。如果网桥的目标代理崩溃，然后恢复，则消息可能会从源代理中重新发送。通过将 use-duplicate-detection 设置为 true，在目标代理时，所有重复的消息都会被过滤并忽略。默认值是 true。