2.设置接口
更新时间:2019-06-19
2.1 获取服务实例
- 接口形式:BDHttpDns getService(Context context);
- 参数:Context context,用户需传入app的上下文对象
- 返回值:BDHttpDns单例对象,用于HTTPDNS解析
2.2 设置HTTPDNS的账号ID
- 接口形式:void setAccountID(String accountID);
-
参数:String accountID
- 字符串长度上限为64字节
-
异常:
- 对于非法输入,会抛出IllegalArgumentException异常
2.3 设置secret配置信息
- 接口形式:void setSecret(String secret);
-
参数:String secret
- 字符串长度上限为64字节
-
异常:
- 对于非法输入,会抛出IllegalArgumentException异常
2.4 设置预加载域名
- 接口形式:void setPreResolveHosts(ArrayList
hosts); - 参数:ArrayList
hosts -
说明:
- 用于初始化后,对常用域名进行预加载,避免初次请求时缓存不命中
- 调用该接口后,立刻在后台发起异步解析请求
2.5 设置HTTPDNS缓存过期处理策略
- 接口形式:void setCachePolicy(CachePolicy policy)
-
参数:CachePolicy policy
-
policy定义为enum CachePolicy 类型, 取值为:
- POLICY_AGGRESSIVE:激进的使用过期缓存策略
- POLICY_TOLERANT:一定限度容忍过期缓存
- POLICY_STRICT:严格不使用过期缓存
-
-
说明:
-
POLICY_AGGRESSIVE
- 说明:激进的策略,无条件地使用过期的HTTPDNS缓存
- 优势:最大程度的避免使用DNS解析,减小劫持的风险
- 劣势:HTTPDNS服务异常时,无法降级至DNS,无法感知域名切换
-
POLICY_TOLERANT
-
说明:一定程度的容忍过期缓存的策略,使用过期缓存,直至获取下一次HTTPDNS服务端的请求结果
- 若请求成功,则更新缓存
- 若请求失败,则删除缓存,提供降级机制
- 优势:常态下避免由于HTTPDNS缓存过期导致降级至DNS的问题,同时在HTTPDNS服务故障时提供降级至DNS的机制
- POLICY_TOLERANT是默认的过期缓存处理策略
-
-
POLICY_STRICT
- 说明:保守的策略,严格不使用过期的HTTPDNS缓存
- 优势:严格实现ttl语义
- 劣势:在app长时间idle后,恢复前台时会有较大概率查到缓存过期,此时若不使用HTTPDNS结果,降级至DNS,存在域名劫持等风险
-
2.6 设置网络切换处理策略
- 接口形式:void setNetworkSwitchPolicy (boolean clearCache , boolean httpDnsPrefetch);
-
参数
- boolean clearCache :网络切换后是否清除HTTPDNS及DNS cache,默认为True。
- boolean httpDnsPrefetch:网络切换后是否对缓存中所有域名进行HTTPDNS预取,默认为True
-
说明:
- 网络切换时,若继续使用cache中的解析结果,则可能造成跨网访问的问题,因此默认的网络切换处理策略是清除HTTPDNS cache中的全部内容
- 网络切换时,尽快获取新的HTTPDNS解析结果能减少使用跨网解析结果的风险,但刷新请求会消耗一定的流量,默认策略是刷新HTTPDNS cache中全部域名的解析结果
2.7 设置HTTPDNS网络请求使用的协议
- 接口形式:void setHttpsRequestEnable(boolean isHttps);
-
参数:boolean isHttps
- True:使用https,默认为True
- False:使用http
2.8 设置debug log开关
- 接口形式:void setLogEnable(boolean debug);
-
参数:boolean debug
- 默认为False