DnsOptions.Builder

public static final class DnsOptions.Builder extends Object

DnsOptions 的构建器。

公共方法摘要

DnsOptions
build()
根据此构建器中的值,创建并返回最终的 DnsOptions 实例。
DnsOptions.Builder
enableStaleDns(boolean enable)
设置是否使用过时 DNS 结果。
DnsOptions.Builder
persistHostCache(boolean persistHostCache)
设置 DNS 缓存是否应持久化到磁盘。
DnsOptions.Builder
preestablishConnectionsToStaleDnsResults(boolean enable)
设置 Cronet 是否应使用过时缓存的 DNS 记录来预建连接。
DnsOptions.Builder
setPersistDelay(Duration persistToDiskPeriod)
DnsOptions.Builder
setPersistHostCachePeriodMillis(long persistHostCachePeriodMillis)
设置 DNS 缓存持久化后续写入磁盘之间的最小周期。
DnsOptions.Builder
DnsOptions.Builder
setStaleDnsOptions(DnsOptions.StaleDnsOptions staleDnsOptions)
设置过时 DNS 的详细配置。
DnsOptions.Builder
useBuiltInDnsResolver(boolean enable)

继承的方法摘要

公共方法

public DnsOptions build ()

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

public DnsOptions.Builder enableStaleDns (boolean enable)

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

参数
enable
返回
  • 用于链式调用的构建器

public DnsOptions.Builder persistHostCache (boolean persistHostCache)

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

仅当设置了 CronetEngine.Builder.setStoragePath(String) 时才相关。

参数
persistHostCache
返回
  • 用于链式调用的构建器

public DnsOptions.Builder preestablishConnectionsToStaleDnsResults (boolean enable)

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

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

要立即使用缓存的 DNS 记录,请使用 enableStaleDns(boolean)DnsOptions.StaleDnsOptions 配置选项。

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

参数
enable
返回
  • 用于链式调用的构建器

public DnsOptions.Builder setPersistDelay (Duration persistToDiskPeriod)

参数
persistToDiskPeriod
返回
  • 用于链式调用的构建器

public DnsOptions.Builder setPersistHostCachePeriodMillis (long persistHostCachePeriodMillis)

设置 DNS 缓存持久化后续写入磁盘之间的最小周期。

仅当 persistHostCache(boolean) 设置为 true 时才相关。

参数
persistHostCachePeriodMillis
返回
  • 用于链式调用的构建器

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

参数
staleDnsOptionsBuilder

public DnsOptions.Builder setStaleDnsOptions (DnsOptions.StaleDnsOptions staleDnsOptions)

设置过时 DNS 的详细配置。仅当设置了 enableStaleDns(boolean) 时才相关。

参数
staleDnsOptions
返回
  • 此构建器用于链式调用。

public DnsOptions.Builder useBuiltInDnsResolver (boolean enable)

参数
enable