ProxyOptions

public final class ProxyOptions


Definiert eine Proxykonfiguration, die von CronetEngine verwendet werden kann.

Zusammenfassung

Verschachtelte Typen

Definiert das Verhalten, nachdem alle Proxys in einer ProxyOptions fehlgeschlagen sind.

Konstanten

static final int

Ermöglicht direkten Traffic ohne Proxy.

static final int

Ermöglicht keinen direkten Traffic.

Öffentliche Methoden

static @NonNull ProxyOptions
fromProxyList(
    @NonNull List<Proxy> proxyList,
    @ProxyOptions.AllProxiesFailedBehavior int allProxiesFailedBehavior
)

Erstellt eine Proxykonfiguration aus einer Liste von Proxy.

Konstanten

ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT

public static final int ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT = 1

Ermöglicht direkten Traffic ohne Proxy.

Dies definiert ein Fail-Open-Verhalten: Wenn alle Proxys in einer ProxyOptions fehlgeschlagen sind, greift CronetEngine auf Verbindungen ohne Proxy zurück.

ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT

public static final int ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT = 0

Ermöglicht keinen direkten Traffic.

Dies definiert ein Fail-Closed-Verhalten: Wenn alle Proxys in einer ProxyOptions fehlgeschlagen sind, greift CronetEngine nicht auf Verbindungen ohne Proxy zurück.

Öffentliche Methoden

fromProxyList

public static @NonNull ProxyOptions fromProxyList(
    @NonNull List<Proxy> proxyList,
    @ProxyOptions.AllProxiesFailedBehavior int allProxiesFailedBehavior
)

Erstellt eine Proxykonfiguration aus einer Liste von Proxy.

Die Proxys in der Liste werden in der angegebenen Reihenfolge verwendet. Der Proxy an Position N+1 wird nur verwendet, wenn CronetEngine den Proxy an Position N nicht verwenden konnte. Wenn der Proxy an Position N aus irgendeinem Grund fehlschlägt (einschließlich Tunnel-Schließungen, die über Proxy.HttpConnectCallback ausgelöst werden), aber der Proxy an Position N+1 erfolgreich ist, werden die Proxys an Position N vorübergehend herabgestuft. Wenn ein Proxy herabgestuft wird, wird er nur als letztes Mittel verwendet.

Parameter
@NonNull List<Proxy> proxyList

Die Liste der Proxy, die diese Konfiguration definiert.

@ProxyOptions.AllProxiesFailedBehavior int allProxiesFailedBehavior

Das Verhalten von CronetEngine, nachdem alle Proxys in proxyList nicht verwendet werden konnten.

Löst aus
java.lang.IllegalArgumentException

Wenn die Proxyliste leer ist oder ein Element null ist.