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 है.