ProxyOptions

public final class ProxyOptions


Define una configuración de proxy que puede usar CronetEngine.

Resumen

Tipos anidados

Define el comportamiento después de que fallan todos los proxies en un ProxyOptions.

Constantes

static final int

Permite el tráfico directo y no proxy.

static final int

No permite el tráfico directo.

Métodos públicos

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

Crea una configuración de proxy a partir de una lista de Proxy.

Constantes

ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT

public static final int ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT = 1

Permite el tráfico directo y no proxy.

Esto define un comportamiento de apertura ante fallas: si fallan todos los proxies en un ProxyOptions, CronetEngine recurrirá a conexiones no proxy.

ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT

public static final int ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT = 0

No permite el tráfico directo.

Esto define un comportamiento de cierre ante fallas: si fallan todos los proxies en un ProxyOptions, CronetEngine no recurrirá a conexiones no proxy.

Métodos públicos

fromProxyList

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

Crea una configuración de proxy a partir de una lista de Proxy.

Los proxies de la lista se usarán en orden. El proxy en la posición N+1 se usará solo si CronetEngine no pudo usar el proxy en la posición N. Si falla el proxy en la posición N, por cualquier motivo (incluidos los cierres de túneles activados a través de Proxy.HttpConnectCallback), pero el proxy en la posición N+1 tiene éxito, los proxies en la posición N se dejarán de priorizar temporalmente. Mientras se deje de priorizar un proxy, se usará solo como último recurso.

Parámetros
@NonNull List<Proxy> proxyList

Es la lista de Proxy que define esta configuración.

@ProxyOptions.AllProxiesFailedBehavior int allProxiesFailedBehavior

Es la forma en que CronetEngine debe comportarse después de que no pudo usar todos los proxies en proxyList.

Arroja
java.lang.IllegalArgumentException

Si la lista de proxies está vacía o algún elemento es null.