DnsOptions.StaleDnsOptions.Builder

public DnsOptions.StaleDnsOptions.Builder allowCrossNetworkUsage(boolean allowCrossNetworkUsage)

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

public DnsOptions.StaleDnsOptions build()

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

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

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

public DnsOptions.StaleDnsOptions.Builder setFreshLookupTimeoutMillis(long freshLookupTimeoutMillis)

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

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

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

public DnsOptions.StaleDnsOptions.Builder setMaxExpiredDelayMillis(long maxExpiredDelayMillis)

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

public DnsOptions.StaleDnsOptions.Builder useStaleOnNameNotResolved(boolean useStaleOnNameNotResolved)

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

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