ProxyOptions

public final class ProxyOptions

Définit une configuration de proxy pouvant être utilisée par CronetEngine.

Résumé

Types imbriqués

Définit le comportement lorsque tous les proxys d'un ProxyOptions ont échoué.

Constantes
static final int

Autorise le trafic direct sans proxy.
static final int

Interdit le trafic direct.

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

Construit une configuration de proxy à partir d'une liste de Proxy.

Constantes

ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT

public static final int ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT = 1

Autorise le trafic direct sans proxy.

Cela définit un comportement d'échec ouvert : si tous les proxys d'un ProxyOptions ont échoué, CronetEngine revient à des connexions sans proxy.

ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT

public static final int ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT = 0

Interdit le trafic direct.

Cela définit un comportement d'échec fermé : si tous les proxys d'un ProxyOptions ont échoué, CronetEngine ne revient pas à des connexions sans proxy.

Méthodes publiques

fromProxyList

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

Construit une configuration de proxy à partir d'une liste de Proxy.

Les proxys de la liste sont utilisés dans l'ordre. Le proxy en position N+1 n'est utilisé que si CronetEngine n'a pas réussi à utiliser le proxy en position N. Si le proxy en position N échoue, pour quelque raison que ce soit (y compris les fermetures de tunnel déclenchées via Proxy.HttpConnectCallback), mais que le proxy en position N+1 réussit, les proxys en position N sont temporairement dépriorisés. Lorsqu'un proxy est dépriorisé, il n'est utilisé qu'en dernier recours.

Paramètres
@NonNull List<Proxy> proxyList

Liste des Proxy qui définissent cette configuration.
@ProxyOptions.AllProxiesFailedBehavior int allProxiesFailedBehavior

Comportement de CronetEngine après avoir échoué à utiliser tous les proxys de proxyList.
Génère
java.lang.IllegalArgumentException

Si la liste de proxys est vide ou si un élément est null.