服务器设置

Overview

在本指南中，您可以学习；了解Java驱动程序如何管理服务器设置。

配置服务器设置

在连接字符串中包含以下参数，以修改驱动程序在与服务器交互时的行为：

选项名称	类型	说明
`appName`	字符串	指定在连接握手过程中提供给 MongoDB 实例的应用程序的名称。可用于服务器日志和分析。默认值：`null`
`serverMonitoringMode`	字符串	指定驱动程序使用的服务器监控协议。当设置为 `auto` 时，监控模式由驱动程序运行的环境决定。驱动程序在功能即服务（FaaS）环境中使用 `poll` 模式，在其他环境中使用 `stream` 模式。默认值：`auto`
`heartbeatFrequencyMS`	整型	指定驱动程序在尝试确定集群中每台服务器当前状态时的等待频率（以毫秒为单位）。默认：`10000`（10 秒）

此示例指定集群监控将每 15 秒尝试访问一次服务器：

ConnectionString connectionString = "mongodb://<host>:<port>/?heartbeatFrequencyMS=15000"MongoClient mongoClient = MongoClients.create(connectionString)

有关这些参数的更多信息，请参阅 ConnectionString API文档。

链接 applyToServerSettings() 方法，以修改驱动程序在监控每个 MongoDB 部署时的行为。

下表描述了可以链接到设置以修改驱动程序行为的方法：

方法	说明
`addServerListener()`	为服务器相关事件添加侦听器。
`addServerMonitorListener()`	为服务器监视器相关事件添加侦听器。
`applySettings()`	使用 `ServerSettings` 对象中指定的服务器设置。
`heartbeatFrequency()`	设置集群监视器尝试访问服务器的时间间隔。默认值：`10 seconds`
`minHeartbeatFrequency()`	设置服务器监控检查的最小间隔。默认值：`500 milliseconds`

此示例在 MongoDB 部署中指定了以下驱动程序行为：

服务器监控检查的最小间隔至少为 700 MILLISECONDS
集群监视器尝试访问服务器的时间间隔为 15 SECONDS

MongoClient mongoClient = MongoClients.create(    MongoClientSettings.builder().applyConnectionString(new ConnectionString("<your connection string>"))    .applyToServerSettings(builder ->        builder.minHeartbeatFrequency(700, MILLISECONDS)        .heartbeatFrequency(15, SECONDS))    .build());

有关链式方法的更多信息，请参阅 MongoClientSettings.Builder API文档。