Google 會運用 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)