ProxyOptions

public final class ProxyOptions

定義 CronetEngine 可使用的 Proxy 設定。

摘要

巢狀型別

定義 ProxyOptions 中所有 Proxy 失敗後的行為。

常數
static final int

允許直接流量，不透過 Proxy。
static final int

不允許直接流量。

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

從 Proxy 清單建構 Proxy 設定。

常數

ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT

public static final int ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT = 1

允許直接流量 (不透過 Proxy)。

這會定義失敗開放行為：如果 ProxyOptions 中的所有 Proxy 都失敗，CronetEngine 會改用非 Proxy 連線。

ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT

public static final int ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT = 0

不允許直接流量。

這會定義失敗關閉行為：如果 ProxyOptions 中的所有 Proxy 都失敗，CronetEngine 不會回退到非 Proxy 連線。

公用方法

fromProxyList

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

從 Proxy 清單建構 Proxy 設定。

系統會依序使用清單中的 Proxy。只有在 CronetEngine 無法使用位置 N 的 Proxy 時，才會使用位置 N+1 的 Proxy。如果位置 N 的 Proxy 因任何原因 (包括透過 Proxy.HttpConnectCallback 觸發的通道關閉) 失敗，但位置 N+1 的 Proxy 成功，位置 N 的 Proxy 會暫時降低優先順序。Proxy 遭到降級後，只有在不得已的情況下才會使用。

參數
@NonNull List<Proxy> proxyList

定義這項設定的 Proxy 清單。
@ProxyOptions.AllProxiesFailedBehavior int allProxiesFailedBehavior

CronetEngine 在無法使用 proxyList 中的所有 Proxy 後，應如何運作。
擲回
java.lang.IllegalArgumentException

如果 Proxy 清單空白，或任何元素為 null。