Proxy

class Proxy

Representa um proxy que pode ser usado pelo CronetEngine.

A forma como as solicitações HTTP são enviadas por proxies depende de vários fatores. Por exemplo: o tipo de proxy usado, a versão HTTP usada e se a solicitação está sendo enviada para um destino com um esquema de URI http ou https. Além disso, se um túnel pelo proxy é estabelecido ou não também depende desses fatores.

Resumo

Tipos aninhados

Controla túneis estabelecidos via HTTP CONNECT.

Ações que podem ser realizadas em resposta à chamada de onResponseReceived.

Representa uma solicitação HTTP CONNECT sendo enviada ao servidor proxy.
@Retention(value = RetentionPolicy.SOURCE)
@IntDef(value = )
annotation Proxy.Scheme

Esquemas com suporte ao definir um proxy.

Constantes
const Int

Estabelece uma conexão de texto simples com o próprio proxy.
const Int

Estabelece uma conexão segura com o próprio proxy.

Funções públicas
java-static Proxy
createHttpProxy(
    @Proxy.Scheme scheme: Int,
    host: String,
    port: @IntRange(from = 0, to = 65535) Int,
    executor: Executor,
    callback: Proxy.HttpConnectCallback
)

Cria um proxy HTTP.

Constantes

SCHEME_HTTP

const val SCHEME_HTTP = 0: Int

Estabelece uma conexão de texto simples com o próprio proxy.

SCHEME_HTTPS

const val SCHEME_HTTPS = 1: Int

Estabelece uma conexão segura com o próprio proxy.

Funções públicas

createHttpProxy

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

Cria um proxy HTTP.

Ao enviar solicitações HTTP por um proxy HTTP, se o callback é chamado ou não depende do esquema de URI do destino:

  • Para destinos com um esquema de URI https, o CronetEngine estabelece um túnel pelo proxy. O túnel é estabelecido por uma solicitação HTTP CONNECT. Nesse caso, callback será chamado para controlar a solicitação HTTP CONNECT usada para estabelecer o túnel.
  • Para destinos com um esquema de URI http, o CronetEngine envia uma solicitação HTTP, contendo todo o URI do destino, para o proxy. Nesse caso, callback não será chamado.
Parâmetros
@Proxy.Scheme scheme: Int

Scheme que, junto com host e port, identifica esse proxy.
host: String

Host não vazio que, junto com scheme e port, identifica esse proxy.
port: @IntRange(from = 0, to = 65535) Int

Porta que, junto com scheme e host, identifica esse proxy. O valor precisa estar entre [0, 65535].
executor: Executor

Executor em que callback será invocado.
callback: Proxy.HttpConnectCallback

Callback que permite interagir com a solicitação HTTP CONNECT e a resposta dela, que o CronetEngine envia para estabelecer túneis pelo proxy.