DnsOptions.StaleDnsOptions.Builder

public final class DnsOptions.StaleDnsOptions.Builder


StaleDnsOptions 的建構工具。

摘要

公用方法

DnsOptions.StaleDnsOptions.Builder
allowCrossNetworkUsage(boolean allowCrossNetworkUsage)

設定是否要傳回來自其他網路的結果。

DnsOptions.StaleDnsOptions

根據這個建構工具中的值,建立並傳回最終的 StaleDnsOptions 例項。

DnsOptions.StaleDnsOptions.Builder

setFreshLookupTimeoutMillis 相同,但使用 java.time.Duration

DnsOptions.StaleDnsOptions.Builder
setFreshLookupTimeoutMillis(long freshLookupTimeoutMillis)

設定 DNS 要求的回傳等待時間 (以毫秒為單位),如果超過這個時間,則改用過時結果。

DnsOptions.StaleDnsOptions.Builder

setMaxExpiredDelayMillis 相同,但使用 java.time.Duration

DnsOptions.StaleDnsOptions.Builder
setMaxExpiredDelayMillis(long maxExpiredDelayMillis)

設定過期結果的可用時間 (以毫秒為單位)。

DnsOptions.StaleDnsOptions.Builder
useStaleOnNameNotResolved(boolean useStaleOnNameNotResolved)

設定網路解析器無法解析主機名稱時,是否允許使用過時的 DNS 結果。

公用方法

allowCrossNetworkUsage

public DnsOptions.StaleDnsOptions.Builder allowCrossNetworkUsage(boolean allowCrossNetworkUsage)

設定是否要傳回來自其他網路的結果。一般來說,Cronet 會在切換連線時完全清除 DNS 快取,例如在兩個 Wi-Fi 網路之間切換,或是從 Wi-Fi 切換到 4G。

傳回
DnsOptions.StaleDnsOptions.Builder

用於鏈結的建構工具

build

public DnsOptions.StaleDnsOptions build()

根據這個建構工具中的值,建立並傳回最終的 StaleDnsOptions 例項。

setFreshLookupTimeout

@RequiresApi(value = VERSION_CODES.O)
public DnsOptions.StaleDnsOptions.Builder setFreshLookupTimeout(@NonNull Duration freshLookupTimeout)

setFreshLookupTimeoutMillis 相同,但使用 java.time.Duration

傳回
DnsOptions.StaleDnsOptions.Builder

用於鏈結的建構工具

setFreshLookupTimeoutMillis

public DnsOptions.StaleDnsOptions.Builder setFreshLookupTimeoutMillis(long freshLookupTimeoutMillis)

設定 DNS 要求的回傳等待時間 (以毫秒為單位),如果超過這個時間,則改用過時結果。如果設為零,系統會立即傳回過時的結果,但會在背景繼續執行 DNS 要求,以更新快取。

傳回
DnsOptions.StaleDnsOptions.Builder

用於鏈結的建構工具

setMaxExpiredDelay

@RequiresApi(value = VERSION_CODES.O)
public DnsOptions.StaleDnsOptions.Builder setMaxExpiredDelay(@NonNull Duration maxExpiredDelay)

setMaxExpiredDelayMillis 相同,但使用 java.time.Duration

傳回
DnsOptions.StaleDnsOptions.Builder

用於鏈結的建構工具

setMaxExpiredDelayMillis

public DnsOptions.StaleDnsOptions.Builder setMaxExpiredDelayMillis(long maxExpiredDelayMillis)

設定過期結果的可用時間 (以毫秒為單位)。如果將值設為零,過期記錄就能無限期使用。

傳回
DnsOptions.StaleDnsOptions.Builder

用於鏈結的建構工具

useStaleOnNameNotResolved

public DnsOptions.StaleDnsOptions.Builder useStaleOnNameNotResolved(boolean useStaleOnNameNotResolved)

設定網路解析器無法解析主機名稱時,是否允許使用過時的 DNS 結果。

視用途而定,如果 Cronet 快速發現新的失敗,或許會想使用該失敗,因為這在技術上是最新結果,而且我們很快就取得這類最新結果;或者,寧願使用任何結果 (即使是過時結果),也不要失敗。

傳回
DnsOptions.StaleDnsOptions.Builder

用於鏈結的建構工具