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.

سيتم استخدام الخوادم الوكيلة في القائمة بالترتيب. لن يتم استخدام الخادم الوكيل في الموضع N+1 إلا إذا تعذّر على CronetEngine استخدام الخادم الوكيل في الموضع N. إذا تعذّر عرض الخادم الوكيل في الموضع N لأي سبب (بما في ذلك عمليات إغلاق الأنفاق التي يتم تفعيلها من خلال Proxy.HttpConnectCallback)، ولكن تم عرض الخادم الوكيل في الموضع N+1 بنجاح، سيتم مؤقتًا خفض أولوية الخوادم الوكيلة في الموضع N. عندما تكون الأولوية منخفضة للخادم الوكيل، لن يتم استخدامه إلا كحلّ أخير.

المعلَمات
@NonNull List<Proxy> proxyList

قائمة Proxy التي تحدّد هذا الإعداد.
@ProxyOptions.AllProxiesFailedBehavior int allProxiesFailedBehavior

الطريقة التي يجب أن تتصرف بها CronetEngine بعد تعذُّر استخدام جميع الخوادم الوكيلة في proxyList
عمليات الطرح
java.lang.IllegalArgumentException

إذا كانت قائمة الخوادم الوكيلة فارغة أو كان أي عنصر null