ProxyOptions

public final class ProxyOptions

Definiuje konfigurację serwera proxy, która może być używana przez CronetEngine.

Podsumowanie

Typy zagnieżdżone

Definiuje zachowanie po tym, jak wszystkie serwery proxy w ProxyOptions zawiodły.

Stałe
static final int

Zezwala na ruch bezpośredni, bez serwera proxy.
static final int

Blokuje wizyty bezpośrednie.

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

Tworzy konfigurację serwera proxy na podstawie listy Proxy.

Stałe

ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT

public static final int ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT = 1

Zezwala na ruch bezpośredni, bez serwera proxy.

Definiuje zachowanie w przypadku awarii: jeśli wszystkie serwery proxy w ProxyOptions zawiodły, CronetEngine przełączy się na połączenia bez serwera proxy.

ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT

public static final int ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT = 0

Blokuje wizyty bezpośrednie.

Definiuje zachowanie w przypadku awarii: jeśli wszystkie serwery proxy w ProxyOptions zawiodły, CronetEngine nie przełączy się na połączenia bez serwera proxy.

Metody publiczne

fromProxyList

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

Tworzy konfigurację serwera proxy na podstawie listy Proxy.

Serwery proxy na liście będą używane w podanej kolejności. Serwer proxy na pozycji N+1 będzie używany tylko wtedy, gdy CronetEngine nie będzie mógł użyć serwera proxy na pozycji N. Jeśli serwer proxy na pozycji N zawiedzie z jakiegokolwiek powodu (w tym z powodu zamknięcia tunelu wywołanego przez Proxy.HttpConnectCallback), ale serwer proxy na pozycji N+1 będzie działać, serwery proxy na pozycji N zostaną tymczasowo obniżone. Gdy serwer proxy jest obniżony, będzie używany tylko w ostateczności.

Parametry
@NonNull List<Proxy> proxyList

Lista Proxy, która definiuje tę konfigurację.
@ProxyOptions.AllProxiesFailedBehavior int allProxiesFailedBehavior

Jak ma się zachowywać CronetEngine, gdy nie uda mu się użyć wszystkich serwerów proxy w proxyList.
Zgłasza
java.lang.IllegalArgumentException

Jeśli lista serwerów proxy jest pusta lub którykolwiek element ma wartość null.