NetworkException

abstract class NetworkException : CronetException

kotlin.Any
   ↳ kotlin.Throwable
     ↳ java.lang.Exception
       ↳ java.io.IOException
         ↳ org.chromium.net.CronetException
           ↳ org.chromium.net.NetworkException
מחלקות משנה ישירות מוכרות
QuicException

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


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

סיכום

ערכים קבועים

const Int

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

const Int

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

const Int

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

const Int

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

const Int

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

const Int

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

const Int

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

const Int

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

const Int

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

const Int

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

const Int

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

‫Constructors מוגנים

NetworkException(message: String!, cause: Throwable!)

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

פונקציות ציבוריות

abstract Int

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

abstract Int

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

abstract Boolean

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

ערכים קבועים

ERROR_ADDRESS_UNREACHABLE

const val ERROR_ADDRESS_UNREACHABLE = 9: Int

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

ERROR_CONNECTION_CLOSED

const val ERROR_CONNECTION_CLOSED = 5: Int

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

ERROR_CONNECTION_REFUSED

const val ERROR_CONNECTION_REFUSED = 7: Int

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

ERROR_CONNECTION_RESET

const val ERROR_CONNECTION_RESET = 8: Int

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

ERROR_CONNECTION_TIMED_OUT

const val ERROR_CONNECTION_TIMED_OUT = 6: Int

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

ERROR_HOSTNAME_NOT_RESOLVED

const val ERROR_HOSTNAME_NOT_RESOLVED = 1: Int

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

ERROR_INTERNET_DISCONNECTED

const val ERROR_INTERNET_DISCONNECTED = 2: Int

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

ERROR_NETWORK_CHANGED

const val ERROR_NETWORK_CHANGED = 3: Int

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

ERROR_OTHER

const val ERROR_OTHER = 11: Int

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

ERROR_QUIC_PROTOCOL_FAILED

const val ERROR_QUIC_PROTOCOL_FAILED = 10: Int

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

ERROR_TIMED_OUT

const val ERROR_TIMED_OUT = 4: Int

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

‫Constructors מוגנים

NetworkException

protected NetworkException(message: String!, cause: Throwable!)

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

פרמטרים
message: String!

הסבר על הכשל.

cause: Throwable!

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

פונקציות ציבוריות

getCronetInternalErrorCode

abstract fun getCronetInternalErrorCode(): Int

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

החזרות
Int

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

getErrorCode

abstract fun getErrorCode(): Int

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

החזרות
Int

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

immediatelyRetryable

abstract fun immediatelyRetryable(): Boolean

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

החזרות
Boolean

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