چرخه حیات درخواست Cronet

با چرخه حیات درخواست‌های ایجادشده بااستفاده از Cronet و نحوه مدیریت آن‌ها بااستفاده از روش‌های فراخوانی ارائه‌شده توسط کتابخانه آشنا شوید.

نمای کلی چرخه حیات

کلاس UrlRequest نشان‌دهنده درخواست‌های شبکه ایجادشده بااستفاده از کتابخانه Cronet است. مفاهیم زیر برای درک چرخه حیات UrlRequest مهم هستند:

ایالت‌ها
وضعیت، شرایط خاصی است که درخواست در زمان مشخصی در آن قرار دارد. UrlRequest شیء ایجادشده بااستفاده از «کتابخانه Cronet» درطول چرخه حیات خود از حالت‌های مختلفی عبور می‌کنند. چرخه حیات درخواست شامل یک حالت اولیه، و چندین حالت انتقالی و نهایی است.
UrlRequest روش
مشتریان می‌توانند روش‌های خاصی را در اشیاء UrlRequest بسته به وضعیت فراخوانی کنند. این روش‌ها درخواست را از یک حالت به حالت دیگر منتقل می‌کنند.
Callback روش
با پیاده‌سازی روش‌های کلاس UrlRequest.Callback، برنامه‌تان می‌تواند به‌روزرسانی‌هایی درباره پیشرفت درخواست دریافت کند. می‌توانید روش‌های فراخوانی را پیاده‌سازی کنید تا روش‌های شیء UrlRequest را فراخوانی کنید که چرخه حیات را از یک حالت به حالت دیگر می‌برد.

فهرست زیر جریان چرخه حیات UrlRequest را شرح می‌دهد:

  1. چرخه حیات پس‌از اینکه برنامه‌تان روش start() را فراخوانی می‌کند، در وضعیت شروع‌شده قرار می‌گیرد.
  2. سرور ممکن است پاسخ هدایتگری ارسال کند که جریان را به روش onRedirectReceived() می‌برد. در این روش، می‌توانید یکی از کنش‌های مشتری زیر را انجام دهید:
    • بااستفاده از followRedirect()، تغییر مسیر را دنبال کنید. این روش درخواست را به حالت شروع‌شده برمی‌گرداند.
    • درخواست را بااستفاده از cancel() لغو کنید. این روش درخواست را به روش onCanceled() می‌برد که در آن برنامه می‌تواند قبل‌از اینکه درخواست به وضعیت نهایی لغوشده منتقل شود، عملیات بیشتری انجام دهد.
  3. پس‌از اینکه برنامه همه تغییرمسیرها را دنبال کرد، سرور سرایندهای پاسخ را ارسال می‌کند و Cronet روش onResponseStarted() را فراخوانی می‌کند. درخواست در وضعیت درانتظار read() است. برنامه باید روش read() را فراخوانی کند تا تلاش کند بخشی از بدنه پاسخ را بخواند. پس‌از اینکه برنامه‌تان read() را فراخوانی کرد، درخواست در وضعیت درحال خواندن قرار می‌گیرد که در آن نتایج احتمالی زیر وجود دارد:
    • عمل خواندن موفقیت‌آمیز است و داده‌های بیشتری دردسترس است. Cronet روش onReadCompleted() را فراخوانی می‌کند و درخواست دوباره در وضعیت درانتظار read()‎ قرار می‌گیرد. برنامه می‌تواند دوباره روش read() را فراخوانی کند تا خواندن بدنه پاسخ را ادامه دهد. برنامه همچنین می‌تواند بااستفاده از روش cancel() خواندن درخواست را متوقف کند.
    • کنش خواندن موفقیت‌آمیز است و داده دیگری دردسترس نیست. Cronet روش onSucceeded() را فراخوانی می‌کند و درخواست در وضعیت نهایی موفقیت‌آمیز قرار می‌گیرد.
    • کنش خواندن ناموفق است. Cronet روش onFailed() را فراخوانی می‌کند و وضعیت نهایی درخواست ناموفق است.

نمودار زیر چرخه حیات شیء UrlRequest را نشان می‌دهد:

نمودار چرخه حیات درخواست Cronet
چرخه حیات درخواست Cronet

Legend
‫نماد راهنمای وضعیت اولیه Cronet وضعیت اولیه ‫نماد راهنمای وضعیت نهایی Cronet وضعیت نهایی
‫نماد راهنمای وضعیت انتقالی Cronet وضعیت انتقالی نماد راهنمای روش‌های فراخوانی Cronet روش فراخوانی
نماد راهنمای کنش کارخواه Cronet روش UrlRequest