Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

DnsOptions.Builder

class DnsOptions.Builder

DnsOptions 的构建器。

摘要

公共函数
`DnsOptions!`	`build()` 根据此构建器中的值创建并返回最终的 `DnsOptions` 实例。
`DnsOptions.Builder!`	`enableStaleDns(enable: Boolean)` 设置是否使用过时的 DNS 结果。
`DnsOptions.Builder!`	`persistHostCache(persistHostCache: Boolean)` 设置是否应将 DNS 缓存持久保存到磁盘。
`DnsOptions.Builder!`	`@DnsOptions.Experimental preestablishConnectionsToStaleDnsResults(enable: Boolean)` 设置 Cronet 是否应使用过时的缓存 DNS 记录来预先建立连接。
`DnsOptions.Builder!`	`@RequiresApi(api = VERSION_CODES.O) setPersistDelay(persistToDiskPeriod: Duration)` 与 `setPersistHostCachePeriodMillis` 相同，但使用 `java.time.Duration`。
`DnsOptions.Builder!`	`setPersistHostCachePeriodMillis(persistHostCachePeriodMillis: Long)` 设置 DNS 缓存持久性的后续磁盘写入之间的最短时间段。
`DnsOptions.Builder!`	`@DnsOptions.Experimental setStaleDnsOptions( staleDnsOptionsBuilder: DnsOptions.StaleDnsOptions.Builder! )`
`DnsOptions.Builder!`	`setStaleDnsOptions(staleDnsOptions: DnsOptions.StaleDnsOptions!)` 为过时的 DNS 设置详细配置。
`DnsOptions.Builder!`	`useBuiltInDnsResolver(enable: Boolean)`

fun build(): DnsOptions!

根据此构建器中的值创建并返回最终的 DnsOptions 实例。

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

设置是否使用过时的 DNS 结果。

返回
`DnsOptions.Builder!`	用于链式调用的构建器

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

设置是否应将 DNS 缓存持久保存到磁盘。

仅在设置了 setStoragePath 的情况下相关。

返回
`DnsOptions.Builder!`	用于链式调用的构建器

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

设置 Cronet 是否应使用过时的缓存 DNS 记录来预先建立连接。

如果启用，Cronet 将乐观地预先建立与服务器的连接，这些服务器在过去某个时间点与主机名匹配并被缓存，但缓存条目已过期。在新的 DNS 查找确认缓存的记录是最新的之前，系统不会再使用此类连接。

如需立即使用缓存的 DNS 记录，请使用 enableStaleDns 和 StaleDnsOptions 配置选项。

此选项可能不适用于所有网络协议。

返回
`DnsOptions.Builder!`	用于链式调用的构建器

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

返回
`DnsOptions.Builder!`	用于链式调用的构建器

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

设置 DNS 缓存持久性的后续磁盘写入之间的最短时间段。

仅当 persistHostCache 设置为 true 时，此字段才相关。

返回
`DnsOptions.Builder!`	用于链式调用的构建器

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

另请参阅
`setStaleDnsOptions`

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

为过时的 DNS 设置详细配置。仅在设置了 enableStaleDns 的情况下相关。

返回
`DnsOptions.Builder!`	此构建器，用于链式调用。

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