Прокси

class Proxy


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

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

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

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

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

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

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

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

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

Константы

const Int

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

const Int

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

Общественные функции

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

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

Константы

SCHEME_HTTP

const val SCHEME_HTTP = 0: Int

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

SCHEME_HTTPS

const val SCHEME_HTTPS = 1: Int

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

Общественные функции

createHttpProxy

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

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

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

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

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

host: String

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

port: @ IntRange (from = 0, to = 65535) Int

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

executor: Executor

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

callback: Proxy.HttpConnectCallback

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