مراحل نشاط طلب Cronet

تعرَّف على دورة حياة الطلبات التي يتم إنشاؤها باستخدام Cronet وكيفية إدارتها باستخدام طرق رد الاتصال التي توفّرها المكتبة.

نظرة عامة على مراحل النشاط

تمثّل الفئة UrlRequest طلبات الشبكة التي تم إنشاؤها باستخدام مكتبة Cronet. من المهم فهم المفاهيم التالية لفهم دورة حياة UrlRequest:

الولايات
الحالة هي الوضع المحدّد الذي يكون فيه الطلب في وقت معيّن. UrlRequestتنتقل العناصر التي تم إنشاؤها باستخدام مكتبة Cronet عبر حالات مختلفة في دورة حياتها. تتضمّن دورة حياة الطلب حالة أولية وحالات انتقالية ونهائية متعددة.
UrlRequest طريقة
يمكن للعملاء استدعاء طرق معيّنة على كائنات UrlRequest حسب الحالة. تنقل الطرق الطلب من حالة إلى أخرى.
‫Callback طريقة
من خلال تنفيذ طرق فئة UrlRequest.Callback، يمكن لتطبيقك تلقّي آخر المعلومات عن مستوى تقدّم الطلب. يمكنك تنفيذ طرق رد الاتصال لطلب إجراءات عنصر UrlRequest التي تنقل مراحل النشاط من الحالة إلى أخرى.

توضّح القائمة التالية مسار دورة حياة UrlRequest:

  1. تكون دورة الحياة في الحالة بدء بعد أن يستدعي تطبيقك طريقة start().
  2. قد يرسل الخادم استجابة إعادة توجيه، ما يؤدي إلى نقل العملية إلى طريقة onRedirectReceived(). في هذه الطريقة، يمكنك اتخاذ أحد إجراءات العميل التالية:
    • اتّبِع عملية إعادة التوجيه باستخدام followRedirect(). تعيد هذه الطريقة الطلب إلى الحالة بدأ.
    • ألغِ الطلب باستخدام cancel(). تؤدي هذه الطريقة إلى نقل الطلب إلى طريقة onCanceled() حيث يمكن للتطبيق تنفيذ عمليات إضافية قبل انتقال الطلب إلى الحالة النهائية Canceled.
  3. بعد أن يتّبع التطبيق جميع عمليات إعادة التوجيه، يرسل الخادم عناوين الاستجابة وتستدعي Cronet طريقة onResponseStarted(). يكون الطلب في حالة في انتظار read()‎. يجب أن يستدعي التطبيق طريقة read() لمحاولة قراءة جزء من نص الاستجابة. بعد أن يطلب تطبيقك read()، يكون الطلب في حالة قيد القراءة، حيث تتوفر النتائج المحتملة التالية:
    • ينجح إجراء القراءة، وتتوفّر المزيد من البيانات. تستدعي Cronet طريقة onReadCompleted() ويكون الطلب في حالة في انتظار read()‎ مرة أخرى. يمكن للتطبيق استدعاء طريقة read() مرة أخرى لمواصلة قراءة نص الاستجابة. يمكن للتطبيق أيضًا إيقاف قراءة الطلب باستخدام طريقة cancel().
    • ينجح إجراء القراءة، ولا تتوفّر أي بيانات أخرى. تستدعي Cronet طريقة onSucceeded() ويكون الطلب في الحالة النهائية Succeeded.
    • تعذُّر تنفيذ إجراء القراءة تستدعي Cronet طريقة onFailed() وتكون الحالة النهائية للطلب هي تعذّر.

يوضّح المخطّط البياني التالي دورة حياة عنصر UrlRequest:

مخطّط بياني لدورة حياة طلب Cronet
دورة حياة طلب Cronet

Legend
الحالة الأولية لـ رمز وسيلة الإيضاح للحالة الأولية لـ Cronet الحالة النهائية: رمز وسيلة الإيضاح للحالة النهائية في Cronet
حالة انتقالية واحدة (رمز وسيلة الإيضاح للحالة الانتقالية في Cronet) طريقتا رد اتصال (رمز وسيلة الإيضاح لطُرق ردّ الاتصال في Cronet)
‫رمز وسيلة الإيضاح لإجراء عميل Cronet طريقة UrlRequest