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

用於鏈結的建構工具