UrlRequest

abstract class UrlRequest

הגדרת בקשת HTTP (GET, ‏ PUT, ‏ POST וכו'). נוצר על ידי UrlRequest.Builder, שאפשר לקבל אותו בטלפון newUrlRequestBuilder. הערה: צריך להפעיל את כל השיטות ב-Executor שמועבר אל newUrlRequestBuilder.

סיכום

סוגי רכיבים שהוצבו בתוך רכיבים אחרים
abstract class UrlRequest.Builder

‫Builder של UrlRequest.
abstract class UrlRequest.Callback

משתמשי Cronet מרחיבים את המחלקה הזו כדי לקבל קריאות חוזרות שמציינות את ההתקדמות של UrlRequest שעובר עיבוד.

הערה לגבי ממשקי API שעדיין לא נחשבים ליציבים.

ערכי סטטוס הבקשה שמוחזרים על ידי getStatus.

מחלקת Listener שמשמשת עם getStatus לקבלת הסטטוס של UrlRequest.

‫constructors ציבוריים

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

ביטול הבקשה.
abstract Unit

עוקב אחרי הפניה אוטומטית בהמתנה.
abstract Unit

שאילתה לגבי סטטוס הבקשה.
abstract Boolean

הפונקציה מחזירה true אם הבקשה הופעלה בהצלחה והסתיימה (הושלמה, בוטלה או נכשלה).
abstract Unit
read(buffer: ByteBuffer!)

מנסה לקרוא חלק מגוף התגובה לתוך המאגר שסופק.
abstract Unit

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

‫constructors ציבוריים

UrlRequest

UrlRequest()

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

ביטול

abstract fun cancel(): Unit

ביטול הבקשה. אפשר להתקשר בכל שלב. הקריאה החוזרת (callback) onCanceled() תופעל כשהביטול יושלם, ולא יופעלו עוד שיטות של קריאה חוזרת. אם הבקשה הסתיימה או לא התחילה, לקריאה ל-cancel() אין השפעה והקריאה ל-onCanceled() לא תופעל. אם Executor שמועבר במהלך בניית UrlRequest מפעיל משימות בשרשור יחיד, ו-cancel() מופעל בשרשור הזה, לא יופעלו שיטות קריאה חוזרת (callback) (מלבד onCanceled()) אחרי הפעלת cancel(). אחרת, יכול להיות שתופעל שיטת קריאה חוזרת אחת לכל היותר אחרי ש- cancel() יסיים את הפעולה.

followRedirect

abstract fun followRedirect(): Unit

עוקב אחרי הפניה אוטומטית בהמתנה. אפשר להפעיל אותה פעם אחת לכל הפעלה של onRedirectReceived().

getStatus

abstract fun getStatus(listener: UrlRequest.StatusListener!): Unit

שאילתה לגבי סטטוס הבקשה.

פרמטרים
listener: UrlRequest.StatusListener!

‫StatusListener שיופעל עם הסטטוס הנוכחי של הבקשה. הפונקציה listener תופעל בחזרה ב-Executor שהועבר כשנוצרה הבקשה.

isDone

abstract fun isDone(): Boolean

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

החזרות
Boolean

‫true if the request was successfully started and is now finished (completed, canceled, or failed).

קריאה

abstract fun read(buffer: ByteBuffer!): Unit

מנסה לקרוא חלק מגוף התגובה לתוך המאגר שסופק. אפשר להפעיל אותה פעם אחת לכל היותר בתגובה לכל הפעלה של השיטות onResponseStarted() ו-onReadCompleted() של Callback. כל קריאה תגרום לקריאה אסינכרונית לשיטה Callback'sonReadCompleted() אם הנתונים נקראים, לשיטה onSucceeded() אם אין יותר נתונים לקריאה, או לשיטה onFailed() אם יש שגיאה.

פרמטרים
buffer: ByteBuffer!

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

התחלה

abstract fun start(): Unit

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