WorkManager আপনাকে কাজের একটি চেইন তৈরি করতে এবং সারিবদ্ধ করতে দেয় যা একাধিক নির্ভরশীল টাস্ক নির্দিষ্ট করে এবং সেগুলি কোন ক্রমে চালানো উচিত তা নির্ধারণ করে। এই ফাংশনটি বিশেষভাবে উপযোগী যখন আপনাকে একটি নির্দিষ্ট ক্রমে বেশ কয়েকটি টাস্ক রান করতে হয়।
কাজের একটি চেইন তৈরি করতে, আপনি
WorkManager.beginWith(OneTimeWorkRequest)
বা
WorkManager.beginWith(List<OneTimeWorkRequest>)
ব্যবহার করতে পারেন, যার প্রতিটি
WorkContinuation-এর একটি ইনস্ট্যান্স রিটার্ন করে।
তারপর, WorkContinuation ব্যবহার করে
then(OneTimeWorkRequest)
বা
then(List<OneTimeWorkRequest>)
ব্যবহার করে নির্ভরশীল OneTimeWorkRequest
ইনস্ট্যান্স যোগ করা যেতে পারে।
WorkContinuation.then(...)-এর প্রতিটি ইনভোকেশন WorkContinuation-এর একটি নতুন ইনস্ট্যান্স ফিরিয়ে দেয়। আপনি OneTimeWorkRequestটি ইনস্ট্যান্সের মধ্যে Listটি যোগ করলে, এইসব অনুরোধ সমান্তরালভাবে চলতে পারে।
সবশেষে, আপনি
WorkContinuation.enqueue()
পদ্ধতি ব্যবহার করে WorkContinuation-এর চেন enqueue() করতে পারবেন।
একটা উদাহরণ দেখা যাক। এই উদাহরণে, ৩টি আলাদা 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 ব্যবহার করে।
WorkManager-এর মাধ্যমে দুই ধরনের InputMerger প্রদান করা হয়:
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 হিসেবে চিহ্নিত করা হবে। আপনি আগে থেকে থাকা চেনের কাজ
আরও বাড়াতে চাইলে, ExistingWorkPolicy-এর
APPEND_OR_REPLACE দেখুন।
কাজের অনুরোধের চেন তৈরি করার সময়, নির্ভরশীল কাজের অনুরোধে আবার চেষ্টা করার নীতি উল্লেখ করতে হবে যাতে কাজ সবসময় সময়মতো সম্পূর্ণ হয়। কাজের অনুরোধ সম্পূর্ণ না হলে, চেইন অসম্পূর্ণ থেকে যেতে পারে এবং/অথবা অপ্রত্যাশিত পরিস্থিতি তৈরি হতে পারে।
আরও তথ্যের জন্য, কাজ বাতিল করা এবং বন্ধ করা দেখুন।