跳到主要内容

Spring Mongo配置参数扩展组件

ApiBoot Mongo Settings​

对spring-boot-starter-data-mongo依赖配置参数的扩展，该组件在v2.2.7后新增。

我们通过SpringBoot整合mongoDB时，一般会直接使用spring-boot-starter-data-mongo这个依赖，而SpringBoot内部所提供的配置参数较少，详情请访问SpringBoot官方文档。

我们比较常见的一个问题：Mongo连接超时。

mongo并不是没有提供对应的参数配置方式，只是SpringBoot并未做出声明式的定义。

1. 添加依赖组件​

在pom.xml配置文件内添加如下：

<dependency>
  <groupId>org.minbox.framework</groupId>
  <artifactId>api-boot-starter-mongo-client-settings</artifactId>
</dependency>
提示

如果未添加ApiBoot版本依赖，请访问版本依赖查看添加方式，api-boot-starter-mongo-client-settings并不能代替spring-boot-starter-data-mongo依赖，只是针对它的配置参数扩展。

2. 提供的扩展参数​

参数名默认值描述
api.boot.mongo.settings.socket.connect-timeout-milli-seconds10000设置Socket连接超时时间，单位：毫秒
api.boot.mongo.settings.socket.read-timeout-milli-seconds10000设置Socket读取超时时间，单位：毫秒
api.boot.mongo.settings.socket.receive-buffer-size设置接收缓冲区的大小
api.boot.mongo.settings.socket.send-buffer-size设置发送缓冲区的大小
api.boot.mongo.settings.heartbeat-socket.connect-timeout-milli-seconds10000设置心跳Socket连接超时时间，单位：毫秒
api.boot.mongo.settings.heartbeat-socket.read-timeout-milli-seconds10000设置心跳Socket读取超时时间，单位：毫秒
api.boot.mongo.settings.heartbeat-socket.receive-buffer-size设置心跳Socket接收缓冲区的大小
api.boot.mongo.settings.heartbeat-socket.send-buffer-size设置心跳Socket发送缓冲区的大小
api.boot.mongo.settings.server.min-heartbeat-frequency-milli-seconds500设置与Server端保持最小心跳频率时间，单位：毫秒
api.boot.mongo.settings.server.heartbeat-frequency-milli-seconds10000设置群集监视器尝试访问每个服务器的时间频率，单位：毫秒
api.boot.mongo.settings.connection-pool.min-size100允许的最大连接数
api.boot.mongo.settings.connection-pool.max.size最小连接数
api.boot.mongo.settings.connection-pool.max-wait-time-milli-seconds120000线程等待连接可用的最长时间，单位：毫秒
api.boot.mongo.settings.connection-pool.max-connection-life-time-milli-seconds池化连接可以生存的最长时间，单位：毫秒
api.boot.mongo.settings.connection-pool.max-connection-idle-time-milli-seconds池化连接的最大空闲时间，单位：毫秒
api.boot.mongo.settings.connection-pool.maintenance-frequency-milli-seconds维护作业运行之间的时间段，单位：毫秒
api.boot.mongo.settings.connection-pool.maintenance-initial-delay-milli-seconds在连接池上运行第一个维护作业之前要等待的时间，单位：毫秒
api.boot.mongo.settings.cluster.local-threshold-milli-seconds15设置本地阈值，单位：毫秒
api.boot.mongo.settings.cluster.server-selection-timeout-milli-seconds30000设置选择服务器时要应用的超时时间，单位：毫秒
api.boot.mongo.settings.cluster.mode设置此集群的模式
api.boot.mongo.settings.cluster.required-cluster-typeUNKNOWN设置集群所需的集群类型
api.boot.mongo.settings.cluster.required-replica-set-name设置集群所需的副本集名称
api.boot.mongo.settings.ssl.enabledfalse定义是否应启用SSL。
api.boot.mongo.settings.invalid-host-name-allowedfalse定义是否应允许无效的主机名。

针对连接超时的问题，我们就可以通过api.boot.mongo.settings.socket相关配置参数来解决，参考如下所示：

# ApiBoot相关配置
api:
  boot:
    mongo:
      settings:
        socket:
          # 读取Server的超时时间，单位：毫秒
          read-timeout-milli-seconds: 60000
          # 连接Server的超时时间，单位：毫秒
          connect-timeout-milli-seconds: 60000