附录 C. Cluster Connection Configuration Elements

address

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

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

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。此元素必须包含属性 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

决定重试尝试之间的间隔，以毫秒为单位。如果创建了 cluster connection 且目标代理尚未启动或启动，则来自其他代理的群集连接将重试连接到目标，直到备份为止。这个参数是可选的。默认值为 500 毫秒。

retry-interval-multiplier

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

use-duplicate-detection

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