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