HTTPDNS：偏好设置接口

校正App签名时间

进行该操作后，如果有偏差，每次网络请求都会对设备进行时间校正；不进行该操作的话将以设备时间为准。

接口定义

void setAuthCurrentTime(long time);

参数说明

代码示例

// httpdns为初始化获取的服务实例
httpdns.setAuthCurrentTime(System.currentTimeMillis());

是否允许HTTPDNS打印Log

接口定义

public static void enable(boolean enable)

参数说明

代码示例

HttpDnsLog.enable(shouldPrintLog);

设置接收SDK日志的回调类

接口定义

    /**
     * 设置日志接口
     * 不受{@link #printToLogcat} 控制
     *
     * @param logger
     */
    public static void setLogger(ILogger logger) {
        if (logger != null) {
            loggers.add(logger);
        }
    }

    /**
     * 移除日志接口
     *
     * @param logger
     */
    public static void removeLogger(ILogger logger) {
        if (logger != null) {
            loggers.remove(logger);
        }
    }
ILogger接口如下：
public interface ILogger {
    void log(String msg);
}

参数说明

代码示例

// SDK V2.0.0以下版本，httpdns为初始化获取的服务实例
httpdns.setLogger(new ILogger() {
            @Override
            public void log(String s) {
                Log.d("HttpDnsSDK", "resultILogger:" + s);
            }
        });

// SDK V2.0.0及以上版本
HttpDnsLog.setLogger(new ILogger() {
            @Override
            public void log(String s) {
                Log.d("HttpDnsSDK", "resultILogger:" + s);
            }
        });

设置是否使用HTTPS协议解析域名

设置是否通过HTTPS协议解析域名，默认设置为false，即通过HTTP协议解析。

接口定义

void setHTTPSRequestEnabled(boolean enabled);

参数说明

代码示例

// httpdns为初始化获取的服务实例
httpdns.setHTTPSRequestEnabled(true);

是否允许启用持久化缓存

该功能旨在提升首屏加载速度，但持久化缓存会将上一次解析到的结果保存在本地持久层，App重启后，如果启动持久化缓存会优先从持久层加载解析结果。所以存在第一次使用的IP为过期IP（TTL过期，大多数情况下该IP依然可以正常使用）的可能性。如果业务服务器IP变化较频繁，建议谨慎接入该功能，以免对业务造成影响。另外，持久化缓存影响首次启动/网络切换后域名解析结果，后续解析仍会请求HTTPDNS服务器，并更新本地缓存。

接口定义

void setCachedIPEnabled(boolean enable);

参数说明

代码示例

// httpdns为初始化获取的服务实例
httpdns.setCachedIPEnabled(true);

是否允许启用持久化缓存-是否清除本地缓存

该功能旨在提升首屏加载速度，但持久化缓存会将上一次解析到的结果保存在本地持久层，App重启后，如果启动持久化缓存会优先从持久层加载解析结果。所以存在第一次使用的IP为过期IP（TTL过期，大多数情况下该IP依然可以正常使用）的可能性。如果业务服务器IP变化较频繁，建议谨慎接入该功能，以免对业务造成影响。另外，持久化缓存影响首次启动/网络切换后域名解析结果，后续解析仍会请求HTTPDNS服务器，并更新本地缓存。

接口定义

void setCachedIPEnabled(boolean enable, boolean enable2);

参数说明

代码示例

// httpdns为初始化获取的服务实例
httpdns.setCachedIPEnabled(true);

设置是否允许返回TTL过期域名的IP

设置是否允许HTTPDNS返回TTL过期的域名，建议设置为YES（默认为NO）。

接口定义

void setExpiredIPEnabled(boolean enable);

参数说明

代码示例

// httpdns为初始化获取的服务实例
httpdns.setExpiredIPEnabled(true);

网络切换自动刷新

设置网络切换时是否自动刷新所有域名解析结果，如果打开此开关，在网络切换时，会自动刷新所有域名的解析结果，但会产生一些流量消耗。

接口定义

void setPreResolveAfterNetworkChanged(boolean enable);

参数说明

代码示例

// httpdns为初始化获取的服务实例
httpdns.setPreResolveAfterNetworkChanged(true);

设置网络请求超时时间

设置自定义请求超时时间，默认为15s。

接口定义

void setTimeoutInterval(int timeoutInterval);

参数说明

代码示例

// httpdns为初始化获取的服务实例
httpdns.setTimeoutInterval(15 * 1000);

设置region节点

设置region节点，调用后，会按照region更新服务IP。

接口定义

void setRegion(String region);

参数说明

代码示例

// httpdns为初始化获取的服务实例
httpdns.setRegion("hk");

清空指定域名缓存

使用阿里云域名解析服务的用户，调用该接口主动清除本地缓存，可实现秒级域名配置生效。 例如：假设域名xxx.com，解析IP地址为ip1, 当ip1遭受攻击，需要将流量迁移至ip2，实现流程如下：

1. 首先,用户在云解析控制台将域名对应IP修改为ip2，此时在HTTPDNS服务端会立即获取到此变更信息，并清除服务端该域名的ip1缓存。

2. 用户手动调用此接口，清空xxx.com域名的本地缓存。

3. App端清空缓存后的下一次请求，会使得服务端重新请求权威服务器，获取最新解析IP地址ip2，从而使前端解析结果立即生效为ip2。

接口定义

void cleanHostCache(ArrayList<String> hosts);

参数说明