附录 C. Cluster Connection Configuration 元素

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

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

connection-ttl

如果停止从集群中的特定代理接收信息，则集群连接应该保持多长时间。默认值为 60000。

discovery-group-ref

指向用于与集群中的其他代理通信的 发现 组。此元素必须包含属性 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。