UrlRequest

public abstract class UrlRequest

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

סיכום

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

‫Builder של UrlRequest.
public abstract class UrlRequest.Callback

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

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

ערכי סטטוס הבקשה שמוחזרים על ידי getStatus.
public abstract class UrlRequest.StatusListener

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

‫constructors ציבוריים

‫methods ציבוריים
abstract void

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

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

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

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

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

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

‫constructors ציבוריים

UrlRequest

public UrlRequest()

‫methods ציבוריים

ביטול

public abstract void cancel()

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

followRedirect

public abstract void followRedirect()

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

getStatus

public abstract void getStatus(UrlRequest.StatusListener listener)

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

פרמטרים
UrlRequest.StatusListener listener

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

isDone

public abstract boolean isDone()

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

החזרות
boolean

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

קריאה

public abstract void read(ByteBuffer buffer)

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

פרמטרים
ByteBuffer buffer

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

התחלה

public abstract void start()

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