ProxyOptions

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
const Int

Autorise le trafic direct non proxy.
const Int

Interdit le trafic direct.

Fonctions publiques
java-static ProxyOptions
fromProxyList(
    proxyList: (Mutable)List<Proxy!>,
    @ProxyOptions.AllProxiesFailedBehavior allProxiesFailedBehavior: Int
)

Crée une configuration de proxy à partir d'une liste de Proxy.

Constantes

ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT

const val ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT = 1: Int

Autorise le trafic direct non proxy.

Cela définit un comportement de type "fail-open" : si tous les proxys d'un ProxyOptions ont échoué, CronetEngine revient à des connexions non proxy.

ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT

const val ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT = 0: Int

Interdit le trafic direct.

Cela définit un comportement de type "fail-closed" : si tous les proxys d'un ProxyOptions ont échoué, CronetEngine ne revient pas à des connexions non proxy.

Fonctions publiques

fromProxyList

java-static fun fromProxyList(
    proxyList: (Mutable)List<Proxy!>,
    @ProxyOptions.AllProxiesFailedBehavior allProxiesFailedBehavior: Int
): ProxyOptions

Crée 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
proxyList: (Mutable)List<Proxy!>

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

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.