🎒 原生Java环境配置项
若您的项目不是Spring Boot
项目,或者没有依赖spring-boot-starter-forest
,可以通过下面方式定义 Forest 配置。
# 创建 ForestConfiguration 对象
ForestConfiguration
为 Forest 的全局配置对象类,所有的 Forest 的全局基本配置信息由此类进行管理。
ForestConfiguration
对象的创建方式:调用静态方法Forest.config()
,此方法会创建/获取全局唯一的 ForestConfiguration 对象并初始化默认值。
ForestConfiguration configuration = Forest.config();
1
# 配置后端 HTTP API
configuration.setBackendName("okhttp3");
1
目前 Forest 支持okhttp3
和httpclient
两种后端 HTTP API,若不配置该属性,默认为okhttp3
。
当然,您也可以改为httpclient
configuration.setBackendName("httpclient");
1
# 全局基本配置
// 连接池最大连接数,默认值为500
configuration.setMaxConnections(123);
// 每个路由的最大连接数,默认值为500
configuration.setMaxRouteConnections(222);
// [自v1.5.22版本起可用] 最大请求等待队列大小
configuration.setMaxRequestQueueSize(100);
// [自v1.5.21版本起可用] 最大异步线程数
configuration.setMaxAsyncThreadSize(300);
// [自v1.5.22版本起可用] 最大异步线程池队列大小
configuration.setMaxAsyncQueueSize(16);
// 请求超时时间,单位为毫秒, 默认值为3000
configuration.setTimeout(3000);
// 连接超时时间,单位为毫秒, 默认值为2000
configuration.setConnectTimeout(2000);
// 设置重试器
configuration.setRetryer(BackOffRetryer.class);
// 请求失败后重试次数,默认为0次不重试
configuration.setMaxRetryCount(0);
// 单向验证的HTTPS的默认SSL协议,默认为SSLv3
configuration.setSslProtocol(SSLUtils.SSLv3);
// 打开或关闭日志,默认为true
configuration.setLogEnabled(true);
// [自v1.5.27版本起可用] 异步模式(默认为 platform)
configuration.setAsyncMode(ForestAsyncMode.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
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
注意
- 这里setRetryCount只是简单机械的请求失败后的重试次数,所以一般建议设置为0。
- 如果一定要多次重试,请一定要在保证服务端的幂等性的基础上进行重试,否则容易引发生产事故!
# 全局变量定义
Forest 可以通过ForestConfiguration
对象的setVariableValue
方法自定义全局变量。
其中第一个参数为变量名,第二个为变量值。
全局变量可以在任何模板表达式中进行数据绑定。
ForestConfiguration configuration = ForestConfiguration.configuration();
...
configuration.setVariableValue("username", "foo");
configuration.setVariableValue("userpwd", "bar");
1
2
3
4
2
3
4
帮助我们改善此文档 (opens new window)
上次更新: 2024/02/27, 12:43:35