ProxyOptions

class ProxyOptions


CronetEngine で使用できるプロキシ構成を定義します。

概要

ネストされた型

ProxyOptions 内のすべてのプロキシが失敗した後の動作を定義します。

定数

const Int

直接のプロキシなしのトラフィックを許可します。

const Int

ノーリファラーを許可しません。

パブリック関数

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

Proxy のリストからプロキシ構成を作成します。

定数

ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT

const val ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT = 1: Int

直接のプロキシなしのトラフィックを許可します。

これはフェイルオープン動作を定義します。ProxyOptions 内のすべてのプロキシが失敗した場合、CronetEngine はプロキシなしの接続にフォールバックします。

ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT

const val ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT = 0: Int

ノーリファラーを許可しません。

これはフェイルクローズ動作を定義します。ProxyOptions 内のすべてのプロキシが失敗した場合、CronetEngine はプロキシなしの接続にフォールバックしません。

パブリック関数

fromProxyList

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

Proxy のリストからプロキシ構成を作成します。

リスト内のプロキシは順番に使用されます。位置 N+1 のプロキシは、CronetEngine が位置 N のプロキシを使用できなかった場合にのみ使用されます。位置 N のプロキシがなんらかの理由(Proxy.HttpConnectCallback でトリガーされたトンネルのクローズなど)で失敗し、位置 N+1 のプロキシが成功した場合、位置 N のプロキシの優先度が一時的に下がります。プロキシの優先度が下げられている間は、最後の手段としてのみ使用されます。

パラメータ
proxyList: (Mutable)List<Proxy!>

この構成を定義する Proxy のリスト。

@ProxyOptions.AllProxiesFailedBehavior allProxiesFailedBehavior: Int

proxyList 内のすべてのプロキシの使用に失敗した後の CronetEngine の動作。

例外
java.lang.IllegalArgumentException

プロキシ リストが空の場合、または要素が null の場合。