DnsOptions.StaleDnsOptions.Builder

class DnsOptions.StaleDnsOptions.Builder


StaleDnsOptions のビルダー。

概要

パブリック関数

DnsOptions.StaleDnsOptions.Builder!
allowCrossNetworkUsage(allowCrossNetworkUsage: Boolean)

他のネットワークから発信された結果を返すかどうかを設定します。

DnsOptions.StaleDnsOptions!

このビルダーの値に基づいて、最終的な StaleDnsOptions インスタンスを作成して返します。

DnsOptions.StaleDnsOptions.Builder!

setFreshLookupTimeoutMillis と同じですが、java.time.Duration を使用します。

DnsOptions.StaleDnsOptions.Builder!
setFreshLookupTimeoutMillis(freshLookupTimeoutMillis: Long)

DNS リクエストが戻るまでの待機時間(ミリ秒)を設定します。この時間が経過すると、代わりに古い結果が使用されます。

DnsOptions.StaleDnsOptions.Builder!

setMaxExpiredDelayMillis と同じですが、java.time.Duration を使用します。

DnsOptions.StaleDnsOptions.Builder!
setMaxExpiredDelayMillis(maxExpiredDelayMillis: Long)

期限切れの結果を使用するかどうかを判断する期限切れ後の時間(ミリ秒単位)を設定します。

DnsOptions.StaleDnsOptions.Builder!
useStaleOnNameNotResolved(useStaleOnNameNotResolved: Boolean)

ネットワーク リゾルバがホスト名の解決に失敗した場合に、古い DNS 結果の使用を許可するかどうかを設定します。

パブリック関数

allowCrossNetworkUsage

fun allowCrossNetworkUsage(allowCrossNetworkUsage: Boolean): DnsOptions.StaleDnsOptions.Builder!

他のネットワークから発信された結果を返すかどうかを設定します。通常、Cronet は接続を切り替える(2 つの Wi-Fi ネットワーク間や Wi-Fi から 4G など)際に DNS キャッシュを完全にクリアします。

戻り値
DnsOptions.StaleDnsOptions.Builder!

チェーン用のビルダー

build

fun build(): DnsOptions.StaleDnsOptions!

このビルダーの値に基づいて、最終的な StaleDnsOptions インスタンスを作成して返します。

setFreshLookupTimeout

@RequiresApi(value = VERSION_CODES.O)
fun setFreshLookupTimeout(freshLookupTimeout: Duration): DnsOptions.StaleDnsOptions.Builder!

setFreshLookupTimeoutMillis と同じですが、java.time.Duration を使用します。

戻り値
DnsOptions.StaleDnsOptions.Builder!

チェーン用のビルダー

setFreshLookupTimeoutMillis

fun setFreshLookupTimeoutMillis(freshLookupTimeoutMillis: Long): DnsOptions.StaleDnsOptions.Builder!

DNS リクエストが返されるまでの待機時間(ミリ秒)を設定します。この時間が経過すると、代わりに古い結果が使用されます。ゼロに設定すると、古い結果がすぐに返されますが、バックグラウンドで DNS リクエストが継続され、キャッシュが更新されます。

戻り値
DnsOptions.StaleDnsOptions.Builder!

チェーン用のビルダー

setMaxExpiredDelay

@RequiresApi(value = VERSION_CODES.O)
fun setMaxExpiredDelay(maxExpiredDelay: Duration): DnsOptions.StaleDnsOptions.Builder!

setMaxExpiredDelayMillis と同じですが、java.time.Duration を使用します。

戻り値
DnsOptions.StaleDnsOptions.Builder!

チェーン用のビルダー

setMaxExpiredDelayMillis

fun setMaxExpiredDelayMillis(maxExpiredDelayMillis: Long): DnsOptions.StaleDnsOptions.Builder!

期限切れの結果を使用する期限切れ後の期間(ミリ秒単位)を設定します。値を 0 に設定すると、期限切れのレコードを無期限で使用できます。

戻り値
DnsOptions.StaleDnsOptions.Builder!

チェーン用のビルダー

useStaleOnNameNotResolved

fun useStaleOnNameNotResolved(useStaleOnNameNotResolved: Boolean): DnsOptions.StaleDnsOptions.Builder!

ネットワーク リゾルバがホスト名の解決に失敗した場合に、古い DNS 結果の使用を許可するかどうかを設定します。

ユースケースによっては、Cronet が新しいエラーをすぐに検出した場合、技術的には新しい結果であるため、そのエラーを使用することが望ましいことがあります。また、エラーが発生するよりも、古い結果であっても何らかの結果を使用することが望ましいこともあります。

戻り値
DnsOptions.StaleDnsOptions.Builder!

チェーン用のビルダー