ProxyOptions

class ProxyOptions

تحدّد هذه السياسة إعدادات الخادم الوكيل التي يمكن أن يستخدمها CronetEngine.

ملخّص

الأنواع المتداخلة

تحدّد هذه السمة السلوك بعد تعذُّر عمل جميع الخوادم الوكيلة في ProxyOptions.

الثوابت
const Int

تسمح هذه السياسة بالزيارات المباشرة غير المُستخدَمة كوكيل.
const Int

لا يسمح بالزيارات المباشرة.

الوظائف العامة
java-static ProxyOptions
fromProxyList(
    proxyList: (Mutable)List<Proxy!>,
    @ProxyOptions.AllProxiesFailedBehavior allProxiesFailedBehavior: Int
)

تنشئ هذه السياسة إعدادات خادم وكيل من قائمة Proxy.

الثوابت

ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT

const val ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT = 1: Int

تسمح هذه السياسة بالزيارات المباشرة غير المُستخدَمة كوكيل.

يحدّد هذا السلوك "الفتح عند التعذّر": إذا تعذّر استخدام جميع الخوادم الوكيلة في ProxyOptions، سيعود CronetEngine إلى الاتصالات غير الوكيلة.

ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT

const val ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT = 0: Int

لا يسمح بالزيارات المباشرة.

يحدّد ذلك سلوكًا يمنع حدوث أي خطأ: إذا تعذّر عمل جميع الخوادم الوكيلة في ProxyOptions، لن يعود CronetEngine إلى الاتصالات غير الوكيلة.

الوظائف العامة

fromProxyList

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!>

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

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

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