Прокси 

public final class Proxy

Представляет собой прокси-объект, который может использоваться CronetEngine .

Способ отправки HTTP-запросов через прокси-серверы зависит от множества факторов. Например: тип используемого прокси, используемая версия HTTP, тип URI (http или https) для отправки запроса. Кроме того, от этих факторов зависит и то, устанавливается ли туннель через прокси-сервер.

Краткое содержание

Вложенные типы

public abstract class Proxy.HttpConnectCallback

Управляет туннелями, установленными через HTTP CONNECT.

Действия, которые могут быть выполнены в ответ на вызов onResponseReceived .

public abstract class Proxy.HttpConnectCallback.Request implements AutoCloseable

Представляет собой HTTP-запрос CONNECT, отправляемый на прокси-сервер.

@ Retention (value = RetentionPolicy.SOURCE )
@ IntDef (value = )
public annotation Proxy.Scheme

Поддерживаемые схемы при определении прокси-сервера.

Константы

static final int

Установите текстовое соединение с самим прокси-сервером.

static final int

Установите защищенное соединение непосредственно с прокси-сервером.

Общедоступные методы

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
)

Создаёт HTTP-прокси.

Константы

SCHEME_HTTP 

public static final int SCHEME_HTTP = 0

Установите текстовое соединение с самим прокси-сервером.

SCHEME_HTTPS 

public static final int SCHEME_HTTPS = 1

Установите защищенное соединение непосредственно с прокси-сервером.

Общедоступные методы

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
)

Создаёт HTTP-прокси.

При отправке HTTP-запросов через HTTP-прокси вызов функции callback зависит от схемы URI целевого объекта:

  • Для направлений с URI-схемой HTTPS CronetEngine устанавливает туннель через прокси. Туннель устанавливается посредством HTTP-запроса CONNECT. В этом случае будет вызвана callback для управления HTTP-запросом CONNECT, используемым для установления туннеля.
  • Для адресов с URI типа http CronetEngine отправляет HTTP-запрос, содержащий полный URI адреса назначения, на прокси-сервер. В этом случае callback не будет вызвана.
Параметры
@ Proxy.Scheme int scheme

Scheme , которая, наряду с host и port , идентифицирует этот прокси-сервер.

@ NonNull String host

Непустой хост, который, наряду со scheme и port , идентифицирует этот прокси-сервер.

@ IntRange (from = 0, to = 65535) int port

Порт, который вместе со scheme и host идентифицирует этот прокси. Его значение должно находиться в диапазоне [0, 65535].

@ NonNull Executor executor

Исполнитель, в котором будет вызвана callback .

@ NonNull Proxy.HttpConnectCallback callback

Функция обратного вызова, позволяющая взаимодействовать с HTTP-запросом CONNECT и ответом на него, которые CronetEngine отправляет для установления туннелей через прокси-сервер.