public static final class DnsOptions.StaleDnsOptions.Builder extends Object
用于构建 DnsOptions.StaleDnsOptions 的 Builder。
公共方法摘要
| DnsOptions.StaleDnsOptions.Builder |
allowCrossNetworkUsage(boolean allowCrossNetworkUsage)
设置是否返回来自其他网络的结果。
|
| DnsOptions.StaleDnsOptions |
build()
根据此 builder 中的值创建并返回最终的
DnsOptions.StaleDnsOptions 实例。 |
| DnsOptions.StaleDnsOptions.Builder |
setFreshLookupTimeout(Duration freshLookupTimeout)
与
setFreshLookupTimeoutMillis(long) 相同，但使用 Duration。 |
| DnsOptions.StaleDnsOptions.Builder |
setFreshLookupTimeoutMillis(long freshLookupTimeoutMillis)
设置等待 DNS 请求返回的时长（以毫秒为单位），超过该时长将转而使用陈旧结果。
|
| DnsOptions.StaleDnsOptions.Builder |
setMaxExpiredDelayMillis(long maxExpiredDelayMillis)
设置过期后多长时间（以毫秒为单位）可以考虑使用过期结果。
|
| DnsOptions.StaleDnsOptions.Builder |
setMaxExpiredDelayMillis(Duration maxExpiredDelay)
与
setMaxExpiredDelayMillis(long) 相同，但使用 Duration。 |
| DnsOptions.StaleDnsOptions.Builder |
useStaleOnNameNotResolved(boolean useStaleOnNameNotResolved)
设置当网络解析器无法解析主机名时是否允许使用陈旧的 DNS 结果。
|
继承方法摘要
公共方法
public DnsOptions.StaleDnsOptions.Builder allowCrossNetworkUsage (boolean allowCrossNetworkUsage)
设置是否返回来自其他网络的结果。通常，Cronet 在切换连接时（例如在两个 Wi-Fi 网络之间切换或从 Wi-Fi 切换到 4G）会完全清除 DNS 缓存。
参数
| allowCrossNetworkUsage |
|---|
返回
- 用于链式调用的 builder
public DnsOptions.StaleDnsOptions.Builder setFreshLookupTimeout (Duration freshLookupTimeout)
public DnsOptions.StaleDnsOptions.Builder setFreshLookupTimeoutMillis (long freshLookupTimeoutMillis)
设置等待 DNS 请求返回的时长（以毫秒为单位），超过该时长将转而使用陈旧结果。如果设置为零，则会立即返回陈旧结果，但在后台继续执行 DNS 请求以更新缓存。
参数
| freshLookupTimeoutMillis |
|---|
返回
- 用于链式调用的 builder
public DnsOptions.StaleDnsOptions.Builder setMaxExpiredDelayMillis (long maxExpiredDelayMillis)
设置过期后多长时间（以毫秒为单位）可以考虑使用过期结果。将该值设置为零表示过期记录可以无限期使用。
参数
| maxExpiredDelayMillis |
|---|
返回
- 用于链式调用的 builder
public DnsOptions.StaleDnsOptions.Builder setMaxExpiredDelayMillis (Duration maxExpiredDelay)
public DnsOptions.StaleDnsOptions.Builder useStaleOnNameNotResolved (boolean useStaleOnNameNotResolved)
设置当网络解析器无法解析主机名时是否允许使用陈旧的 DNS 结果。
根据用例，如果 Cronet 很快看到一个全新的失败，则可能倾向于使用该失败，因为从技术上讲它是更新鲜的结果，并且我们很快就得到了这样的新结果；或者，相比于失败，更倾向于使用任何结果（即使是陈旧的）。
参数
| useStaleOnNameNotResolved |
|---|
返回
- 用于链式调用的 builder