NetworkException

public abstract class NetworkException extends CronetException

מחלקות משנה ישירות מוכרות
QuicException

מחלקת משנה של NetworkException שמכילה קוד שגיאה מפורט של QUIC מ- QuicErrorCode.


חריגה שמועברת אל UrlRequest.Callback.onFailed() כש-Cronet לא מצליח לעבד בקשה לאחזור מהרשת. במקרה כזה, אפשר להשתמש בערכים getErrorCode ו-getCronetInternalErrorCode כדי לקבל מידע נוסף על סוג הכשל הספציפי. אם הפונקציה getErrorCode מחזירה ERROR_QUIC_PROTOCOL_FAILED, אפשר להמיר את החריג הזה ל-QuicException כדי לקבל פרטים נוספים.

סיכום

ערכים קבועים

static final int

קוד שגיאה שמציין שלא ניתן להגיע לכתובת ה-IP שאליה מתבצעת הפנייה, כלומר אין מסלול למארח או לרשת שצוינו.

static final int

קוד שגיאה שמציין שהחיבור נסגר באופן לא צפוי.

static final int

קוד שגיאה שמציין שניסיון החיבור נדחה.

static final int

קוד שגיאה שמציין שהחיבור אופס באופן לא צפוי.

static final int

קוד השגיאה שמציין שהזמן הקצוב לתפוגה של ניסיון החיבור הסתיים.

static final int

קוד שגיאה שמציין שלא הייתה אפשרות לתרגם את המארח שאליו נשלחה הבקשה לכתובת IP.

static final int

קוד שגיאה שמציין שהמכשיר לא היה מחובר לאף רשת.

static final int

קוד שגיאה שמציין שהגדרת הרשת השתנתה במהלך עיבוד הבקשה.

static final int

קוד שגיאה שמציין שנתקלתם בסוג אחר של שגיאה.

static final int

קוד שגיאה שמציין שגיאה שקשורה לפרוטוקול QUIC.

static final int

קוד שגיאה שמציין שפג תוקף הזמן הקצוב לתפוגה.

‫Constructors מוגנים

NetworkException(String message, Throwable cause)

יוצר חריגה שנגרמת משגיאה בחיבור לרשת.

‫methods ציבוריים

abstract int

מחזירה קוד שגיאה פנימית של Cronet.

abstract int

הפונקציה מחזירה קוד שגיאה, אחד מהערכים ERROR_*.

abstract boolean

הפונקציה מחזירה true אם ניסיון חוזר לשליחת הבקשה עשוי להצליח, או false אם לא.

‫methods שעברו בירושה

מ-java.lang.Throwable
synchronized final void
synchronized Throwable
synchronized Throwable
String
String
StackTraceElement[]
synchronized final Throwable[]
synchronized Throwable
void
void
setStackTrace(StackTraceElement[] p)
String

ערכים קבועים

ERROR_ADDRESS_UNREACHABLE

public static final int ERROR_ADDRESS_UNREACHABLE = 9

קוד שגיאה שמציין שלא ניתן להגיע לכתובת ה-IP שאליה מתבצעת הפנייה, כלומר אין מסלול למארח או לרשת שצוינו.

ERROR_CONNECTION_CLOSED

public static final int ERROR_CONNECTION_CLOSED = 5

קוד שגיאה שמציין שהחיבור נסגר באופן לא צפוי.

ERROR_CONNECTION_REFUSED

public static final int ERROR_CONNECTION_REFUSED = 7

קוד שגיאה שמציין שניסיון החיבור נדחה.

ERROR_CONNECTION_RESET

public static final int ERROR_CONNECTION_RESET = 8

קוד שגיאה שמציין שהחיבור אופס באופן לא צפוי.

ERROR_CONNECTION_TIMED_OUT

public static final int ERROR_CONNECTION_TIMED_OUT = 6

קוד השגיאה שמציין שהזמן הקצוב לתפוגה של ניסיון החיבור הסתיים.

ERROR_HOSTNAME_NOT_RESOLVED

public static final int ERROR_HOSTNAME_NOT_RESOLVED = 1

קוד שגיאה שמציין שלא הייתה אפשרות לתרגם את המארח שאליו נשלחה הבקשה לכתובת IP.

ERROR_INTERNET_DISCONNECTED

public static final int ERROR_INTERNET_DISCONNECTED = 2

קוד שגיאה שמציין שהמכשיר לא היה מחובר לאף רשת.

ERROR_NETWORK_CHANGED

public static final int ERROR_NETWORK_CHANGED = 3

קוד שגיאה שמציין שהגדרת הרשת השתנתה במהלך עיבוד הבקשה. כש-getErrorCode מחזיר את הקוד הזה, יכול להיות שהחריגה הזו תועבר אל QuicException לקבלת מידע נוסף אם נעשה שימוש בפרוטוקול QUIC.

ERROR_OTHER

public static final int ERROR_OTHER = 11

קוד שגיאה שמציין שנתקלתם בסוג אחר של שגיאה. אפשר להתייעץ עם getCronetInternalErrorCode כדי לקבל הסבר ספציפי יותר.

ERROR_QUIC_PROTOCOL_FAILED

public static final int ERROR_QUIC_PROTOCOL_FAILED = 10

קוד שגיאה שמציין שגיאה שקשורה לפרוטוקול QUIC. כש-getErrorCode מחזירה את הקוד הזה, אפשר להמיר את החריגה הזו ל-QuicException כדי לקבל מידע נוסף.

ERROR_TIMED_OUT

public static final int ERROR_TIMED_OUT = 4

קוד שגיאה שמציין שפג תוקף הזמן הקצוב לתפוגה. אם הזמן הקצוב לתפוגה יפוג במהלך הניסיון להתחבר, השגיאה שתדווח תהיה ERROR_CONNECTION_TIMED_OUT.

‫Constructors מוגנים

NetworkException

protected NetworkException(String message, Throwable cause)

יוצר חריגה שנגרמת משגיאה בחיבור לרשת.

פרמטרים
String message

הסבר על הכשל.

Throwable cause

הסיבה (שנשמרת לאחזור מאוחר יותר באמצעות השיטה getCause()). מותר להשתמש בערך null, שמציין שהסיבה לא קיימת או לא ידועה.

‫methods ציבוריים

getCronetInternalErrorCode

public abstract int getCronetInternalErrorCode()

מחזירה קוד שגיאה פנימית של Cronet. יכול להיות שהאבחון הזה יספק אבחון שגיאות ספציפי יותר מאשר getErrorCode, אבל הערכים הקבועים לא נחשפים ל-Java ויכולים להשתנות לאורך זמן. כאן אפשר לראות את רשימת הערכים העדכנית.

החזרות
int

קוד שגיאה פנימית של Cronet.

getErrorCode

public abstract int getErrorCode()

הפונקציה מחזירה קוד שגיאה, אחד מהערכים ERROR_*.

החזרות
int

קוד שגיאה, אחד מהערכים ERROR_*.

immediatelyRetryable

public abstract boolean immediatelyRetryable()

הפונקציה מחזירה true אם ניסיון חוזר לשליחת הבקשה עשוי להצליח, או false אם לא. לדוגמה, הפונקציה מחזירה true אם הפונקציה getErrorCode מחזירה ERROR_NETWORK_CHANGED, כי יכול להיות שהניסיון לשלוח את הבקשה יצליח באמצעות הגדרת הרשת החדשה, אבל היא מחזירה false אם הפונקציה getErrorCode() מחזירה ERROR_INTERNET_DISCONNECTED, כי ניסיון חוזר לשלוח את הבקשה מיד ייתקל באותו כשל (במקום זאת, צריך לדחות את הניסיון החוזר עד שהמכשיר יתחבר מחדש לרשת).

החזרות
boolean

true אם ניסיון חוזר לשליחת הבקשה עשוי להצליח, false אחרת.