2. 设置接口

2.1 获取服务实例

  • 接口形式:+ (instancetype)sharedInstance;

  • 参数:无

  • 返回值:BDHttpDNS单例对象,用于HTTPDNS解析

2.2 设置HTTPDNS的账号ID

  • 接口形式:- (void)setAccountID:(NSString *)accountID;

  • 参数:(NSString *)accountID

2.3 设置secret配置信息

  • 接口形式:- (void)setSecret:(NSString *)secret;

  • 参数:(NSString *) secret

2.4 设置预加载域名

  • 接口形式:- (void)setPreResolveHosts:(NSArray *)hosts;

  • 参数:(NSArray *)hosts

  • 说明:

    • 用于初始化后,对常用域名进行预加载,避免初次请求时缓存不命中

    • 调用该接口后,立刻在后台发起异步解析请求

    • hosts数组长度上限为8

2.5 设置HTTPDNS缓存过期处理策略

  • 接口形式:- (void)setCachePolicy:(BDHttpDnsCachePolicy)policy;

  • 参数:(BDHttpDnsCachePolicy)policy

    • 枚举BDHttpDnsCachePolicy的取值:

      • BDHttpDnsCachePolicyAggressive:激进的使用过期缓存策

      • BDHttpDnsCachePolicyTolerant:一定限度容忍过期缓存

      • BDHttpDnsCachePolicyStrict:严格不使用过期缓存

  • 说明:

    • Aggressive

      • 说明:激进的策略,无条件地使用过期的HTTPDNS缓存

      • 优势:最大程度的避免使用DNS解析,减小劫持的风险

      • 劣势:HTTPDNS服务异常时,无法降级至DNS,无法感知域名切换

    • Tolerant

      • 说明:一定程度的容忍过期缓存的策略,使用过期缓存,直至获取下一次HTTPDNS服务端的请求结果

        • 若请求成功,则更新缓存

        • 若请求失败,则删除缓存,提供降级机制

      • 优势:常态下避免由于HTTPDNS缓存过期导致降级至DNS的问题,同时在HTTPDNS服务故障时提供降级至DNS的机制

      • Tolerant是默认的过期缓存处理策略

    • Strict

      • 说明:保守的策略,严格不使用过期的HTTPDNS缓存

      • 优势:严格实现ttl语义

      • 劣势:在app长时间idle后,恢复前台时会有较大概率查到缓存过期,此时若不使用HTTPDNS结果,降级至DNS,存在域名劫持等风险

2.6 设置网络切换处理策略

  • 接口形式:- (void)setNetworkSwitchPolicyClearCache:(BOOL)isClear httpDnsPrefetch:(BOOL) isPrefetch;

  • 参数

    • (BOOL)isClear:网络切换后是否清除HTTPDNS及DNS cache,默认为True

    • (BOOL)isPrefetch:网络切换后是否对缓存中所有域名进行HTTPDNS预取,默认为True

  • 说明:

    • 网络切换时,若继续使用cache中的解析结果,则可能造成跨网访问的问题,因此默认的网络切换处理策略是清除HTTPDNS cache中的全部内容

    • 网络切换时,尽快获取新的HTTPDNS解析结果能减少使用跨网解析结果的风险,但刷新请求会消耗一定的流量,默认策略是刷新HTTPDNS cache中全部域名的解析结果

2.7 设置HTTPDNS网络请求使用的协议

  • 接口形式:- (void)setHttpsRequestEnable:(BOOL)enable;

  • 参数:(BOOL)enable

    • True:使用https,默认为True

    • False:使用http

2.8 设置debug log开关

  • 接口形式:- (void)setDebugLogEnable:(BOOL)enable;

  • 参数:(BOOL)enable

    • 默认为False