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 列表构建代理配置。

列表中的代理将按顺序使用。仅当 CronetEngine 无法使用位置 N 中的代理时，才会使用位置 N+1 中的代理。如果位置 N 中的代理因任何原因（包括通过 Proxy.HttpConnectCallback 触发的隧道关闭）而失败，但位置 N+1 中的代理成功，则位置 N 中的代理将被暂时降级。在代理被降级期间，它将仅作为最后的手段使用。

参数
proxyList: (Mutable)List<Proxy!>

定义此配置的 Proxy 列表。
@ProxyOptions.AllProxiesFailedBehavior allProxiesFailedBehavior: Int

CronetEngine 在无法使用 proxyList 中的所有代理后必须采取的行为。
抛出
java.lang.IllegalArgumentException

如果代理列表为空，或者任何元素为 null。