DnsOptions.StaleDnsOptions.Builder

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

Określa, czy mają być zwracane wyniki pochodzące z innych sieci. Zwykle Cronet całkowicie czyści pamięć podręczną DNS podczas przełączania połączeń, np. między dwiema sieciami Wi-Fi lub z Wi-Fi na 4G.

fun build(): DnsOptions.StaleDnsOptions!

Tworzy i zwraca ostateczną instancję StaleDnsOptions na podstawie wartości w tym kreatorze.

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

To samo co setFreshLookupTimeoutMillis, ale z użyciem java.time.Duration.

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

Określa, jak długo (w milisekundach) należy czekać na odpowiedź na żądanie DNS, zanim zostaną użyte nieaktualne wyniki. Jeśli ustawisz wartość zero, nieaktualne wyniki będą zwracane natychmiast, ale żądanie DNS będzie kontynuowane w tle, aby zaktualizować pamięć podręczną.

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

To samo co setMaxExpiredDelayMillis, ale z użyciem java.time.Duration.

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

Określa, jak długo (w milisekundach) po wygaśnięciu można używać wygasłych wyników. Ustawienie wartości zero oznacza, że wygasłe rekordy mogą być używane bezterminowo.

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

Określa, czy zezwalać na używanie nieaktualnych wyników DNS, gdy resolver sieci nie może rozpoznać nazwy hosta.

W zależności od przypadku użycia, jeśli Cronet szybko wykryje świeżą awarię, może być pożądane użycie awarii, ponieważ jest to technicznie świeższy wynik i szybko go uzyskaliśmy. Można też preferować użycie dowolnego wyniku (nawet nieaktualnego) zamiast awarii.