# DnsOptions.Builder


```
class DnsOptions.Builder
```

<br />

*** ** * ** ***

Builder for `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions`.

## Summary

| ### Public functions |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions!` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder#build()()` Creates and returns the final `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions` instance, based on the values in this builder. |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder!` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder#enableStaleDns(boolean)(enable: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)` Sets whether to use stale DNS results at all. |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder!` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder#persistHostCache(boolean)(persistHostCache: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)` Sets whether the DNS cache should be persisted to disk. |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder!` | `@https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Experimental https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder#preestablishConnectionsToStaleDnsResults(boolean)(enable: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)` Sets whether Cronet should use stale cached DNS records to pre-establish connections. |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder!` | `@https://developer.android.com/reference/androidx/annotation/RequiresApi.html(api = https://developer.android.com/reference/android/os/VERSION_CODES.html#O) https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder#setPersistDelay(java.time.Duration)(persistToDiskPeriod: https://developer.android.com/reference/java/time/Duration.html)` Same as `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder#setPersistHostCachePeriodMillis(long)` but using `https://developer.android.com/reference/java/time/Duration.html`. |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder!` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder#setPersistHostCachePeriodMillis(long)(persistHostCachePeriodMillis: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)` Sets the minimum period between subsequent writes to disk for DNS cache persistence. |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder!` | `@https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Experimental https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder#setStaleDnsOptions(org.chromium.net.DnsOptions.StaleDnsOptions.Builder)( staleDnsOptionsBuilder: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.StaleDnsOptions.Builder! )` |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder!` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder#setStaleDnsOptions(org.chromium.net.DnsOptions.StaleDnsOptions)(staleDnsOptions: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.StaleDnsOptions!)` Sets detailed configuration for stale DNS. |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder!` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder#useBuiltInDnsResolver(boolean)(enable: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)` |

## Public functions

### build

```
fun build(): DnsOptions!
```

Creates and returns the final `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions` instance, based on the values in this builder.

### enableStaleDns

```
fun enableStaleDns(enable: Boolean): DnsOptions.Builder!
```

Sets whether to use stale DNS results at all.

| Returns |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder!` | the builder for chaining |

### persistHostCache

```
fun persistHostCache(persistHostCache: Boolean): DnsOptions.Builder!
```

Sets whether the DNS cache should be persisted to disk.

Only relevant if `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetEngine.Builder#setStoragePath(java.lang.String)` is set.

| Returns |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder!` | the builder for chaining |

### preestablishConnectionsToStaleDnsResults

```
@DnsOptions.Experimental
fun preestablishConnectionsToStaleDnsResults(enable: Boolean): DnsOptions.Builder!
```

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 `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder#enableStaleDns(boolean)` and `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.StaleDnsOptions` configuration options.

This option may not be available for all networking protocols.

| Returns |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder!` | the builder for chaining |

### setPersistDelay

```
@RequiresApi(api = VERSION_CODES.O)
fun setPersistDelay(persistToDiskPeriod: Duration): DnsOptions.Builder!
```

Same as `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder#setPersistHostCachePeriodMillis(long)` but using `https://developer.android.com/reference/java/time/Duration.html`.

| Returns |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder!` | the builder for chaining |

### setPersistHostCachePeriodMillis

```
fun setPersistHostCachePeriodMillis(persistHostCachePeriodMillis: Long): DnsOptions.Builder!
```

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

Only relevant if `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder#persistHostCache(boolean)` is set to true.

| Returns |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder!` | the builder for chaining |

### setStaleDnsOptions

```
@DnsOptions.Experimental
fun setStaleDnsOptions(
    staleDnsOptionsBuilder: DnsOptions.StaleDnsOptions.Builder!
): DnsOptions.Builder!
```

| See also |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder#setStaleDnsOptions(org.chromium.net.DnsOptions.StaleDnsOptions)` |   |

### setStaleDnsOptions

```
fun setStaleDnsOptions(staleDnsOptions: DnsOptions.StaleDnsOptions!): DnsOptions.Builder!
```

Sets detailed configuration for stale DNS. Only relevant if `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder#enableStaleDns(boolean)` is set.

| Returns |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/DnsOptions.Builder!` | this builder for chaining. |

### useBuiltInDnsResolver

```
fun useBuiltInDnsResolver(enable: Boolean): DnsOptions.Builder!
```