Proxy

public final class Proxy

Mewakili proxy yang dapat digunakan oleh CronetEngine.

Cara permintaan HTTP dikirim melalui proxy bergantung pada berbagai faktor. Misalnya: jenis proxy yang digunakan, versi HTTP yang digunakan, apakah permintaan dikirim ke tujuan dengan skema URI http atau https. Selain itu, apakah tunnel melalui proxy dibuat atau tidak juga bergantung pada faktor-faktor ini.

Ringkasan

Jenis bertingkat
public abstract class Proxy.HttpConnectCallback

Mengontrol tunnel yang dibuat melalui HTTP CONNECT.

Tindakan yang dapat dilakukan sebagai respons terhadap panggilan onResponseReceived.
public abstract class Proxy.HttpConnectCallback.Request implements AutoCloseable

Mewakili permintaan HTTP CONNECT yang dikirim ke server proxy.
@Retention(value = RetentionPolicy.SOURCE)
@IntDef(value = )
public annotation Proxy.Scheme

Skema yang didukung saat menentukan proxy.

Konstanta
static final int

Buat koneksi teks biasa ke proxy itu sendiri.
static final int

Buat koneksi aman ke proxy itu sendiri.

Metode publik
static @NonNull Proxy
createHttpProxy(
    @Proxy.Scheme int scheme,
    @NonNull String host,
    @IntRange(from = 0, to = 65535) int port,
    @NonNull Executor executor,
    @NonNull Proxy.HttpConnectCallback callback
)

Membangun proxy HTTP.

Konstanta

SCHEME_HTTP

public static final int SCHEME_HTTP = 0

Buat koneksi teks biasa ke proxy itu sendiri.

SCHEME_HTTPS

public static final int SCHEME_HTTPS = 1

Buat koneksi aman ke proxy itu sendiri.

Metode publik

createHttpProxy

public static @NonNull Proxy createHttpProxy(
    @Proxy.Scheme int scheme,
    @NonNull String host,
    @IntRange(from = 0, to = 65535) int port,
    @NonNull Executor executor,
    @NonNull Proxy.HttpConnectCallback callback
)

Membangun proxy HTTP.

Saat mengirim permintaan HTTP melalui proxy HTTP, apakah callback dipanggil atau tidak, bergantung pada skema URI tujuan:

  • Untuk tujuan dengan skema URI https, CronetEngine membuat tunnel melalui proxy. Tunnel dibuat melalui permintaan HTTP CONNECT. Dalam hal ini, callback akan dipanggil untuk mengontrol permintaan HTTP CONNECT yang digunakan untuk membuat tunnel.
  • Untuk tujuan dengan skema URI http, CronetEngine mengirim permintaan HTTP, yang berisi seluruh URI tujuan, ke proxy. Dalam hal ini, callback tidak akan dipanggil.
Parameter
@Proxy.Scheme int scheme

Scheme yang, bersama dengan host dan port, mengidentifikasi proxy ini.
@NonNull String host

Host yang tidak kosong yang, bersama dengan scheme dan port, mengidentifikasi proxy ini.
@IntRange(from = 0, to = 65535) int port

Port yang, bersama dengan scheme dan host, mengidentifikasi proxy ini. Nilainya harus dalam [0, 65535].
@NonNull Executor executor

Eksekutor tempat callback akan dipanggil.
@NonNull Proxy.HttpConnectCallback callback

Callback yang memungkinkan interaksi dengan permintaan HTTP CONNECT, dan responsnya, yang dikirim CronetEngine untuk membuat tunnel melalui proxy.