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 पोज़िशन वाली प्रॉक्सी काम नहीं करती है, लेकिन N+1 पोज़िशन वाली प्रॉक्सी काम करती है, तो N पोज़िशन वाली प्रॉक्सी को कुछ समय के लिए कम प्राथमिकता दी जाएगी. N पोज़िशन वाली प्रॉक्सी के काम न करने की वजहों में, Proxy.HttpConnectCallback की वजह से टनल बंद होना भी शामिल है. जब किसी प्रॉक्सी को प्राथमिकता नहीं दी जाती है, तब उसका इस्तेमाल सिर्फ़ आखिरी विकल्प के तौर पर किया जाता है.

पैरामीटर
@NonNull List<Proxy> proxyList

Proxy की सूची, जो इस कॉन्फ़िगरेशन को तय करती है.
@ProxyOptions.AllProxiesFailedBehavior int allProxiesFailedBehavior

proxyList में मौजूद सभी प्रॉक्सी का इस्तेमाल न कर पाने पर, CronetEngine को कैसे काम करना चाहिए.
थ्रो
java.lang.IllegalArgumentException

अगर प्रॉक्सी सूची खाली है या कोई एलिमेंट null है.