DnsOptions.StaleDnsOptions.Builder

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

Indique s'il faut renvoyer ou non les résultats provenant d'autres réseaux. Normalement, Cronet efface complètement le cache DNS lors du changement de connexion, par exemple entre deux réseaux Wi-Fi ou entre le Wi-Fi et la 4G.

fun build(): DnsOptions.StaleDnsOptions!

Crée et renvoie l'instance StaleDnsOptions finale, en fonction des valeurs de ce compilateur.

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

Identique à setFreshLookupTimeoutMillis, mais utilise java.time.Duration.

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

Définit le délai (en millisecondes) avant qu'une requête DNS ne renvoie un résultat obsolète. Si la valeur est définie sur zéro, les résultats obsolètes sont renvoyés instantanément, mais la requête DNS se poursuit en arrière-plan pour mettre à jour le cache.

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

Identique à setMaxExpiredDelayMillis, mais utilise java.time.Duration.

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

Définit le délai (en millisecondes) après l'expiration avant de considérer l'utilisation de résultats expirés. Si la valeur est définie sur zéro, les enregistrements expirés peuvent être utilisés indéfiniment.

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

Indique s'il faut autoriser l'utilisation de résultats DNS obsolètes lorsque le résolveur réseau ne parvient pas à résoudre le nom d'hôte.

Selon le cas d'utilisation, si Cronet détecte rapidement un nouvel échec, il peut être préférable d'utiliser l'échec tel quel, car il s'agit techniquement du résultat le plus récent et nous avons obtenu un résultat récent rapidement. Il peut également être préférable d'avoir un résultat (même s'il est non actualisé) plutôt qu'un échec.