프록시

public final class Proxy

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

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

요약

중첩된 유형
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 스킴에 따라 달라집니다.

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

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

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

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

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

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