Proxy

class Proxy

Rappresenta un proxy che può essere utilizzato da CronetEngine.

Il modo in cui le richieste HTTP vengono inviate tramite i proxy dipende da una serie di fattori. Ad esempio: il tipo di proxy utilizzato, la versione HTTP utilizzata, se la richiesta viene inviata a una destinazione con uno schema URI http o https. Inoltre, se viene stabilito o meno un tunnel tramite il proxy dipende anche da questi fattori.

Riepilogo

Tipi nidificati

Controlla i tunnel stabiliti tramite HTTP CONNECT.

Azioni che possono essere eseguite in risposta alla chiamata di onResponseReceived.

Rappresenta una richiesta HTTP CONNECT inviata al server proxy.
@Retention(value = RetentionPolicy.SOURCE)
@IntDef(value = )
annotation Proxy.Scheme

Schemi supportati durante la definizione di un proxy.

Costanti
const Int

Stabilisci una connessione in testo non crittografato al proxy stesso.
const Int

Stabilisci una connessione sicura al proxy stesso.

Funzioni pubbliche
java-static Proxy
createHttpProxy(
    @Proxy.Scheme scheme: Int,
    host: String,
    port: @IntRange(from = 0, to = 65535) Int,
    executor: Executor,
    callback: Proxy.HttpConnectCallback
)

Costruisce un proxy HTTP.

Costanti

SCHEME_HTTP

const val SCHEME_HTTP = 0: Int

Stabilisci una connessione in testo non crittografato al proxy stesso.

SCHEME_HTTPS

const val SCHEME_HTTPS = 1: Int

Stabilisci una connessione sicura al proxy stesso.

Funzioni pubbliche

createHttpProxy

java-static fun createHttpProxy(
    @Proxy.Scheme scheme: Int,
    host: String,
    port: @IntRange(from = 0, to = 65535) Int,
    executor: Executor,
    callback: Proxy.HttpConnectCallback
): Proxy

Costruisce un proxy HTTP.

Quando invii richieste HTTP tramite un proxy HTTP, la chiamata o meno di callback dipende dallo schema URI della destinazione:

  • Per le destinazioni con uno schema URI https, CronetEngine stabilisce un tunnel tramite il proxy. Il tunnel viene stabilito tramite una richiesta HTTP CONNECT. In questo caso, callback verrà chiamato per controllare la richiesta HTTP CONNECT utilizzata per stabilire il tunnel.
  • Per le destinazioni con uno schema URI http, CronetEngine invia una richiesta HTTP, contenente l'intero URI della destinazione, al proxy. In questo caso, callback non verrà chiamato.
Parametri
@Proxy.Scheme scheme: Int

Scheme che, insieme a host e port, identifica questo proxy.
host: String

Host non vuoto che, insieme a scheme e port, identifica questo proxy.
port: @IntRange(from = 0, to = 65535) Int

Porta che, insieme a scheme e host, identifica questo proxy. Il valore deve essere compreso tra [0, 65535].
executor: Executor

Esecutore in cui verrà richiamato callback.
callback: Proxy.HttpConnectCallback

Callback che consente di interagire con la richiesta HTTP CONNECT e la relativa risposta che CronetEngine invia per stabilire i tunnel tramite il proxy.