附录 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。