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