知识改变命运,撸码使我快乐,2020继续游走在开源界
点赞再看,养成习惯
给我来个Star吧,点击了解下基于SpringBoot的组件化接口服务落地解决方案
ApiBoot 是什么?
ApiBoot
是接口服务的落地解决方案,提供了一系列开箱即用的组件,通过封装来简化主流第三方框架的集成,从而提高开发者开发效率、学习成本、降低入门门槛,真正的实现开箱即用!!!
更多开源信息请访问:https://blog.yuqiyu.com/opensource/
ApiBoot所属minbox-projects开源组织:
对 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