ProxyOptions

public final class ProxyOptions


Define uma configuração de proxy que pode ser usada pelo CronetEngine.

Resumo

Tipos aninhados

Define o comportamento depois que todos os proxies em um ProxyOptions falharem.

Constantes

static final int

Permite tráfego direto e não proxy.

static final int

Não permite tráfego direto.

Métodos públicos

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

Cria uma configuração de proxy com base em uma lista de Proxy.

Constantes

ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT

public static final int ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT = 1

Permite tráfego direto e não proxy.

Isso define um comportamento de falha aberta: se todos os proxies em um ProxyOptions falharem, o CronetEngine vai voltar para conexões não proxy.

ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT

public static final int ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT = 0

Não permite tráfego direto.

Isso define um comportamento de falha fechada: se todos os proxies em um ProxyOptions falharem, o CronetEngine não vai voltar para conexões não proxy.

Métodos públicos

fromProxyList

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

Cria uma configuração de proxy com base em uma lista de Proxy.

Os proxies na lista serão usados em ordem. O proxy na posição N+1 será usado apenas se o CronetEngine não conseguir usar o proxy na posição N. Se o proxy na posição N falhar, por qualquer motivo (incluindo fechamentos de túnel acionados por Proxy.HttpConnectCallback), mas o proxy na posição N+1 for bem-sucedido, os proxies na posição N serão temporariamente despriorizados. Enquanto um proxy é despriorizado, ele é usado apenas como último recurso.

Parâmetros
@NonNull List<Proxy> proxyList

A lista de Proxy que define essa configuração.

@ProxyOptions.AllProxiesFailedBehavior int allProxiesFailedBehavior

Como o CronetEngine precisa se comportar depois de não conseguir usar todos os proxies em proxyList.

Gera
java.lang.IllegalArgumentException

Se a lista de proxies estiver vazia ou se algum elemento for null.