id | title | sidebar_label |
---|---|---|
non_spring_boot_config | 普通项目配置 | 普通项目配置 |
若您的项目不是Spring Boot
项目,或者没有依赖spring-boot-starter-forest
,可以通过下面方式定义 Forest 配置。
创建 ForestConfiguration 对象
ForestConfiguration
为 Forest 的全局配置对象类,所有的 Forest 的全局基本配置信息由此类进行管理。
ForestConfiguration
对象的创建方式:调用静态方法ForestConfiguration.configuration()
,此方法会创建 ForestConfiguration 对象并初始化默认值。
ForestConfiguration configuration = ForestConfiguration.configuration();
配置后端 HTTP API
configuration.setBackendName("okhttp3");
目前 Forest 支持okhttp3
和httpclient
两种后端 HTTP API,若不配置该属性,默认为okhttp3
。
当然,您也可以改为httpclient
configuration.setBackendName("httpclient");
全局基本配置
// 连接池最大连接数,默认值为500
configuration.setMaxConnections(123);
// 每个路由的最大连接数,默认值为500
configuration.setMaxRouteConnections(222);
// 请求超时时间,单位为毫秒, 默认值为3000
configuration.setTimeout(3000);
// 连接超时时间,单位为毫秒, 默认值为2000
configuration.setConnectTimeout(2000);
// 请求失败后重试次数,默认为0次不重试
configuration.setRetryCount(3);
// 单向验证的HTTPS的默认SSL协议,默认为SSLv3
configuration.setSslProtocol(SSLUtils.SSLv3);
// 打开或关闭日志,默认为true
configuration.setLogEnabled(true);
:::caution 注意
- 这里setRetryCount只是简单机械的请求失败后的重试次数,所以一般建议设置为0。
- 如果一定要多次重试,请一定要在保证服务端的幂等性的基础上进行重试,否则容易引发生产事故! :::
全局变量定义
Forest 可以通过ForestConfiguration
对象的setVariableValue
方法自定义全局变量。
其中第一个参数为变量名,第二个为变量值。
全局变量可以在任何模板表达式中进行数据绑定。
ForestConfiguration configuration = ForestConfiguration.configuration();
...
configuration.setVariableValue("username", "foo");
configuration.setVariableValue("userpwd", "bar");