ProxyOptions

public final class ProxyOptions


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

סיכום

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

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

ערכים קבועים

static final int

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

static final int

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

‫methods ציבוריים

static @NonNull ProxyOptions
fromProxyList(
    @NonNull List<Proxy> proxyList,
    @ProxyOptions.AllProxiesFailedBehavior int allProxiesFailedBehavior
)

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

ערכים קבועים

ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT

public static final int ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT = 1

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

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

ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT

public static final int ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT = 0

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

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

‫methods ציבוריים

fromProxyList

public static @NonNull ProxyOptions fromProxyList(
    @NonNull List<Proxy> proxyList,
    @ProxyOptions.AllProxiesFailedBehavior int allProxiesFailedBehavior
)

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

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

פרמטרים
@NonNull List<Proxy> proxyList

רשימת Proxy שמגדירה את ההגדרה הזו.

@ProxyOptions.AllProxiesFailedBehavior int allProxiesFailedBehavior

איך CronetEngine צריך להתנהג אחרי שהוא לא הצליח להשתמש בכל השרתים הפרוקסי ב-proxyList.

הקפצת הודעות שגיאה (throw)
java.lang.IllegalArgumentException

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