گزینههای پروکسی
class ProxyOptions
پیکربندی پروکسی را تعریف میکند که میتواند توسط CronetEngine مورد استفاده قرار گیرد.
خلاصه
انواع تو در تو |
|---|
@ Retention (value = RetentionPolicy.SOURCE ) رفتاری را تعریف میکند که پس از شکست خوردن همه پروکسیها در |
ثابتها | |
|---|---|
const Int | ترافیک مستقیم و بدون پروکسی را مجاز میکند. |
const Int | ترافیک مستقیم را ممنوع میکند. |
کارکردهای عمومی | |
|---|---|
java-static ProxyOptions | fromProxyList ( یک پیکربندی پروکسی از لیستی از |
ثابتها
ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT
const val ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT = 1: Int
ترافیک مستقیم و بدون پروکسی را مجاز میکند.
این یک رفتار fail-open را تعریف میکند: اگر همه پروکسیها در ProxyOptions از کار بیفتند، CronetEngine به اتصالات غیر پروکسی برمیگردد.
رفتار ناموفق همه پروکسیها_عدم اجازه_مستقیم
const val ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT = 0: Int
ترافیک مستقیم را ممنوع میکند.
این یک رفتار fail-closed را تعریف میکند: اگر همه پروکسیها در ProxyOptions از کار بیفتند، CronetEngine به اتصالات غیر پروکسی متصل نمیشود.
کارکردهای عمومی
از پروکسی لیست
java-static fun fromProxyList(
proxyList: (Mutable)List<Proxy!>,
@ProxyOptions.AllProxiesFailedBehavior allProxiesFailedBehavior: Int
): ProxyOptions
یک پیکربندی پروکسی از لیستی از Proxy میسازد.
پروکسیهای موجود در لیست به ترتیب استفاده خواهند شد. پروکسی در موقعیت N+1 فقط در صورتی استفاده میشود که CronetEngine نتواند از پروکسی در موقعیت N استفاده کند. اگر پروکسی در موقعیت N به هر دلیلی (از جمله بسته شدن تونل از طریق Proxy.HttpConnectCallback ) با شکست مواجه شود، اما پروکسی در موقعیت N+1 موفق شود، پروکسیهای موقعیت N به طور موقت از اولویت خارج میشوند. در حالی که یک پروکسی از اولویت خارج میشود، فقط به عنوان آخرین راه حل استفاده میشود.
| پارامترها | |
|---|---|
proxyList: ( Mutable ) List < Proxy !> | فهرست |
@ ProxyOptions.AllProxiesFailedBehavior allProxiesFailedBehavior: Int | نحوه رفتار CronetEngine پس از عدم موفقیت در استفاده از همه پروکسیها در |
| پرتابها | |
|---|---|
java.lang.IllegalArgumentException | اگر لیست پروکسی خالی باشد، یا هر عنصری |