com.squareup.okhttp

Interface Dns

public interface Dns

A domain name service that resolves IP addresses for host names. Most applications will use the system DNS service, which is the default. Some applications may provide their own implementation to use a different DNS server, to prefer IPv6 addresses, to prefer IPv4 addresses, or to force a specific known IP address.

Implementations of this interface must be safe for concurrent use.

Field Summary

Fields

Modifier and Type	Field and Description
static Dns	SYSTEM A DNS that uses InetAddress.getAllByName(java.lang.String) to ask the underlying operating system to lookup IP addresses.

Method Summary

Modifier and Type	Method and Description
List<InetAddress>	lookup(String hostname) Returns the IP addresses of hostname, in the order they will be attempted by OkHttp.

Field Detail

SYSTEM

static final Dns SYSTEM

A DNS that uses InetAddress.getAllByName(java.lang.String) to ask the underlying operating system to lookup IP addresses. Most custom Dns implementations should delegate to this instance.

Method Detail

lookup

List<InetAddress> lookup(String hostname)
                  throws UnknownHostException

Returns the IP addresses of hostname, in the order they will be attempted by OkHttp. If a connection to an address fails, OkHttp will retry the connection with the next address until either a connection is made, the set of IP addresses is exhausted, or a limit is exceeded.

Throws:

UnknownHostException