ImplicitFlowControlCallback

abstract class ImplicitFlowControlCallback : UrlRequest.Callback

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

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

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

התמחות של InMemoryTransformCronetCallback שמחזירה את הבייטים של הגוף כלשונם ללא פרשנות.

JsonCronetCallback

התמחות של InMemoryTransformCronetCallback שמפרשת את גוף התגובה כ-JSON.

StringCronetCallback

התמחות של InMemoryTransformCronetCallback שמפרשת את גוף התגובה כמחרוזת.


הטמעה של UrlRequest.Callback שמבטלת את הקושי בניהול מחזור החיים של הבקשה, וממשיכה באופן אוטומטי לקרוא את התגובה במלואה.

סיכום

‫constructors ציבוריים

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

Unit
onCanceled(request: UrlRequest!, info: UrlResponseInfo!)

הפונקציה מופעלת אם הבקשה בוטלה דרך cancel.

Unit
onFailed(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    error: CronetException!
)

מופעל אם הבקשה נכשלה מסיבה כלשהי אחרי start.

Unit
onReadCompleted(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    byteBuffer: ByteBuffer!
)

מופעל בכל פעם שחלק מגוף התשובה נקרא.

Unit
onRedirectReceived(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    newLocationUrl: String!
)

מופעל בכל פעם שנתקלים בהפניה אוטומטית.

Unit

מופעל כשמתקבלת קבוצת הכותרות הסופית, אחרי כל ההפניות האוטומטיות.

Unit
onSucceeded(request: UrlRequest!, info: UrlResponseInfo!)

מופעל כשהבקשה הושלמה בהצלחה.

פונקציות מוגנות

abstract Unit

מופעל בכל פעם שחלק מגוף התשובה נקרא.

abstract Unit

הפונקציה מופעלת אם הבקשה בוטלה דרך cancel.

abstract Unit
onFailed(info: UrlResponseInfo?, exception: CronetException!)

מופעל אם הבקשה נכשלה מסיבה כלשהי אחרי start.

abstract Unit

מופעל כשמתקבלת קבוצת הכותרות הסופית, אחרי כל ההפניות האוטומטיות.

abstract Unit

מופעל כשהבקשה הושלמה בהצלחה.

abstract Boolean
shouldFollowRedirect(info: UrlResponseInfo!, newLocationUrl: String!)

מופעל בכל פעם שנתקלים בהפניה אוטומטית.

‫constructors ציבוריים

ImplicitFlowControlCallback

ImplicitFlowControlCallback()

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

onCanceled

fun onCanceled(request: UrlRequest!, info: UrlResponseInfo!): Unit

הפונקציה מופעלת אם הבקשה בוטלה דרך cancel. אחרי שמפעילים את השיטה הזו, לא מופעלות שיטות אחרות של Callback. הטמעת ברירת המחדל לא מבצעת פעולה.

פרמטרים
request: UrlRequest!

בקשה שבוטלה.

info: UrlResponseInfo!

פרטי התשובה. יכול להיות null אם לא התקבלה תשובה.

onFailed

fun onFailed(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    error: CronetException!
): Unit

מופעל אם הבקשה נכשלה מסיבה כלשהי אחרי start. אחרי שמפעילים את השיטה הזו, לא מופעלות שיטות אחרות של Callback. error מספק מידע על הכשל.

פרמטרים
request: UrlRequest!

הבקשה שנכשלה.

info: UrlResponseInfo!

פרטי התשובה. יכול להיות null אם לא התקבלה תשובה.

error: CronetException!

מידע על השגיאה.

onReadCompleted

fun onReadCompleted(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    byteBuffer: ByteBuffer!
): Unit

מופעל בכל פעם שחלק מגוף התשובה נקרא. יכול להיות שרק חלק מהמאגר יאוכלס, גם אם גוף התגובה המלא עדיין לא נצרך. למעט onCanceled(), לא תופעל אף שיטה אחרת של Callback עבור הבקשה, כולל onSucceeded() ו-onFailed(), עד שיתבצע קריאה ל-UrlRequest.read() כדי לנסות להמשיך לקרוא את גוף התשובה.

פרמטרים
request: UrlRequest!

בקשה שקיבלה נתונים.

info: UrlResponseInfo!

פרטי התשובה.

byteBuffer: ByteBuffer!

המאגר שהועבר אל UrlRequest.read(), שמכיל עכשיו את הנתונים שהתקבלו. המיקום של המאגר מתעדכן לסוף הנתונים שהתקבלו. המגבלה של המאגר לא משתנה.

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

אם מתרחשת שגיאה במהלך עיבוד השלמת קריאה. הקריאה ל-onFailed תתבצע כשהחריגה שהופעלה מוגדרת כסיבה ל-CallbackException.

onRedirectReceived

fun onRedirectReceived(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    newLocationUrl: String!
): Unit

מופעל בכל פעם שנתקלים בהפניה אוטומטית. הפונקציה הזו תופעל רק בין הקריאה ל-start לבין הקריאה ל-onResponseStarted(). הסורק יתעלם מגוף התגובה של ההפניה האוטומטית, אם יש כזה. ההפניה האוטומטית לא תתבצע עד שהשיטה followRedirect של URLRequest תיקרא, באופן סינכרוני או אסינכרוני.

פרמטרים
request: UrlRequest!

לבקש הפניה אוטומטית.

info: UrlResponseInfo!

פרטי התשובה.

newLocationUrl: String!

המיקום שאליו מופנית הבקשה.

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

אם מתרחשת שגיאה במהלך עיבוד של הפניה אוטומטית. הקריאה ל-onFailed תתבצע כשהחריגה שהופעלה מוגדרת כסיבה ל-CallbackException.

onResponseStarted

fun onResponseStarted(request: UrlRequest!, info: UrlResponseInfo!): Unit

מופעל כשמתקבלת קבוצת הכותרות הסופית, אחרי כל ההפניות האוטומטיות. הפונקציה תופעל רק פעם אחת לכל בקשה. למעט onCanceled(), לא תופעל אף שיטה אחרת של Callback עבור הבקשה, כולל onSucceeded() ו-onFailed(), עד שיתבצע קריאה ל-UrlRequest.read() כדי לנסות להתחיל לקרוא את גוף התגובה.

פרמטרים
request: UrlRequest!

בקשה שהתחילה לקבל תגובה.

info: UrlResponseInfo!

פרטי התשובה.

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

אם מתרחשת שגיאה במהלך עיבוד התחלת התגובה. הקריאה ל-onFailed תתבצע כשהחריגה שהופעלה מוגדרת כסיבה ל-CallbackException.

onSucceeded

fun onSucceeded(request: UrlRequest!, info: UrlResponseInfo!): Unit

מופעל כשהבקשה הושלמה בהצלחה. אחרי שמפעילים את השיטה הזו, לא מופעלות שיטות אחרות של Callback.

פרמטרים
request: UrlRequest!

בקשה שהצליחה.

info: UrlResponseInfo!

פרטי התשובה.

פונקציות מוגנות

onBodyChunkRead

protected abstract fun onBodyChunkRead(info: UrlResponseInfo!, bodyChunk: ByteBuffer!): Unit

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

פרמטרים
info: UrlResponseInfo!

פרטי התשובה.

bodyChunk: ByteBuffer!

המאגר שמכיל את הנתונים שהתקבלו, הפוך לקריאה.

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

אם מתרחשת שגיאה במהלך עיבוד של קריאה שהושלמה. הפונקציה onFailed תיקרא עם החריגה שהושלכה שמוגדרת כסיבה של CallbackException.

onCanceled

protected abstract fun onCanceled(info: UrlResponseInfo?): Unit

הפונקציה מופעלת אם הבקשה בוטלה דרך cancel. אחרי שמפעילים את השיטה הזו, לא מופעלות שיטות אחרות של UrlRequest.Callback.

פרמטרים
info: UrlResponseInfo?

פרטי התשובה. יכול להיות null אם לא התקבלה תשובה.

onFailed

protected abstract fun onFailed(info: UrlResponseInfo?, exception: CronetException!): Unit

מופעל אם הבקשה נכשלה מסיבה כלשהי אחרי start. אחרי שמפעילים את השיטה הזו, לא מופעלות שיטות אחרות של UrlRequest.Callback. error מספק מידע על הכשל.

פרמטרים
info: UrlResponseInfo?

פרטי התשובה. יכול להיות null אם לא התקבלה תשובה.

exception: CronetException!

מידע על השגיאה.

onResponseStarted

protected abstract fun onResponseStarted(info: UrlResponseInfo!): Unit

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

פרמטרים
info: UrlResponseInfo!

פרטי התשובה.

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

אם מתרחשת שגיאה במהלך עיבוד התחלת התגובה. הפונקציה onFailed תיקרא עם החריגה שהופעלה כסיבה ל-CallbackException.

onSucceeded

protected abstract fun onSucceeded(info: UrlResponseInfo!): Unit

מופעל כשהבקשה הושלמה בהצלחה. אחרי שמפעילים את השיטה הזו, לא מופעלות שיטות אחרות של UrlRequest.Callback.

פרמטרים
info: UrlResponseInfo!

פרטי התשובה.

shouldFollowRedirect

protected abstract fun shouldFollowRedirect(info: UrlResponseInfo!, newLocationUrl: String!): Boolean

מופעל בכל פעם שנתקלים בהפניה אוטומטית. הפונקציה הזו תופעל רק בין הקריאה ל-start לבין הקריאה ל-onResponseStarted(). הסורק יתעלם מגוף התגובה של ההפניה האוטומטית, אם יש כזה.

פרמטרים
info: UrlResponseInfo!

פרטי התשובה.

newLocationUrl: String!

המיקום שאליו מופנית הבקשה.

החזרות
Boolean

הערך true אם צריך לעקוב אחרי ההפניה, הערך false אם צריך לבטל את הבקשה.

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

אם מתרחשת שגיאה במהלך העיבוד של הפניה אוטומטית. הפונקציה onFailed תיקרא עם החריגה שהופעלה, שמוגדרת כסיבה ל-CallbackException.