高阶配置接口

是否允许HTTPDNS打印Log

本地日志调试日志开关，可以开启调试日志排查解析相关问题。上线时建议关闭。

接口定义

- (void)setLogEnabled:(BOOL)enable;

所属类

HttpDnsService

参数说明

设置接收SDK日志的回调类

开启HTTPDNS日志开关后，若希望日志打印到自定义目标处，可以通过此回调配置实现。如希望通过日志文件收集相关解析日志，则可以通过此回调把日志写入相关文件中。

接口定义

- (void)setLogHandler:(id<HttpdnsLoggerProtocol>)logHandler;

所属类

HttpDnsService

参数说明

示例代码

参考如下代码实现日志接收类。

#import "HttpdnsLoggerProtocol.h"

@interface MyLoggerHandler : NSObject <HttpdnsLoggerProtocol>

@end

@implementation MyLoggerHandler

- (void)log:(NSString *)logStr {
    NSLog(@"[myLog] - %@", logStr);
}

@end

启用IP优选

指定域名对应服务的探测端口，设置该接口后，如果解析了相应的域名，则SDK会对解析返回的IP列表进行TCP建连测速，根据测速结果对该IP列表进行动态排序，以保证第一个IP是可用性最好的IP。

接口定义

- (void)setIPRankingDatasource:(NSDictionary<NSString *, NSNumber *> *)IPRankingDatasource;

参数说明

代码示例

 HttpDnsService *httpdns = [[HttpDnsService alloc] initWithAccountID:xxxx secretKey:@"xxxxx"];
 NSDictionary *IPRankingDatasource = @{
                                 @"www.aliyun.com" : @443,
                                 @"www.taobao.com" : @443,
                                 @"www.exmaple.com" : @443
                                 };
 [httpdns setIPRankingDatasource:IPRankingDatasource];

校正App签名时间

进行该操作后，如果有偏差，每次网络请求都会对设备进行时间校正，避免鉴权模式下，请求因为设备时间过期导致鉴权校验不通过。不进行该操作的话将以设备时间为准。

接口定义

- (void)setInternalAuthTimeBaseBySpecifyingCurrentTime:(NSTimeInterval)currentTime;

所属类

HttpDnsService

参数说明

设置region节点

如果APP需要在海外环境使用HTTPDNS，为了提升解析效率，可以主动设置本SDK的启动服务节点。设置节点后，SDK会使用该节点进行域名解析和进行随后的调度节点列表更新。

默认无需设置，即使App在海外环境启动，SDK内部也会自动调度到最近的海外节点，对效率的影响并不明显。

接口定义

- (void)setRegion:(NSString *)region;

所属类

HttpDnsService

自定义解析结果TTL

若需要在APP本地指定某个域名的TTL，覆盖真实的域名配置，则可以通过此代理接口实现。

接口定义

- (int64_t)httpdnsHost:(NSString *)host ipType:(AlicloudHttpDNS_IPType)ipType ttl:(int64_t)ttl;

所属类

HttpdnsTTLDelegate

回调参数说明

代码示例

@interface AppDelegate () <HttpdnsTTLDelegate>

@end

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // 传入对应的accountID
    HttpDnsService *httpdns = [[HttpDnsService alloc] initWithAccountID:xxxx secretKey:@"xxxx"];
    httpdns.ttlDelegate = self;
    return YES;
}

- (int64_t)httpdnsHost:(NSString *)host ipType:(AlicloudHttpDNS_IPType)ipType ttl:(int64_t)ttl {
    if ([host isEqualToString:@"www.aliyun.com"]) {
        // 假设业务考虑www.aliyun.com这个域名的解析记录非常稳定，可以在本地缓存更长时间
        // 则判断host为www.aliyun.com时，将ttl设置为600秒
        return 600;
    }

    // 若无需特殊配置，返回原始ttl
    return ttl;
}

@end

设置允许降级Local Dns解析

此接口用于设置当HTTPDNS远程解析失败时，是否在内部自动降级到本地DNS进行尝试解析。此功能的目的在于提高域名解析的可靠性，即使在HTTPDNS服务不可用的情况下，也能确保应用能够继续运行。默认关闭，不会自动降级。

接口定义

- (void)setDegradeToLocalDNSEnabled:(BOOL)enable;

所属类

HttpDnsService

参数说明