با چرخه حیات درخواستهای ایجادشده بااستفاده از Cronet و نحوه مدیریت آنها بااستفاده از روشهای فراخوانی ارائهشده توسط کتابخانه آشنا شوید.
نمای کلی چرخه حیات
کلاس UrlRequest نشاندهنده درخواستهای شبکه ایجادشده بااستفاده از کتابخانه Cronet است. مفاهیم زیر برای درک چرخه حیات UrlRequest
مهم هستند:
- ایالتها
- وضعیت، شرایط خاصی است که درخواست در زمان مشخصی در آن قرار دارد.
UrlRequestشیء ایجادشده بااستفاده از «کتابخانه Cronet» درطول چرخه حیات خود از حالتهای مختلفی عبور میکنند. چرخه حیات درخواست شامل یک حالت اولیه، و چندین حالت انتقالی و نهایی است. UrlRequestروش- مشتریان میتوانند روشهای خاصی را در اشیاء
UrlRequestبسته به وضعیت فراخوانی کنند. این روشها درخواست را از یک حالت به حالت دیگر منتقل میکنند. Callbackروش- با پیادهسازی روشهای کلاس
UrlRequest.Callback، برنامهتان میتواند بهروزرسانیهایی درباره پیشرفت درخواست دریافت کند. میتوانید روشهای فراخوانی را پیادهسازی کنید تا روشهای شیءUrlRequestرا فراخوانی کنید که چرخه حیات را از یک حالت به حالت دیگر میبرد.
فهرست زیر جریان چرخه حیات UrlRequest را شرح میدهد:
- چرخه حیات پساز اینکه برنامهتان روش
start()را فراخوانی میکند، در وضعیت شروعشده قرار میگیرد. - سرور ممکن است پاسخ هدایتگری ارسال کند که جریان را به روش
onRedirectReceived()میبرد. در این روش، میتوانید یکی از کنشهای مشتری زیر را انجام دهید:- بااستفاده از
followRedirect()، تغییر مسیر را دنبال کنید. این روش درخواست را به حالت شروعشده برمیگرداند. - درخواست را بااستفاده از
cancel()لغو کنید. این روش درخواست را به روشonCanceled()میبرد که در آن برنامه میتواند قبلاز اینکه درخواست به وضعیت نهایی لغوشده منتقل شود، عملیات بیشتری انجام دهد.
- بااستفاده از
- پساز اینکه برنامه همه تغییرمسیرها را دنبال کرد، سرور سرایندهای پاسخ را ارسال میکند و Cronet روش
onResponseStarted()را فراخوانی میکند. درخواست در وضعیت درانتظار read() است. برنامه باید روشread()را فراخوانی کند تا تلاش کند بخشی از بدنه پاسخ را بخواند. پساز اینکه برنامهتانread()را فراخوانی کرد، درخواست در وضعیت درحال خواندن قرار میگیرد که در آن نتایج احتمالی زیر وجود دارد:- عمل خواندن موفقیتآمیز است و دادههای بیشتری دردسترس است. Cronet
روش
onReadCompleted()را فراخوانی میکند و درخواست دوباره در وضعیت درانتظار read() قرار میگیرد. برنامه میتواند دوباره روشread()را فراخوانی کند تا خواندن بدنه پاسخ را ادامه دهد. برنامه همچنین میتواند بااستفاده از روشcancel()خواندن درخواست را متوقف کند. - کنش خواندن موفقیتآمیز است و داده دیگری دردسترس نیست. Cronet
روش
onSucceeded()را فراخوانی میکند و درخواست در وضعیت نهایی موفقیتآمیز قرار میگیرد. - کنش خواندن ناموفق است. Cronet روش
onFailed()را فراخوانی میکند و وضعیت نهایی درخواست ناموفق است.
- عمل خواندن موفقیتآمیز است و دادههای بیشتری دردسترس است. Cronet
روش
نمودار زیر چرخه حیات شیء UrlRequest را نشان میدهد:
چرخه حیات درخواست Cronet
| Legend | |
|---|---|
| |
|
| |
|
UrlRequest |