ImplicitFlowControlCallback

public abstract class ImplicitFlowControlCallback extends UrlRequest.Callback

java.lang.Object
↳	org.chromium.net.UrlRequest.Callback
	↳	org.chromium.net.apihelpers.ImplicitFlowControlCallback

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

InMemoryTransformCronetCallback

InMemoryTransformCronetCallback

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

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

‫ByteArrayCronetCallback, ‏ JsonCronetCallback, ‏ StringCronetCallback

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

---

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

סיכום

‫constructors ציבוריים
ImplicitFlowControlCallback()

‫methods ציבוריים
final void	onCanceled(UrlRequest request, UrlResponseInfo info) הפונקציה מופעלת אם הבקשה בוטלה דרך cancel.
final void	onFailed(     UrlRequest request,     UrlResponseInfo info,     CronetException error ) מופעל אם הבקשה נכשלה מסיבה כלשהי אחרי start.
final void	onReadCompleted(     UrlRequest request,     UrlResponseInfo info,     ByteBuffer byteBuffer ) מופעל בכל פעם שחלק מגוף התשובה נקרא.
final void	onRedirectReceived(     UrlRequest request,     UrlResponseInfo info,     String newLocationUrl ) מופעל בכל פעם שנתקלים בהפניה אוטומטית.
final void	onResponseStarted(UrlRequest request, UrlResponseInfo info) מופעל כשמתקבלת קבוצת הכותרות הסופית, אחרי כל ההפניות האוטומטיות.
final void	onSucceeded(UrlRequest request, UrlResponseInfo info) מופעל כשהבקשה הושלמה בהצלחה.

שיטות מוגנות
abstract void	onBodyChunkRead(UrlResponseInfo info, ByteBuffer bodyChunk) מופעל בכל פעם שחלק מגוף התשובה נקרא.
abstract void	onCanceled(@Nullable UrlResponseInfo info) הפונקציה מופעלת אם הבקשה בוטלה דרך cancel.
abstract void	onFailed(@Nullable UrlResponseInfo info, CronetException exception) מופעל אם הבקשה נכשלה מסיבה כלשהי אחרי start.
abstract void	onResponseStarted(UrlResponseInfo info) מופעל כשמתקבלת קבוצת הכותרות הסופית, אחרי כל ההפניות האוטומטיות.
abstract void	onSucceeded(UrlResponseInfo info) מופעל כשהבקשה הושלמה בהצלחה.
abstract boolean	shouldFollowRedirect(UrlResponseInfo info, String newLocationUrl) מופעל בכל פעם שנתקלים בהפניה אוטומטית.

‫constructors ציבוריים

ImplicitFlowControlCallback

public ImplicitFlowControlCallback()

‫methods ציבוריים

onCanceled

public final void onCanceled(UrlRequest request, UrlResponseInfo info)

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

פרמטרים
UrlRequest request	בקשה שבוטלה.
UrlResponseInfo info	פרטי התשובה. יכול להיות null אם לא התקבלה תשובה.

onFailed

public final void onFailed(
    UrlRequest request,
    UrlResponseInfo info,
    CronetException error
)

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

פרמטרים
UrlRequest request	הבקשה שנכשלה.
UrlResponseInfo info	פרטי התשובה. יכול להיות null אם לא התקבלה תשובה.
CronetException error	מידע על השגיאה.

onReadCompleted

public final void onReadCompleted(
    UrlRequest request,
    UrlResponseInfo info,
    ByteBuffer byteBuffer
)

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

פרמטרים
UrlRequest request	בקשה שקיבלה נתונים.
UrlResponseInfo info	פרטי התשובה.
ByteBuffer byteBuffer	המאגר שהועבר אל UrlRequest.read(), שמכיל עכשיו את הנתונים שהתקבלו. המיקום של המאגר מתעדכן לסוף הנתונים שהתקבלו. המגבלה של המאגר לא משתנה.

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

onRedirectReceived

public final void onRedirectReceived(
    UrlRequest request,
    UrlResponseInfo info,
    String newLocationUrl
)

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

פרמטרים
UrlRequest request	לבקש הפניה אוטומטית.
UrlResponseInfo info	פרטי התשובה.
String newLocationUrl	המיקום שאליו מופנית הבקשה.

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

onResponseStarted

public final void onResponseStarted(UrlRequest request, UrlResponseInfo info)

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

פרמטרים
UrlRequest request	בקשה שהתחילה לקבל תגובה.
UrlResponseInfo info	פרטי התשובה.

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

onSucceeded

public final void onSucceeded(UrlRequest request, UrlResponseInfo info)

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

פרמטרים
UrlRequest request	בקשה שהצליחה.
UrlResponseInfo info	פרטי התשובה.

שיטות מוגנות

onBodyChunkRead

protected abstract void onBodyChunkRead(UrlResponseInfo info, ByteBuffer bodyChunk)

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

פרמטרים
UrlResponseInfo info	פרטי התשובה.
ByteBuffer bodyChunk	המאגר שמכיל את הנתונים שהתקבלו, הפוך לקריאה.

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

onCanceled

protected abstract void onCanceled(@Nullable UrlResponseInfo info)

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

פרמטרים
@Nullable UrlResponseInfo info	פרטי התשובה. יכול להיות null אם לא התקבלה תשובה.

onFailed

protected abstract void onFailed(@Nullable UrlResponseInfo info, CronetException exception)

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

פרמטרים
@Nullable UrlResponseInfo info	פרטי התשובה. יכול להיות null אם לא התקבלה תשובה.
CronetException exception	מידע על השגיאה.

onResponseStarted

protected abstract void onResponseStarted(UrlResponseInfo info)

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

פרמטרים
UrlResponseInfo info	פרטי התשובה.

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

onSucceeded

protected abstract void onSucceeded(UrlResponseInfo info)

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

פרמטרים
UrlResponseInfo info	פרטי התשובה.

shouldFollowRedirect

protected abstract boolean shouldFollowRedirect(UrlResponseInfo info, String newLocationUrl)

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

פרמטרים
UrlResponseInfo info	פרטי התשובה.
String newLocationUrl	המיקום שאליו מופנית הבקשה.

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

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