ProxyOptions

class ProxyOptions

ההגדרה הזו מגדירה תצורת proxy שאפשר להשתמש בה ב-CronetEngine.

סיכום

סוגי רכיבים שהוצבו בתוך רכיבים אחרים

הגדרת ההתנהגות אחרי שכל השרתים הפרוקסי ב-ProxyOptions נכשלו.

ערכים קבועים
const Int

מאפשרת תנועה ישירה שלא עוברת דרך שרת proxy.
const Int

התנועה הישירה אסורה.

פונקציות ציבוריות
java-static ProxyOptions
fromProxyList(
    proxyList: (Mutable)List<Proxy!>,
    @ProxyOptions.AllProxiesFailedBehavior allProxiesFailedBehavior: Int
)

המדיניות הזו יוצרת הגדרת שרת Proxy מתוך רשימה של Proxy.

ערכים קבועים

ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT

const val ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT = 1: Int

מאפשרת תנועה ישירה שלא עוברת דרך שרת proxy.

ההגדרה הזו מגדירה התנהגות של 'פתיחה במקרה של כשל': אם כל שרתי ה-proxy ב-ProxyOptions נכשלו, CronetEngine יחזור לחיבורים ללא proxy.

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 מתוך רשימה של Proxy.

שרתי ה-proxy ברשימה ישמשו לפי הסדר. שרת ה-Proxy במיקום N+1 ישמש רק אם CronetEngine לא הצליח להשתמש בשרת ה-Proxy במיקום N. אם שרת proxy במיקום N נכשל מסיבה כלשהי (כולל סגירת מנהור שהופעלה דרך Proxy.HttpConnectCallback), אבל שרת proxy במיקום N+1 מצליח, לשרתי proxy במיקום N תינתן עדיפות נמוכה יותר באופן זמני. אם לשרת proxy יש עדיפות נמוכה, הוא ישמש רק כמוצא אחרון.

פרמטרים
proxyList: (Mutable)List<Proxy!>

רשימת Proxy שמגדירה את ההגדרה הזו.
@ProxyOptions.AllProxiesFailedBehavior allProxiesFailedBehavior: Int

איך CronetEngine צריך להתנהג אחרי שהוא לא הצליח להשתמש בכל השרתים הפרוקסי ב-proxyList.
הקפצת הודעות שגיאה (throw)
java.lang.IllegalArgumentException

אם רשימת ה-proxy ריקה או אם יש בה רכיב שהוא null.