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

DnsOptions.Builder

public final class DnsOptions.Builder

DnsOptions 的构建器。

摘要

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

public DnsOptions build()

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

public DnsOptions.Builder enableStaleDns(boolean enable)

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

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

public DnsOptions.Builder persistHostCache(boolean persistHostCache)

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

仅在设置了 setStoragePath 时相关。

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

@DnsOptions.Experimental
public DnsOptions.Builder preestablishConnectionsToStaleDnsResults(boolean enable)

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

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

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

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

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

@RequiresApi(api = VERSION_CODES.O)
public DnsOptions.Builder setPersistDelay(@NonNull Duration persistToDiskPeriod)

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

public DnsOptions.Builder setPersistHostCachePeriodMillis(long persistHostCachePeriodMillis)

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

仅在 persistHostCache 设置为 true 时相关。

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

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

另请参阅
`setStaleDnsOptions`

public DnsOptions.Builder setStaleDnsOptions(DnsOptions.StaleDnsOptions staleDnsOptions)

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

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

public DnsOptions.Builder useBuiltInDnsResolver(boolean enable)