👜 Springboot环境配置项
若您的项目依赖Spring Boot
,并加入了spring-boot-starter-forest
依赖,就可以通过 application.yml
/application.properties
方式定义配置。
# 配置后端 HTTP API
forest:
backend: okhttp3 # 配置后端HTTP API为 okhttp3
1
2
2
# 配置后端HTTP API为 okhttp3
forest.backend=okhttp3
1
2
2
// Make sure to add code blocks to your code group
目前 Forest 支持okhttp3
和httpclient
两种后端 HTTP API,若不配置该属性,默认为okhttp3
当然,您也可以改为httpclient
forest:
backend: httpclient # 配置后端HTTP API为 httpclient
1
2
2
# 配置后端HTTP API为 httpclient
forest.backend=httpclient
1
2
2
// Make sure to add code blocks to your code group
# 全局基本配置
在application.yaml
/ application.properties
中配置的 HTTP 基本参数
forest:
backend: okhttp3 # 后端HTTP框架(默认为 okhttp3)
max-connections: 1000 # 连接池最大连接数(默认为 500)
max-route-connections: 500 # 每个路由的最大连接数(默认为 500)
max-request-queue-size: 100 # [自v1.5.22版本起可用] 最大请求等待队列大小
max-async-thread-size: 300 # [自v1.5.21版本起可用] 最大异步线程数
max-async-queue-size: 16 # [自v1.5.22版本起可用] 最大异步线程池队列大小
timeout: 3000 # [已不推荐使用] 请求超时时间,单位为毫秒(默认为 3000)
connect-timeout: 3000 # 连接超时时间,单位为毫秒(默认为 timeout)
read-timeout: 3000 # 数据读取超时时间,单位为毫秒(默认为 timeout)
max-retry-count: 0 # 请求失败后重试次数(默认为 0 次不重试)
ssl-protocol: TLS # 单向验证的HTTPS的默认TLS协议(默认为 TLS)
log-enabled: true # 打开或关闭日志(默认为 true)
log-request: true # 打开/关闭Forest请求日志(默认为 true)
log-response-status: true # 打开/关闭Forest响应状态日志(默认为 true)
log-response-content: true # 打开/关闭Forest响应内容日志(默认为 false)
async-mode: platform # [自v1.5.27版本起可用] 异步模式(默认为 platform)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# 后端HTTP框架(默认为 okhttp3)
forest.backend=okhttp3
# 连接池最大连接数(默认为 500)
forest.max-connections=1000
# 每个路由的最大连接数(默认为 500)
forest.max-route-connections=500
# [自v1.5.22版本起可用] 最大请求等待队列大小
forest.max-request-queue-size=800
# [自v1.5.21版本起可用] 最大异步线程数
forest.max-async-thread-size=300
# [自v1.5.22版本起可用] 最大异步线程池队列大小
forest.max-async-queue-size=16
# (已不推荐使用) 请求超时时间,单位为毫秒(默认为 3000)
forest.timeout=3000
# 连接超时时间,单位为毫秒(默认为 timeout)
forest.connect-timeout=3000
# 数据读取超时时间,单位为毫秒(默认为 timeout)
forest.read-timeout=3000
# 请求失败后重试次数(默认为 0 次不重试)
forest.max-retry-count=0
# 单向验证的HTTPS的默认TLS协议(默认为 TLS)
forest.ssl-protocol=TLS
# 打开或关闭日志(默认为 true)
forest.log-enabled=true
# 打开/关闭Forest请求日志(默认为 true)
forest.log-request=true
# 打开/关闭Forest响应状态日志(默认为 true)
forest.log-response-status=true
# 打开/关闭Forest响应内容日志(默认为 false)
forest.log-response-content=true
# [自v1.5.27版本起可用] 异步模式(默认为 platform)
forest.async-mode=platform
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
// Make sure to add code blocks to your code group
注意
- 这里max-retry-count只是简单机械的请求失败后的重试次数,所以一般建议设置为0。
- 如果一定要多次重试,请一定要在保证服务端的幂等性的基础上进行重试,否则容易引发生产事故!
# 全局变量定义
Forest 可以在forest.variables
属性下自定义全局变量。
其中 key 为变量名,value 为变量值。
全局变量可以在任何模板表达式中进行数据绑定。
forest:
variables:
username: foo # 声明全局变量,变量名: username,变量值: foo
userpwd: bar # 声明全局变量,变量名: userpwd,变量值: bar
1
2
3
4
2
3
4
# 声明全局变量,变量名: username,变量值: foo
forest.variables.username=foo
# 声明全局变量,变量名: userpwd,变量值: bar
forest.variables.userpwd=bar
1
2
3
4
2
3
4
// Make sure to add code blocks to your code group
# 配置 Bean ID
Forest 允许您在 yaml 文件中配置 Bean Id,它对应着ForestConfiguration
对象在 Spring 上下文中的 Bean 名称。
forest:
bean-id: config0 # 在spring上下文中bean的id,默认值为forestConfiguration
1
2
2
# 在spring上下文中bean的id,默认值为forestConfiguration
forest.bean-id: config0
1
2
2
// Make sure to add code blocks to your code group
然后便可以在 Spring 中通过 Bean 的名称引用到它
@Resource(name = "config0")
private ForestConfiguration config0;
1
2
2
帮助我们改善此文档 (opens new window)
上次更新: 2023/06/19, 17:37:19