:Operations for advanced configurations

Specify whether to allow HTTPDNS to display logs

You can specify whether to enable HTTPDNS logs. By default, HTTPDNS logs are disabled.

Enable

Operation definition

void enable(boolean enable)

Class

HttpDnsLog

Parameter description

Sample code

HttpDnsLog.enable(shouldPrintLog)

HttpDnsLog.enable(shouldPrintLog);

Setlogenabled

Operation definition

void setLogEnabled(boolean enable)

Class

HttpDnsService

Parameter description

Configure a callback class to receive SDK logs

You can configure a callback class to receive SDK logs.

Setlogger

Adds a callback class for logs.

Operation definition

void setLogger(ILogger logger)

Class

HttpDnsLog

Parameter description

Sample code

HttpDnsLog.setLogger { s ->
    Log.d(
        "HttpDnsSDK",
        "resultILogger:$s"
    )
}

HttpDnsLog.setLogger(new ILogger() {
    @Override
    public void log(String s) {
        Log.d("HttpDnsSDK", "resultILogger:" + s);
    }
});

Setlogger

Adds a callback class for logs.

Operation definition

void setLogger(ILogger logger)

Class

HttpDnsService

Parameter definition

Removelogger

Removes a callback class for logs.

Operation definition

void removeLogger(ILogger logger)

Class

HttpDnsLog

Parameter description

Sample code

HttpDnsLog.removeLogger(logger)

HttpDnsLog.removeLogger(logger);

Calibrate the signature time of an app

After you call this operation, the time on your device is calibrated each time a network request is initiated. If you do not call this operation, the time on the device prevails.

Setauthcurrenttime

Operation definition

void setAuthCurrentTime(long time)

Class

HttpDnsService

Parameter description

Sample code

val httpdns = HttpDns.getService(accountID)
httpdns?.setAuthCurrentTime(System.currentTimeMillis())

HttpDnsService httpdns = HttpDns.getService(accountID);
httpdns.setAuthCurrentTime(System.currentTimeMillis());

Specify a region

If you want to use HTTPDNS on your app in a region outside the Chinese mainland, you can configure a startup service node of the SDK to improve the resolution efficiency. After you configure the node, the SDK uses the node for domain name resolution and the subsequent scheduling node list updates.

Setregion

Specifies the initial region.

Operation definition

InitConfig.Builder setRegion(Region region)

Class

InitConfig.Builder

Parameter description

Setregion

Specifies the initial region.

Operation definition

InitConfig.Builder setRegion(String region)

Class

InitConfig.Builder

Parameter description

Sample code

InitConfig.Builder()
    .setRegion("hk");

new InitConfig.Builder()
    .setRegion("hk");

Setregion

Updates a region.

Operation definition

void setRegion(Region region)

Class

HttpDnsService

Parameter description

Setregion

Updates a region.

Operation definition

void setRegion(String region)

Class

HttpDnsService

Parameter description

Custom TTL for resolution results

By default, each resolution result uses the TTL provided by the server to determine expiration. To modify the TTL of a resolution result, use the following API operation.

Configcachettlchanger

Operation definition

InitConfig.Builder configCacheTtlChanger(CacheTtlChanger changer)

Class

InitConfig.Builder

Parameter definition

Sample code

InitConfig.Builder().configCacheTtlChanger { host, requestIpType, ttl ->
    if (TextUtils.equals(host, "www.aliyun.com")) {
        // Use www.aliyun.com as an example
        ttl * 10
    } else ttl
}

new InitConfig.Builder().configCacheTtlChanger(new CacheTtlChanger() {
    @Override
    public int changeCacheTtl(String host, RequestIpType requestIpType, int ttl) {
        // Use www.aliyun.com as an example
        if (TextUtils.equals(host, "www.aliyun.com")) {
            return ttl * 10;
        }

        return ttl;
    }
});

Configure the HTTPDNS domain name blacklist

If you do not want to resolve specific domain names by using HTTPDNS, filter out the domain names by using this API operation. The filtered domain names return an empty resolution result, and you must use local DNS servers for resolution.

SetNotUseHttpDnsFilter

Operation definition

InitConfig.Builder setNotUseHttpDnsFilter(NotUseHttpDnsFilter filter)

Class

InitConfig.Builder

Parameter description

Sample code

InitConfig.Builder().setNotUseHttpDnsFilter { hostName ->
    TextUtils.equals(
        hostName,
        "www.aliyun.com"
    )
}

new InitConfig.Builder().setNotUseHttpDnsFilter(new NotUseHttpDnsFilter() {
    @Override
    public boolean notUseHttpDns(String hostName) {
        return TextUtils.equals(hostName, "www.aliyun.com");
    }
});

Setdegradationfilter

Operation definition

InitConfig.Builder setDegradationFilter(DegradationFilter filter)

Class

InitConfig.Builder

Parameter description

Enable IP address precedence

You can configure an IP address list for ranking. After you call this operation, if the corresponding domain name is resolved, the SDK performs IP speed testing on the returned IP addresses and dynamically sorts the list to ensure that the first IP address is the optimal one.

SetIPRankingList

Operation definition

InitConfig.Builder setIPRankingList(List<IPRankingBean> ipRankingList)

Class

InitConfig.Builder

Parameter description

Sample code

val list = ArrayList<IPRankingBean>()
list.add(IPRankingBean("www.aliyun.com", 8080))
InitConfig.Builder().setIPRankingList(list)

ArrayList<IPRankingBean> list = new ArrayList<IPRankingBean>();
list.add(new IPRankingBean("www.aliyun.com", 8080));
new InitConfig.Builder().setIPRankingList(list);

SetIPRankingList

Operation definition

void setIPRankingList(List<IPRankingBean> ipRankingList)

Class

HttpDnsService

Parameter description

SetIPProbeList

Operation definition

void setIPProbeList(List<IPRankingBean> ipProbeList)

Class

HttpDnsService

Parameter description

Configure global parameters for custom resolution

This global parameter does not affect the additional parameter settings of the custom resolution operation. Global parameters can be used with the additional parameters.

SetSdnsGlobalParams

Operation definition

InitConfig.Builder setSdnsGlobalParams(Map<String, String> params)

Class

InitConfig.Builder

Parameter description

Sample code

val params: MutableMap<String, String> = HashMap()
params["level"] = "1"
InitConfig.Builder()
    .setSdnsGlobalParams(params)

Map<String, String> params = new HashMap<>();
params.put("level", "1");
new InitConfig.Builder()
        .setSdnsGlobalParams(params);

SetSdnsGlobalParams

Operation definition

void setSdnsGlobalParams(Map<String, String> params)

Class

HttpDnsService

Parameter description

Configure local DNS resolution

If you allow local Domain Name System (DNS) resolution, when HTTPDNS fails to resolve a domain name, the SDK uses local DNS to resolve the domain name and returns the resolution result. By default, local DNS resolution is not allowed.

SetEnableDegradationLocalDns

Operation definition

InitConfig.Builder setEnableDegradationLocalDns(boolean enableDegradation)

Class

InitConfig.Builder

Parameter description