Proxy

class Proxy

Representa un proxy que puede usar CronetEngine.

La forma en que se envían las solicitudes HTTP a través de proxies depende de varios factores. Por ejemplo, el tipo de proxy que se usa, la versión de HTTP que se usa y si la solicitud se envía a un destino con un esquema de URI http o https. Además, si se establece o no un túnel a través del proxy también depende de estos factores.

Resumen

Tipos anidados

Controla los túneles establecidos a través de HTTP CONNECT.

Acciones que se pueden realizar en respuesta a la llamada a onResponseReceived.

Representa una solicitud HTTP CONNECT que se envía al servidor proxy.
@Retention(value = RetentionPolicy.SOURCE)
@IntDef(value = )
annotation Proxy.Scheme

Esquemas compatibles cuando se define un proxy.

Constantes
const Int

Establece una conexión de texto simple al proxy.
const Int

Establece una conexión segura al proxy.

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

Construye un proxy HTTP.

Constantes

SCHEME_HTTP

const val SCHEME_HTTP = 0: Int

Establece una conexión de texto simple al proxy.

SCHEME_HTTPS

const val SCHEME_HTTPS = 1: Int

Establece una conexión segura al proxy.

Funciones 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

Construye un proxy HTTP.

Cuando se envían solicitudes HTTP a través de un proxy HTTP, si se llama a callback o no, depende del esquema de URI del destino:

  • Para los destinos con un esquema de URI https, CronetEngine establece un túnel a través del proxy. El túnel se establece a través de una solicitud HTTP CONNECT. En este caso, se llamará a callback para controlar la solicitud HTTP CONNECT que se usa para establecer el túnel.
  • Para los destinos con un esquema de URI http, CronetEngine envía una solicitud HTTP, que contiene el URI completo del destino, al proxy. En este caso, no se llamará a callback.
Parámetros
@Proxy.Scheme scheme: Int

Scheme que, junto con host y port, identifica este proxy.
host: String

Host no vacío que, junto con scheme y port, identifica este proxy.
port: @IntRange(from = 0, to = 65535) Int

Puerto que, junto con scheme y host, identifica este proxy. Su valor debe estar dentro de [0, 65535].
executor: Executor

Ejecutor en el que se invocará callback.
callback: Proxy.HttpConnectCallback

Devolución de llamada que permite interactuar con la solicitud HTTP CONNECT y su respuesta, que CronetEngine envía para establecer túneles a través del proxy.