Proxy

public final 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
public abstract class Proxy.HttpConnectCallback

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

Acciones que se pueden realizar en respuesta a la llamada a onResponseReceived.
public abstract class Proxy.HttpConnectCallback.Request implements AutoCloseable

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

Esquemas compatibles cuando se define un proxy.

Constantes
static final int

Establece una conexión de texto simple al proxy.
static final int

Establece una conexión segura al proxy.

Métodos públicos
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
)

Construye un proxy HTTP.

Constantes

SCHEME_HTTP

public static final int SCHEME_HTTP = 0

Establece una conexión de texto simple al proxy.

SCHEME_HTTPS

public static final int SCHEME_HTTPS = 1

Establece una conexión segura al proxy.

Métodos públicos

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
)

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 int scheme

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

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

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

Ejecutor en el que se invocará callback.
@NonNull Proxy.HttpConnectCallback callback

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.