ProxyOptions

public final class ProxyOptions

Xác định một cấu hình proxy mà CronetEngine có thể sử dụng.

Tóm tắt

Các loại lồng nhau

Xác định hành vi sau khi tất cả các proxy trong ProxyOptions đều không thành công.

Hằng số
static final int

Cho phép lưu lượng truy cập trực tiếp, không qua proxy.
static final int

Không cho phép lưu lượng truy cập trực tiếp.

Phương thức công khai
static @NonNull ProxyOptions
fromProxyList(
    @NonNull List<Proxy> proxyList,
    @ProxyOptions.AllProxiesFailedBehavior int allProxiesFailedBehavior
)

Tạo cấu hình proxy từ danh sách Proxy.

Hằng số

ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT

public static final int ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT = 1

Cho phép lưu lượng truy cập trực tiếp, không qua proxy.

Điều này xác định hành vi mở khi thất bại: nếu tất cả các proxy trong ProxyOptions đều thất bại, CronetEngine sẽ quay lại các kết nối không qua proxy.

ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT

public static final int ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT = 0

Không cho phép lưu lượng truy cập trực tiếp.

Điều này xác định hành vi đóng khi thất bại: nếu tất cả các proxy trong ProxyOptions đều thất bại, CronetEngine sẽ không quay lại các kết nối không qua proxy.

Phương thức công khai

fromProxyList

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

Tạo cấu hình proxy từ danh sách Proxy.

Các proxy trong danh sách sẽ được dùng theo thứ tự. Proxy ở vị trí N+1 sẽ chỉ được dùng nếu CronetEngine không dùng được proxy ở vị trí N. Nếu proxy ở vị trí N không thành công vì bất kỳ lý do nào (kể cả việc đóng đường hầm được kích hoạt thông qua Proxy.HttpConnectCallback), nhưng proxy ở vị trí N+1 thành công, thì các proxy ở vị trí N sẽ tạm thời bị giảm mức độ ưu tiên. Mặc dù được giảm mức độ ưu tiên, nhưng proxy sẽ chỉ được dùng khi không còn cách nào khác.

Tham số
@NonNull List<Proxy> proxyList

Danh sách Proxy xác định cấu hình này.
@ProxyOptions.AllProxiesFailedBehavior int allProxiesFailedBehavior

Cách CronetEngine phải hoạt động sau khi không sử dụng được tất cả các proxy trong proxyList.
Gửi
java.lang.IllegalArgumentException

Nếu danh sách proxy trống hoặc có bất kỳ phần tử nào là null.