DnsOptions.StaleDnsOptions.Builder

public final class DnsOptions.StaleDnsOptions.Builder


Builder für StaleDnsOptions.

Zusammenfassung

Öffentliche Methoden

DnsOptions.StaleDnsOptions.Builder
allowCrossNetworkUsage(boolean allowCrossNetworkUsage)

Legt fest, ob Ergebnisse aus anderen Netzwerken zurückgegeben werden sollen.

DnsOptions.StaleDnsOptions

Erstellt und gibt die endgültige StaleDnsOptions-Instanz basierend auf den Werten in diesem Builder zurück.

DnsOptions.StaleDnsOptions.Builder

Entspricht setFreshLookupTimeoutMillis, verwendet aber java.time.Duration.

DnsOptions.StaleDnsOptions.Builder
setFreshLookupTimeoutMillis(long freshLookupTimeoutMillis)

Legt fest, wie lange (in Millisekunden) auf die Rückgabe einer DNS-Anfrage gewartet werden soll, bevor stattdessen ein veraltetes Ergebnis verwendet wird.

DnsOptions.StaleDnsOptions.Builder

Entspricht setMaxExpiredDelayMillis, verwendet aber java.time.Duration.

DnsOptions.StaleDnsOptions.Builder
setMaxExpiredDelayMillis(long maxExpiredDelayMillis)

Legt fest, wie lange (in Millisekunden) nach dem Ablaufdatum abgelaufene Ergebnisse verwendet werden können.

DnsOptions.StaleDnsOptions.Builder
useStaleOnNameNotResolved(boolean useStaleOnNameNotResolved)

Legt fest, ob veraltete DNS-Ergebnisse verwendet werden dürfen, wenn der Netzwerk-Resolver den Hostnamen nicht auflösen kann.

Öffentliche Methoden

allowCrossNetworkUsage

public DnsOptions.StaleDnsOptions.Builder allowCrossNetworkUsage(boolean allowCrossNetworkUsage)

Legt fest, ob Ergebnisse aus anderen Netzwerken zurückgegeben werden sollen. Normalerweise löscht Cronet den DNS-Cache vollständig, wenn die Verbindung gewechselt wird, z.B. zwischen zwei WLAN-Netzwerken oder von WLAN zu 4G.

Gibt Folgendes zurück:
DnsOptions.StaleDnsOptions.Builder

Der Builder für die Verkettung

Build

public DnsOptions.StaleDnsOptions build()

Erstellt und gibt die endgültige StaleDnsOptions-Instanz basierend auf den Werten in diesem Builder zurück.

setFreshLookupTimeout

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

Entspricht setFreshLookupTimeoutMillis, verwendet aber java.time.Duration.

Gibt Folgendes zurück:
DnsOptions.StaleDnsOptions.Builder

Der Builder für die Verkettung

setFreshLookupTimeoutMillis

public DnsOptions.StaleDnsOptions.Builder setFreshLookupTimeoutMillis(long freshLookupTimeoutMillis)

Legt fest, wie lange (in Millisekunden) auf die Rückgabe einer DNS-Anfrage gewartet werden soll, bevor stattdessen ein veraltetes Ergebnis verwendet wird. Wenn der Wert auf 0 gesetzt ist, werden veraltete Ergebnisse sofort zurückgegeben, die DNS-Anfrage wird aber im Hintergrund fortgesetzt, um den Cache zu aktualisieren.

Gibt Folgendes zurück:
DnsOptions.StaleDnsOptions.Builder

Der Builder für die Verkettung

setMaxExpiredDelay

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

Entspricht setMaxExpiredDelayMillis, verwendet aber java.time.Duration.

Gibt Folgendes zurück:
DnsOptions.StaleDnsOptions.Builder

Der Builder für die Verkettung

setMaxExpiredDelayMillis

public DnsOptions.StaleDnsOptions.Builder setMaxExpiredDelayMillis(long maxExpiredDelayMillis)

Legt fest, wie lange (in Millisekunden) nach dem Ablaufdatum abgelaufene Ergebnisse verwendet werden können. Wenn der Wert auf 0 gesetzt ist, können abgelaufene Datensätze unbegrenzt verwendet werden.

Gibt Folgendes zurück:
DnsOptions.StaleDnsOptions.Builder

Der Builder für die Verkettung

useStaleOnNameNotResolved

public DnsOptions.StaleDnsOptions.Builder useStaleOnNameNotResolved(boolean useStaleOnNameNotResolved)

Legt fest, ob veraltete DNS-Ergebnisse verwendet werden dürfen, wenn der Netzwerk-Resolver den Hostnamen nicht auflösen kann.

Je nach Anwendungsfall kann es sinnvoll sein, einen Fehler zu verwenden, wenn Cronet schnell einen neuen Fehler feststellt, da dies technisch gesehen das aktuellere Ergebnis ist und wir schnell ein solches Ergebnis erhalten haben. Alternativ kann es auch besser sein, ein beliebiges Ergebnis (auch wenn es veraltet ist) zu verwenden, als einen Fehler zu erhalten.

Gibt Folgendes zurück:
DnsOptions.StaleDnsOptions.Builder

Der Builder für die Verkettung