public static final class

DnsOptions.Builder

extends Object
java.lang.Object
   ↳ org.chromium.net.DnsOptions.Builder

Class Overview

Builder for DnsOptions.

Summary

Public Methods
DnsOptions build()
Creates and returns the final DnsOptions instance, based on the values in this builder.
DnsOptions.Builder enableStaleDns(boolean enable)
Sets whether to use stale DNS results at all.
DnsOptions.Builder persistHostCache(boolean persistHostCache)
Sets whether the DNS cache should be persisted to disk.
DnsOptions.Builder preestablishConnectionsToStaleDnsResults(boolean enable)
Sets whether Cronet should use stale cached DNS records to pre-establish connections.
DnsOptions.Builder setPersistDelay(Duration persistToDiskPeriod)
Same as setPersistHostCachePeriodMillis(long) but using Duration.
DnsOptions.Builder setPersistHostCachePeriodMillis(long persistHostCachePeriodMillis)
Sets the minimum period between subsequent writes to disk for DNS cache persistence.
DnsOptions.Builder setStaleDnsOptions(DnsOptions.StaleDnsOptions.Builder staleDnsOptionsBuilder)
DnsOptions.Builder setStaleDnsOptions(DnsOptions.StaleDnsOptions staleDnsOptions)
Sets detailed configuration for stale DNS.
DnsOptions.Builder useBuiltInDnsResolver(boolean enable)
[Expand]
Inherited Methods
From class java.lang.Object

Public Methods

public DnsOptions build ()

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

Returns
DnsOptions

public DnsOptions.Builder enableStaleDns (boolean enable)

Sets whether to use stale DNS results at all.

Parameters
enable boolean
Returns
DnsOptions.Builder the builder for chaining

public DnsOptions.Builder persistHostCache (boolean persistHostCache)

Sets whether the DNS cache should be persisted to disk.

Only relevant if setStoragePath(String) is set.

Parameters
persistHostCache boolean
Returns
DnsOptions.Builder the builder for chaining

public DnsOptions.Builder preestablishConnectionsToStaleDnsResults (boolean enable)

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 enableStaleDns(boolean) and DnsOptions.StaleDnsOptions configuration options.

This option may not be available for all networking protocols.

Parameters
enable boolean
Returns
DnsOptions.Builder the builder for chaining

public DnsOptions.Builder setPersistDelay (Duration persistToDiskPeriod)

Same as setPersistHostCachePeriodMillis(long) but using Duration.

Parameters
persistToDiskPeriod Duration
Returns
DnsOptions.Builder the builder for chaining

public DnsOptions.Builder setPersistHostCachePeriodMillis (long persistHostCachePeriodMillis)

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

Only relevant if persistHostCache(boolean) is set to true.

Parameters
persistHostCachePeriodMillis long
Returns
DnsOptions.Builder the builder for chaining

public DnsOptions.Builder setStaleDnsOptions (DnsOptions.StaleDnsOptions.Builder staleDnsOptionsBuilder)

Parameters
staleDnsOptionsBuilder DnsOptions.StaleDnsOptions.Builder
Returns
DnsOptions.Builder

public DnsOptions.Builder setStaleDnsOptions (DnsOptions.StaleDnsOptions staleDnsOptions)

Sets detailed configuration for stale DNS. Only relevant if enableStaleDns(boolean) is set.

Parameters
staleDnsOptions DnsOptions.StaleDnsOptions
Returns
DnsOptions.Builder this builder for chaining.

public DnsOptions.Builder useBuiltInDnsResolver (boolean enable)

Parameters
enable boolean
Returns
DnsOptions.Builder