ApiBoot v2.2.7版本发布,新增扩展SpringBoot Mongo详细配置组件

知识改变命运,撸码使我快乐,2020继续游走在开源界

点赞再看,养成习惯

给我来个Star吧,点击了解下基于SpringBoot的组件化接口服务落地解决方案

ApiBoot 是什么?

ApiBoot 是接口服务的落地解决方案,提供了一系列开箱即用的组件,通过封装来简化主流第三方框架的集成,从而提高开发者开发效率、学习成本、降低入门门槛,真正的实现开箱即用!!!

image

更多开源信息请访问:https://blog.yuqiyu.com/opensource/

ApiBoot所属minbox-projects开源组织:

image

SpringBoot简单了解的开发者就可以编写安全稳定的接口服务,可为移动端、网页端等多个端点提供丰富的安全接口。

ApiBoot依赖于SpringBoot,完全遵循SpringBoot自定义Starter的规范实现,可以使用ApiBoot构建独立的Java应用程序,主要的职责是封装并且落地项目中常用到的第三方依赖,未来会接入越来越多优秀的开源项目,提供统一的SpringBoot集成解决方案。

愿景:

  • 为Java开发者提供低门槛第三方框架集成解决方案,让复杂的框架集成使用的门槛更低。
  • 开箱即用,内部封装了主流框架,只需添加依赖、简单配置即可使用。
  • 各个组件可独立使用,不再冗余你的应用程序。
  • 可简单快速的构建安全的restful资源接口服务。
  • 可用于构建SpringCloud微服务服务实例。

如果您想要系统的学习 ApiBoot 可以访问我的博客:https://blog.yuqiyu.com/apiboot-all-articles.html或者官方文档:https://apiboot.minbox.org

v2.2.7 更新日志 ✨

  • 新增mongo-client-settings组件(扩展SpringBoot Mongo配置)

  • 修复Swagger组件使用spring-boot-starter-validation(SpringBoot v2.3.x+)#issues 20

  • 更新部分源码注释内容

ApiBoot Mongo Settings

我们通过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-seconds 10000 设置Socket连接超时时间,单位:毫秒
api.boot.mongo.settings.socket.read-timeout-milli-seconds 10000 设置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-seconds 10000 设置心跳Socket连接超时时间,单位:毫秒
api.boot.mongo.settings.heartbeat-socket.read-timeout-milli-seconds 10000 设置心跳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-seconds 500 设置与Server端保持最小心跳频率时间,单位:毫秒
api.boot.mongo.settings.server.heartbeat-frequency-milli-seconds 10000 设置群集监视器尝试访问每个服务器的时间频率,单位:毫秒
api.boot.mongo.settings.connection-pool.min-size 100 允许的最大连接数
api.boot.mongo.settings.connection-pool.max.size 最小连接数
api.boot.mongo.settings.connection-pool.max-wait-time-milli-seconds 120000 线程等待连接可用的最长时间,单位:毫秒
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-seconds 15 设置本地阈值,单位:毫秒
api.boot.mongo.settings.cluster.server-selection-timeout-milli-seconds 30000 设置选择服务器时要应用的超时时间,单位:毫秒
api.boot.mongo.settings.cluster.mode 设置此集群的模式
api.boot.mongo.settings.cluster.required-cluster-type UNKNOWN 设置集群所需的集群类型
api.boot.mongo.settings.cluster.required-replica-set-name 设置集群所需的副本集名称
api.boot.mongo.settings.ssl.enabled false 定义是否应启用SSL。
api.boot.mongo.settings.invalid-host-name-allowed false 定义是否应允许无效的主机名。

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

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

作者个人 博客
使用开源框架 ApiBoot 助你成为Api接口服务架构师