ProxyOptions

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ố
const Int

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

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

Hàm công khai
java-static ProxyOptions
fromProxyList(
    proxyList: (Mutable)List<Proxy!>,
    @ProxyOptions.AllProxiesFailedBehavior allProxiesFailedBehavior: Int
)

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

Hằng số

ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT

const val ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT = 1: Int

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

const val ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT = 0: Int

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.

Hàm công khai

fromProxyList

java-static fun fromProxyList(
    proxyList: (Mutable)List<Proxy!>,
    @ProxyOptions.AllProxiesFailedBehavior allProxiesFailedBehavior: Int
): ProxyOptions

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ố
proxyList: (Mutable)List<Proxy!>

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

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.