تتيح لك واجهة WorkManager إنشاء سلسلة من الأعمال وإدراجها في قائمة انتظار، وتحدّد هذه السلسلة مهامًا متعددة تابعة لبعضها وتحدّد ترتيب تشغيلها. هذه الوظيفة مفيدة بشكل خاص عندما تحتاج إلى تشغيل عدة مهام بترتيب معين.
لإنشاء سلسلة من المهام، يمكنك استخدام
WorkManager.beginWith(OneTimeWorkRequest)
أو
WorkManager.beginWith(List<OneTimeWorkRequest>)
، حيث يعرض كل منهما مثيلاً من
WorkContinuation.
يمكن بعد ذلك استخدام WorkContinuation لإضافة مثيلات OneTimeWorkRequest تابعة باستخدام then(OneTimeWorkRequest) أو then(List<OneTimeWorkRequest>).
يؤدي كل استدعاء لـ WorkContinuation.then(...) إلى عرض مثيل جديد من WorkContinuation. إذا أضفت List من مثيلات OneTimeWorkRequest، يمكن تشغيل هذه الطلبات بالتوازي.
أخيرًا، يمكنك استخدام الطريقة
WorkContinuation.enqueue()
لـ enqueue() سلسلة WorkContinuation.
لنلقِ نظرة على أحد الأمثلة. في هذا المثال، تم إعداد 3 مهام مختلفة لـ Worker ليتم تنفيذها (ربما بالتوازي). يتم بعد ذلك دمج نتائج هذه العمال وتمريرها إلى وظيفة عامل التخزين المؤقت. أخيرًا، يتم تمرير مخرجات هذه المهمة إلى عامل تحميل، والذي يقوم بتحميل النتائج إلى خادم بعيد.
WorkManager.getInstance(myContext) // Candidates to run in parallel. .beginWith(listOf(plantName1, plantName2, plantName3)) // Dependent work (only runs after all previous work in chain). .then(cache) .then(upload) // Call enqueue to kick things off. .enqueue()
عمليات الدمج الواردة
عند ربط مثيلات OneTimeWorkRequest، يتم تمرير ناتج طلبات العمل الرئيسية كمدخلات إلى الطلبات الفرعية. في المثال أعلاه، سيتم تمرير نتائج plantName1 وplantName2 وplantName3 كمدخلات لطلب cache.
لإدارة المدخلات من طلبات عمل رئيسية متعددة، يستخدم WorkManager
InputMerger.
هناك نوعان مختلفان من InputMerger يوفّرهما WorkManager:
OverwritingInputMergerيحاول إضافة جميع المفاتيح من جميع المدخلات إلى المخرجات. في حال حدوث تعارض، يتم استبدال المفاتيح التي تم ضبطها سابقًا.ArrayCreatingInputMergerتحاول دمج المدخلات، وإنشاء مصفوفات عند الضرورة.
إذا كانت لديك حالة استخدام أكثر تحديدًا، يمكنك كتابة الحالة الخاصة بك عن طريق إنشاء فئة فرعية من
InputMerger.
OverwritingInputMerger
OverwritingInputMerger هي طريقة الدمج التلقائية. إذا كانت هناك تعارضات في المفاتيح في عملية الدمج، فستحل أحدث قيمة للمفتاح محل أي إصدارات سابقة في بيانات الإخراج الناتجة.
على سبيل المثال، إذا كانت مدخلات المصنع تحتوي كل منها على مفتاح يطابق أسماء المتغيرات الخاصة بها ("plantName1" و"plantName2" و"plantName3")، فإن البيانات التي تم تمريرها إلى عامل cache ستحتوي على ثلاثة أزواج من المفاتيح والقيم.
في حال حدوث تعارض، فإنّ آخر عامل يكمل "يفوز"، ويتم تمرير قيمته إلى cache.
بما أنّ طلبات العمل يتم تنفيذها بالتوازي، لا يمكننا ضمان
ترتيب تنفيذها. في المثال أعلاه، يمكن أن يحمل plantName1
قيمة إما "tulip" أو "elm"، اعتمادًا على القيمة التي تمت كتابتها
أخيرًا. إذا كان هناك احتمال لحدوث تعارض في المفاتيح وكنت بحاجة إلى الاحتفاظ بجميع بيانات
المخرجات في عملية دمج، فقد يكون ArrayCreatingInputMerger خيارًا أفضل.
ArrayCreatingInputMerger
في المثال أعلاه، بما أنّنا نريد الاحتفاظ بالمخرجات من جميع عمال أسماء النباتات، يجب استخدام ArrayCreatingInputMerger.
val cache: OneTimeWorkRequest = OneTimeWorkRequestBuilder<PlantWorker>() .setInputMerger(ArrayCreatingInputMerger::class) .setConstraints(constraints) .build()
يقرن ArrayCreatingInputMerger كل مفتاح بمصفوفة. إذا كان كل مفتاح فريدًا، ستكون النتيجة سلسلة من المصفوفات التي تحتوي على عنصر واحد.
في حال حدوث أي تعارضات في المفاتيح، يتم تجميع أي قيم مقابلة معًا في مصفوفة.
حالات التسلسل والعمل
يتم تنفيذ سلاسل OneTimeWorkRequest بشكل تسلسلي طالما أنّ عملها
يكتمل بنجاح (أي أنّها تعرض Result.success()). قد يتعذّر تنفيذ طلبات العمل
أو يتم إلغاؤها أثناء التشغيل، ما يؤدي إلى تأثيرات لاحقة في
طلبات العمل التابعة.
عندما تتم إضافة أول OneTimeWorkRequest إلى قائمة الانتظار في سلسلة من طلبات العمل، يتم حظر جميع طلبات العمل اللاحقة إلى أن يكتمل عمل طلب العمل الأول.
بعد إضافة طلبات العمل إلى قائمة الانتظار واستيفاء جميع قيود العمل، يبدأ تنفيذ طلب العمل الأول. إذا تم إكمال العمل بنجاح في الجذر
OneTimeWorkRequest أو List<OneTimeWorkRequest> (أي أنّه يعرض
Result.success())، سيتم وضع المجموعة التالية من طلبات العمل التابعة في قائمة الانتظار.
طالما أنّ كل طلب عمل يكتمل بنجاح، يتم نشر هذا النمط نفسه من خلال بقية سلسلة طلبات العمل حتى يكتمل كل العمل في السلسلة. على الرغم من أنّ هذه هي الحالة الأبسط والمفضّلة في كثير من الأحيان، إلا أنّ حالات الخطأ لا تقل أهمية في التعامل معها.
عند حدوث خطأ أثناء معالجة أحد العمال لطلب العمل، يمكنك إعادة محاولة هذا الطلب وفقًا لسياسة التراجع التي تحددها. تعني إعادة محاولة طلب يشكّل جزءًا من سلسلة أنّه ستتم إعادة محاولة هذا الطلب فقط باستخدام بيانات الإدخال المقدَّمة له. ولن يتأثر أي عمل يتم تنفيذه بالتوازي.
لمزيد من المعلومات حول تحديد استراتيجيات إعادة المحاولة المخصّصة، يُرجى الاطّلاع على سياسة إعادة المحاولة والتراجع.
إذا كانت سياسة إعادة المحاولة غير محدّدة أو تم استنفادها، أو إذا وصلت إلى حالة معينة يعرض فيها OneTimeWorkRequest القيمة Result.failure()، يتم وضع علامة FAILED. على طلب العمل هذا وجميع طلبات العمل التابعة له.
ينطبق المنطق نفسه عند إلغاء OneTimeWorkRequest. يتم أيضًا وضع علامة CANCELLED على أي طلبات عمل تابعة ولن يتم تنفيذها.
يُرجى العِلم أنّه في حال إلحاق المزيد من طلبات العمل بسلسلة تعذّر تنفيذها أو
تم إلغاء طلبات العمل فيها، سيتم أيضًا وضع علامة FAILED أو CANCELLED على طلب العمل المُلحَق حديثًا،
على التوالي. إذا أردت تمديد عمل سلسلة حالية، يمكنك الاطّلاع على APPEND_OR_REPLACE في ExistingWorkPolicy.
عند إنشاء سلاسل من طلبات العمل، يجب أن تحدّد طلبات العمل التابعة سياسات إعادة المحاولة لضمان إكمال العمل دائمًا في الوقت المناسب. قد تؤدي طلبات العمل التي تعذّر تنفيذها إلى سلاسل غير مكتملة و/أو حالة غير متوقعة.
لمزيد من المعلومات، يُرجى الاطّلاع على إلغاء العمل وإيقافه.