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