DnsOptions.StaleDnsOptions.Builder

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

Define se os resultados originários de outras redes serão retornados ou não. Normalmente, o Cronet limpa todo o cache de DNS ao trocar de conexão, por exemplo, entre duas redes Wi-Fi ou de Wi-Fi para 4G.

fun build(): DnsOptions.StaleDnsOptions!

Cria e retorna a instância final de StaleDnsOptions, com base nos valores desse builder.

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

Igual a setFreshLookupTimeoutMillis, mas usando java.time.Duration.

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

Define quanto tempo (em milissegundos) esperar que uma solicitação de DNS retorne antes de usar um resultado desatualizado. Se definido como zero, retorna resultados desatualizados instantaneamente, mas continua a solicitação de DNS em segundo plano para atualizar o cache.

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

Igual a setMaxExpiredDelayMillis, mas usando java.time.Duration.

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

Define quanto tempo (em milissegundos) após a expiração considerar o uso de resultados expirados. Definir o valor como zero significa que os registros expirados podem ser usados indefinidamente.

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

Define se o uso de resultados de DNS desatualizados será permitido quando o resolvedor de rede não conseguir resolver o nome do host.

Dependendo do caso de uso, se o Cronet detectar rapidamente uma nova falha, talvez seja desejável usar a falha, já que ela é tecnicamente o resultado mais recente e tivemos um resultado novo rapidamente. Ou, prefira ter qualquer resultado (mesmo que desatualizado) a ter uma falha.