Summary: Nested Classes | Methods | Inherited Methods

DnsOptions

Kotlin |Java

public final class DnsOptions
extends Object

java.lang.Object
↳	android.net.http.DnsOptions

A class configuring the host resolution functionality. Note that while we refer to DNS as the most common mechanism being used for brevity, settings apply to other means of resolving hostnames like hosts file resolution.

Hostnames can be resolved in two ways - either by using the system resolver (using getaddrinfo provided by system libraries), or by using a custom resolver which is built into the HTTP networking stack.

The built-in stack provides several advantages over using the system resolver:

It has been tailored to the needs of the networking stack, particularly speed and stability.
getaddrinfo is a blocking call which requires dedicating worker threads and makes cancellation impossible (we need to abandon the thread until the call completes)
The getaddrinfo interface gives no insight into the root cause of failures
struct addrinfo provides no TTL (Time To Live) of the returned addresses. This restricts flexibility of handling caching (e.g. allowing the use of stale DNS records) and requires us to either rely on OS DNS caches, or be extremely conservative with the TTL.

Most configuration in this class is only applicable if the built-in DNS resolver is used.

Summary

Nested classes
`class`	`DnsOptions.Builder` Builder for `DnsOptions`.

Public methods
`Boolean`	`getPersistHostCache()` See `Builder#setPersistHostCache`
`Duration`	`getPersistHostCachePeriod()` See `Builder#setPersistHostCachePeriod`

Inherited methods

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeoutMillis, int nanos)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait()` Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Public methods

getPersistHostCache

Added in Android UpsideDownCake

public Boolean getPersistHostCache ()

See Builder#setPersistHostCache

Returns
`Boolean`	This value may be `null`.

getPersistHostCachePeriod

Added in Android UpsideDownCake

public Duration getPersistHostCachePeriod ()

See Builder#setPersistHostCachePeriod

Returns
`Duration`	This value may be `null`.

DnsOptions

Summary

Nested classes

Public methods

Inherited methods

Public methods

getPersistHostCache

getPersistHostCachePeriod