ProxyOptions

public final class ProxyOptions

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

概要

ネストされたタイプ

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

定数
static final int

プロキシを使用しない直接トラフィックを許可します。
static final int

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

パブリック メソッド
static @NonNull ProxyOptions
fromProxyList(
    @NonNull List<Proxy> proxyList,
    @ProxyOptions.AllProxiesFailedBehavior int allProxiesFailedBehavior
)

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

定数

ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT

public static final int ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT = 1

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

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

ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT

public static final int ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT = 0

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

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

パブリック メソッド

fromProxyList

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

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

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

パラメータ
@NonNull List<Proxy> proxyList

この構成を定義する Proxy のリスト。
@ProxyOptions.AllProxiesFailedBehavior int allProxiesFailedBehavior

proxyList 内のすべてのプロキシの使用に失敗した後の CronetEngine の動作。
例外
java.lang.IllegalArgumentException

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