4.3. 连接 URI

连接配置使用连接 URI。连接 URI 指定远程主机、端口和一组配置选项，这些选项设置为查询参数。有关可用选项的详情请参考 第 5 章 配置选项。

<scheme>://<host>:<port>[?<option>=<value>[&<option>=<value>...]]

<scheme>://<host>:<port>[?<option>=<value>[&<option>=<value>...]]

这个方案是 amqp 用于未加密的连接，amqps 用于 SSL/TLS 连接。

例如，以下连接 URI 通过端口 5672 连接到主机 example.net，并将客户端 ID 设置为 backend ：

amqp://example.net:5672?jms.clientID=backend

amqp://example.net:5672?jms.clientID=backend

故障切换 URI

配置故障转移后，客户端可以自动重新连接到另一服务器（如果与当前服务器的连接丢失）。故障切换 URI 具有前缀 failover:，它包含在括号内以逗号分隔的连接 URI 列表。末尾指定了附加选项。

failover:(<connection-uri>[,<connection-uri>...])[?<option>=<value>[&<option>=<value>...]]

failover:(<connection-uri>[,<connection-uri>...])[?<option>=<value>[&<option>=<value>...]]

例如，以下是可以连接到两个主机 host1 或 host2 的故障切换 URI：

failover:(amqp://host1:5672,amqp://host2:5672)?jms.clientID=backend

failover:(amqp://host1:5672,amqp://host2:5672)?jms.clientID=backend

与连接 URI 示例一样，客户端可以使用故障转移配置中的 URI 配置多个不同的设置。这些设置在 第 5 章 配置选项 中详细介绍，第 5.5 节 “故障切换选项” 部分特别值得关注。

SSL/TLS Server Name Indication

当 amqps 方案用于指定 SSL/TLS 连接时，JVM 的 TLS Server Name Indication(SNI)扩展可以使用 URI 的主机片段在 TLS 握手期间通信所需的服务器主机名。如果指定了完全限定域名（如"myhost.mydomain"），但没有指定非限定名称（例如："myhost"）或裸机 IP 地址，则会自动包含 SNI 扩展。