프록시

class Proxy

CronetEngine에서 사용할 수 있는 프록시를 나타냅니다.

프록시를 통해 HTTP 요청이 전송되는 방식은 다양한 요인에 따라 달라집니다. 예를 들어 사용 중인 프록시 유형, 사용 중인 HTTP 버전, 요청이 http 또는 https URI 스킴이 있는 대상으로 전송되는지 여부 등이 있습니다. 또한 프록시를 통한 터널이 설정되는지 여부도 이러한 요인에 따라 달라집니다.

요약

중첩된 유형

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 스킴에 따라 달라집니다.

  • https URI 스킴이 있는 대상의 경우 CronetEngine은 프록시를 통해 터널을 설정합니다. 터널은 HTTP CONNECT 요청을 통해 설정됩니다. 이 경우 callback이 호출되어 터널을 설정하는 데 사용되는 HTTP CONNECT 요청을 제어합니다.
  • http URI 스킴이 있는 대상의 경우 CronetEngine은 대상의 전체 URI가 포함된 HTTP 요청을 프록시에 전송합니다. 이 경우 callback이 호출되지 않습니다.
매개변수
@Proxy.Scheme scheme: Int

host 및 port와 함께 이 프록시를 식별하는 Scheme입니다.
host: String

scheme 및 port와 함께 이 프록시를 식별하는 비어 있지 않은 호스트입니다.
port: @IntRange(from = 0, to = 65535) Int

scheme 및 host와 함께 이 프록시를 식별하는 포트입니다. 값은 [0, 65535] 범위 내에 있어야 합니다.
executor: Executor

callback이 호출되는 실행기입니다.
callback: Proxy.HttpConnectCallback

CronetEngine이 프록시를 통해 터널을 설정하기 위해 전송하는 HTTP CONNECT 요청 및 응답과 상호작용할 수 있는 콜백입니다.