DnsOptions.StaleDnsOptions.Builder

public final class DnsOptions.StaleDnsOptions.Builder


Compilateur pour StaleDnsOptions.

Résumé

Méthodes publiques

DnsOptions.StaleDnsOptions.Builder
allowCrossNetworkUsage(boolean allowCrossNetworkUsage)

Indique s'il faut renvoyer ou non les résultats provenant d'autres réseaux.

DnsOptions.StaleDnsOptions

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

DnsOptions.StaleDnsOptions.Builder

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

DnsOptions.StaleDnsOptions.Builder
setFreshLookupTimeoutMillis(long freshLookupTimeoutMillis)

Définit le délai d'attente (en millisecondes) d'une requête DNS avant d'utiliser un résultat obsolète.

DnsOptions.StaleDnsOptions.Builder

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

DnsOptions.StaleDnsOptions.Builder
setMaxExpiredDelayMillis(long maxExpiredDelayMillis)

Définit le délai (en millisecondes) après l'expiration pendant lequel les résultats expirés peuvent être utilisés.

DnsOptions.StaleDnsOptions.Builder
useStaleOnNameNotResolved(boolean useStaleOnNameNotResolved)

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.

Méthodes publiques

allowCrossNetworkUsage

public DnsOptions.StaleDnsOptions.Builder allowCrossNetworkUsage(boolean allowCrossNetworkUsage)

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.

Renvoie
DnsOptions.StaleDnsOptions.Builder

le compilateur pour le chaînage

build

public DnsOptions.StaleDnsOptions build()

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

setFreshLookupTimeout

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

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

Renvoie
DnsOptions.StaleDnsOptions.Builder

le compilateur pour le chaînage

setFreshLookupTimeoutMillis

public DnsOptions.StaleDnsOptions.Builder setFreshLookupTimeoutMillis(long freshLookupTimeoutMillis)

Définit le délai d'attente (en millisecondes) d'une requête DNS avant d'utiliser 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.

Renvoie
DnsOptions.StaleDnsOptions.Builder

le compilateur pour le chaînage

setMaxExpiredDelay

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

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

Renvoie
DnsOptions.StaleDnsOptions.Builder

le compilateur pour le chaînage

setMaxExpiredDelayMillis

public DnsOptions.StaleDnsOptions.Builder setMaxExpiredDelayMillis(long maxExpiredDelayMillis)

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

Renvoie
DnsOptions.StaleDnsOptions.Builder

le compilateur pour le chaînage

useStaleOnNameNotResolved

public DnsOptions.StaleDnsOptions.Builder useStaleOnNameNotResolved(boolean useStaleOnNameNotResolved)

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 l'avons obtenu 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.

Renvoie
DnsOptions.StaleDnsOptions.Builder

le compilateur pour le chaînage