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