ProxyOptions

public final class ProxyOptions


CronetEngine에서 사용할 수 있는 프록시 구성을 정의합니다.

요약

중첩된 유형

ProxyOptions의 모든 프록시가 실패한 후의 동작을 정의합니다.

상수

static final int

프록시되지 않은 직접 트래픽을 허용합니다.

static final int

직접 트래픽을 허용하지 않습니다.

공개 메서드

static @NonNull ProxyOptions
fromProxyList(
    @NonNull List<Proxy> proxyList,
    @ProxyOptions.AllProxiesFailedBehavior int allProxiesFailedBehavior
)

Proxy 목록에서 프록시 구성을 생성합니다.

상수

ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT

public static final int ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT = 1

프록시되지 않은 직접 트래픽을 허용합니다.

이는 실패 시 열림 동작을 정의합니다. ProxyOptions의 모든 프록시가 실패하면 CronetEngine이 프록시되지 않은 연결로 대체됩니다.

ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT

public static final int ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT = 0

직접 트래픽을 허용하지 않습니다.

이는 실패 시 닫힘 동작을 정의합니다. ProxyOptions의 모든 프록시가 실패하면 CronetEngine이 프록시되지 않은 연결로 대체되지 않습니다.

공개 메서드

fromProxyList

public static @NonNull ProxyOptions fromProxyList(
    @NonNull List<Proxy> proxyList,
    @ProxyOptions.AllProxiesFailedBehavior int allProxiesFailedBehavior
)

Proxy 목록에서 프록시 구성을 생성합니다.

목록의 프록시는 순서대로 사용됩니다. CronetEngine이 N번째 위치의 프록시를 사용하지 못한 경우에만 N+1번째 위치의 프록시가 사용됩니다. N번째 위치의 프록시가 어떤 이유로든 실패하지만 (Proxy.HttpConnectCallback을 통해 트리거된 터널 종료 포함) N+1번째 위치의 프록시가 성공하면 N번째 위치의 프록시가 일시적으로 우선순위가 낮아집니다. 프록시의 우선순위가 낮아지면 최후의 수단으로만 사용됩니다.

매개변수
@NonNull List<Proxy> proxyList

이 구성을 정의하는 Proxy 목록입니다.

@ProxyOptions.AllProxiesFailedBehavior int allProxiesFailedBehavior

CronetEngine이 proxyList의 모든 프록시를 사용하지 못한 후 동작해야 하는 방식입니다.

생성 값
java.lang.IllegalArgumentException

프록시 목록이 비어 있거나 요소가 null인 경우입니다.