ProxyOptions

class ProxyOptions

定義 CronetEngine 可使用的 Proxy 設定。

摘要

巢狀型別

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

常數
const Int

允許直接流量，不透過 Proxy。
const Int

不允許直接流量。

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

從 Proxy 清單建構 Proxy 設定。

常數

ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT

const val ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT = 1: Int

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

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

ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT

const val ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT = 0: Int

不允許直接流量。

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

公開函式

fromProxyList

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

從 Proxy 清單建構 Proxy 設定。

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

參數
proxyList: (Mutable)List<Proxy!>

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

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

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