HTTPDNS:Domain Name Resolution Interface

Introduction

The HTTPDNS SDK offers a suite of domain name resolution interfaces and related features, including the following:

• Domain name blacklist. For more information, see set HTTPDNS domain name blacklist.

• Custom TTL. For more information, see customize resolution result TTL.

• IP optimization. For more information, see enable IP optimization.

• Set region nodes. For more information, see set region nodes.

Set pre-resolved domain names

Configure the domain names your app will pre-resolve.

setPreResolveHosts

Interface Definition

void setPreResolveHosts(ArrayList<String> hostList)

void setPreResolveHosts(ArrayList<String> hostList, RequestIpType requestIpType)

Class

HttpDnsService

Parameter Description

Synchronously resolve domain names

• The synchronous resolution interface blocks the current thread until it returns a valid resolution result.

• This interface first checks the cache. If an active resolution result is present, it returns the cached result. Otherwise, it blocks the calling thread, performs domain name resolution on the working thread, and returns the result upon completion or an empty value if a timeout occurs.

• To prevent app stuttering from misuse on the main thread, this interface checks the calling thread. If the main thread is detected, it defaults to the logic of the getHttpDnsResultForHostSyncNonBlocking interface.

getHttpDnsResultForHostSync

Interface Definition

HTTPDNSResult getHttpDnsResultForHostSync(String host, RequestIpType requestIpType)

Class

HttpDnsService

Parameter Definition

Return Description

Code Example

val httpdns = HttpDns.getService(applicationContext, accountID, secretKey)
val httpDnsResult = dnsService?.getHttpDnsResultForHostSync("www.aliyun.com", RequestIpType.auto)

HttpDnsService httpdns = HttpDns.getService(applicationContext, accountID, secretKey);
HTTPDNSResult httpDnsResult = httpdns.getHttpDnsResultForHostSync("www.aliyun.com", RequestIpType.auto);

Asynchronously resolve domain names

• The asynchronous resolution interface resolves domain names without blocking the current thread, returning the result via callback.

• It first checks the cache and returns any active result via callback. If no active result is available, it performs resolution on the working thread and returns the result via callback upon completion or when a timeout is reached.

getHttpDnsResultForHostAsync

Interface Definition

void getHttpDnsResultForHostAsync(String host, RequestIpType type, HttpDnsCallback callback)

Class

HttpDnsService

Parameter Description

Code Example

val httpdns = HttpDns.getService(applicationContext, accountID, secretKey)
val httpDnsResult = dnsService?.getHttpDnsResultForHostAsync("www.aliyun.com", RequestIpType.auto, HttpDnsCallback {
                        httpDnsResult = it
                    })

HttpDnsService httpdns = HttpDns.getService(applicationContext, accountID, secretKey);
HTTPDNSResult httpDnsResult = httpdns.getHttpDnsResultForHostAsync("www.aliyun.com", RequestIpType.auto, new HttpDnsCallback() {
                                void onHttpDnsCompleted(HTTPDNSResult result) {
                                }      
                              });

Synchronously non-blocking resolve domain names

• The synchronous non-blocking interface resolves domain names without blocking the current thread but may return an empty result.

• This interface only queries the cache and returns the result. If no result is available or it has expired, it performs resolution on the working thread and updates the cache for subsequent calls.

getHttpDnsResultForHostSyncNonBlocking

Interface Definition

HTTPDNSResult getHttpDnsResultForHostSyncNonBlocking(String host, RequestIpType type)

Class

HttpDnsService

Parameter Description

Return Description

Code Example

val httpdns = HttpDns.getService(applicationContext, accountID, secretKey)
val httpDnsResult = dnsService?.getHttpDnsResultForHostSyncNonBlocking("www.aliyun.com", RequestIpType.auto)

HttpDnsService httpdns = HttpDns.getService(applicationContext, accountID, secretKey);
HTTPDNSResult httpDnsResult = httpdns.getHttpDnsResultForHostSyncNonBlocking("www.aliyun.com", RequestIpType.auto);

getIpByHostAsync

Resolve domain names synchronously without blocking, returning a single IPv4 address.

Interface Definition

String getIpByHostAsync(String host)

Class

HttpDnsService

Parameter Description

Return Description

getIPv4ForHostAsync

Resolve domain names synchronously without blocking, returning a single IPv4 address.

Interface Definition

String getIPv4ForHostAsync(String host)

Class

HttpDnsService

Parameter Description

Return Description

getIpsByHostAsync

Resolve domain names synchronously without blocking, and return all IPv4 addresses.

Interface Definition

String[] getIpsByHostAsync(String host) asynchronously retrieves an array of IP addresses associated with a given hostname.

Class

HttpDnsService is a feature designed to optimize DNS resolution.

Parameter Description

Return Description

getIPv4ListForHostAsync

Resolve domain names synchronously without blocking, returning all IPv4 addresses.

Interface Definition

String[] getIPv4ListForHostAsync(String host)

Class

HttpDnsService

Parameter Description

Return Description

getIPv6ByHostAsync

Resolve domain names synchronously without blocking, returning a single IPv6 address.

Interface Definition

String getIPv6ByHostAsync(String host)

Class

HttpDnsService

Parameter Description

Return Description

getIPv6ForHostAsync

Resolve domain names synchronously without blocking, returning a single IPv6 address.

Interface Definition

String getIPv6ForHostAsync(String host)

Class

HttpDnsService

Parameter Description

Return Description

getIPv6sByHostAsync

Resolve domain names synchronously without blocking, and retrieve all associated IPv6 addresses.

Interface Definition

String[] getIPv6sByHostAsync(String host)

Class

HttpDnsService

Parameter Description

Return Description

getIPv6ListForHostASync

Resolve domain names synchronously without blocking, and return all IPv6 addresses.

Interface Definition

String[] getIPv6ListForHostASync(String host)

Class

HttpDnsService

Parameter Description

Return Description

getAllByHostAsync

Resolve domain names synchronously without blocking, returning all IPv4 and IPv6 addresses.

Interface Definition

HTTPDNSResult getAllByHostAsync(String host) retrieves all available DNS information for the specified host asynchronously.

Class

HttpDnsService

Parameter Description

Return Description

getHttpDnsResultForHostAsync

Resolve domain names synchronously without blocking, returning all IPv4 and IPv6 addresses.

Interface Definition

HTTPDNSResult getHttpDnsResultForHostAsync(String host) retrieves the asynchronous DNS resolution result for a specified host.

Class

HttpDnsService

Parameter Description

Return Description

getIpsByHostAsync

Resolve domain names synchronously without blocking, and return all IP addresses associated with the specified IP type.

Interface Definition

HTTPDNSResult getIpsByHostAsync(String host, RequestIpType requestIpType) retrieves the IP addresses for a host asynchronously, based on the specified IP type.

Class

HttpDnsService

Parameter Description

Return Description

getHttpDnsResultForHostAsync

Resolve domain names synchronously without blocking, and return all IP addresses associated with the specified IP type.

Interface Definition

HTTPDNSResult getHttpDnsResultForHostAsync(String host, RequestIpType type) retrieves asynchronous HTTPDNS results for a specified host and IP request type.

Class

HttpDnsService

Parameter Description

Return Description

Clear the cached DNS records of a domain name

To update cached DNS records swiftly when using Alibaba Cloud Domain Name Resolution Service, you can perform the following steps:

1. Update the domain name's corresponding IP address to ip2 in the HTTPDNS console. The server will recognize the change and clear the cached DNS record containing ip1.

2. Invoke this operation to remove the domain name xxx.com's DNS record from the local cache.

3. After clearing the cache, any new request will prompt the server to query the authoritative server for the latest DNS record with ip2, which is then used for resolution.

cleanHostCache

Interface Definition

void cleanHostCache(ArrayList<String> hosts)

Class

HttpDnsService

Parameter Description