Added in API level 34
Also in S Extensions 7

Summary: Ctors | Methods | Inherited Methods

DnsOptions.Builder

---

Kotlin |Java

public static final class DnsOptions.Builder
extends Object

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

---

Builder for DnsOptions.

Summary

Public constructors
Builder()

Public methods
DnsOptions	build() Creates and returns the final DnsOptions instance, based on the values in this builder.
DnsOptions.Builder	setPersistHostCache(int state) Sets whether the DNS cache should be persisted to disk.
DnsOptions.Builder	setPersistHostCachePeriod(Duration persistHostCachePeriod) Sets the minimum period between subsequent writes to disk for DNS cache persistence.
DnsOptions.Builder	setPreestablishConnectionsToStaleDnsResults(int state) Sets whether Cronet should use stale cached DNS records to pre-establish connections.
DnsOptions.Builder	setStaleDns(int state) Sets whether to use stale DNS results at all.
DnsOptions.Builder	setStaleDnsOptions(DnsOptions.StaleDnsOptions staleDnsOptions) Sets detailed configuration for stale DNS.
DnsOptions.Builder	setUseHttpStackDnsResolver(int state) Enables the use of the HTTP-stack-specific DNS resolver.

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 constructors

Builder

Added in API level 34
Also in S Extensions 7

public Builder ()

Public methods

build

Added in API level 34
Also in S Extensions 7

public DnsOptions build ()

Creates and returns the final DnsOptions instance, based on the values in this builder.

Returns
DnsOptions	This value cannot be null.

setPersistHostCache

Added in API level 34
Also in S Extensions 7

public DnsOptions.Builder setPersistHostCache (int state)

Sets whether the DNS cache should be persisted to disk.

Only relevant if HttpEngine.Builder#setStoragePath(String) is set.

Parameters
state	int: one of the DNS_OPTION_* values Value is DnsOptions.DNS_OPTION_UNSPECIFIED, DnsOptions.DNS_OPTION_ENABLED, or DnsOptions.DNS_OPTION_DISABLED

Returns
DnsOptions.Builder	the builder for chaining This value cannot be null.

setPersistHostCachePeriod

Added in API level 34
Also in S Extensions 7

public DnsOptions.Builder setPersistHostCachePeriod (Duration persistHostCachePeriod)

Sets the minimum period between subsequent writes to disk for DNS cache persistence.

Only relevant if setPersistHostCache(int) is set to DnsOptions.DNS_OPTION_ENABLED.

Parameters
persistHostCachePeriod	Duration: This value cannot be null.

Returns
DnsOptions.Builder	the builder for chaining This value cannot be null.

setPreestablishConnectionsToStaleDnsResults

Added in API level 34
Also in S Extensions 7

public DnsOptions.Builder setPreestablishConnectionsToStaleDnsResults (int state)

Sets whether Cronet should use stale cached DNS records to pre-establish connections.

If enabled, Cronet will optimistically pre-establish connections to servers that matched the hostname at some point in the past and were cached but the cache entry expired. Such connections won't be used further until a new DNS lookup confirms the cached record was up to date.

To use cached DNS records straight away, use setStaleDns(int) and StaleDnsOptions configuration options.

This option may not be available for all networking protocols.

Parameters
state	int: one of the DNS_OPTION_* values Value is DnsOptions.DNS_OPTION_UNSPECIFIED, DnsOptions.DNS_OPTION_ENABLED, or DnsOptions.DNS_OPTION_DISABLED

Returns
DnsOptions.Builder	the builder for chaining This value cannot be null.

setStaleDns

Added in API level 34
Also in S Extensions 7

public DnsOptions.Builder setStaleDns (int state)

Sets whether to use stale DNS results at all.

Parameters
state	int: one of the DNS_OPTION_* values Value is DnsOptions.DNS_OPTION_UNSPECIFIED, DnsOptions.DNS_OPTION_ENABLED, or DnsOptions.DNS_OPTION_DISABLED

Returns
DnsOptions.Builder	the builder for chaining This value cannot be null.

setStaleDnsOptions

Added in API level 34
Also in S Extensions 7

public DnsOptions.Builder setStaleDnsOptions (DnsOptions.StaleDnsOptions staleDnsOptions)

Sets detailed configuration for stale DNS. Only relevant if setStaleDns(int) is set.

Parameters
staleDnsOptions	DnsOptions.StaleDnsOptions: This value cannot be null.

Returns
DnsOptions.Builder	this builder for chaining. This value cannot be null.

setUseHttpStackDnsResolver

Added in API level 34
Also in S Extensions 7

public DnsOptions.Builder setUseHttpStackDnsResolver (int state)

Enables the use of the HTTP-stack-specific DNS resolver.

Setting this to DnsOptions.DNS_OPTION_ENABLED is necessary for other functionality of DnsOptions to work, unless specified otherwise. See the DnsOptions documentation for more details.

Parameters
state	int: one of the DNS_OPTION_* values Value is DnsOptions.DNS_OPTION_UNSPECIFIED, DnsOptions.DNS_OPTION_ENABLED, or DnsOptions.DNS_OPTION_DISABLED

Returns
DnsOptions.Builder	the builder for chaining This value cannot be null.