ProxyOptions

public final class ProxyOptions


Menentukan konfigurasi proxy yang dapat digunakan oleh CronetEngine.

Ringkasan

Jenis bertingkat

Menentukan perilaku setelah semua proxy di ProxyOptions gagal.

Konstanta

static final int

Mengizinkan traffic langsung yang tidak di-proxy.

static final int

Tidak mengizinkan traffic langsung.

Metode publik

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

Membuat konfigurasi proxy dari daftar Proxy.

Konstanta

ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT

public static final int ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT = 1

Mengizinkan traffic langsung yang tidak di-proxy.

Hal ini menentukan perilaku fail-open: jika semua proxy di ProxyOptions gagal, CronetEngine akan melakukan penggantian ke koneksi non-proxy.

ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT

public static final int ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT = 0

Tidak mengizinkan traffic langsung.

Hal ini menentukan perilaku gagal-tutup: jika semua proxy dalam ProxyOptions gagal, CronetEngine tidak akan melakukan penggantian ke koneksi non-proxy.

Metode publik

fromProxyList

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

Membuat konfigurasi proxy dari daftar Proxy.

Proxy dalam daftar akan digunakan secara berurutan. Proxy di posisi N+1 hanya akan digunakan jika CronetEngine gagal menggunakan proxy di posisi N. Jika proxy di posisi N gagal karena alasan apa pun (termasuk penutupan tunnel yang dipicu melalui Proxy.HttpConnectCallback), tetapi proxy di posisi N+1 berhasil, proxy di posisi N akan diturunkan prioritasnya untuk sementara. Saat diprioritaskan lebih rendah, proxy hanya akan digunakan sebagai upaya terakhir.

Parameter
@NonNull List<Proxy> proxyList

Daftar Proxy yang menentukan konfigurasi ini.

@ProxyOptions.AllProxiesFailedBehavior int allProxiesFailedBehavior

Cara CronetEngine harus berperilaku setelah gagal menggunakan semua proxy di proxyList.

Menampilkan
java.lang.IllegalArgumentException

Jika daftar proxy kosong, atau ada elemen yang null.