एडॉप्टर में MVVM और तत्वों का चयन

पहले से ही तीसरे स्व-लिखित एडेप्टर के बारे में, जिसमें चयनित तत्व को याद रखने के तर्क को लागू करना आवश्यक था, मेरे पास विचार थे कि कुछ समाधान होना चाहिए जिसमें पहले से ही आवश्यक सब कुछ शामिल हो। विशेष रूप से अगर विकास प्रक्रिया के दौरान आपको कई विकल्पों के लिए केवल एक आइटम का चयन करने की क्षमता बदलनी पड़े।

एमवीवीएम दृष्टिकोण का अध्ययन करने और इसमें पूरी तरह से डूबने के बाद, उपर्युक्त प्रश्न अधिक स्पष्ट रूप से उभरा। इसके अलावा, एडॉप्टर स्वयं View स्तर पर है, जबकि चयनित तत्वों के बारे में जानकारी अक्सर ViewModel लिए अत्यंत आवश्यक है।

शायद मैंने इंटरनेट पर जवाब खोजने के लिए पर्याप्त समय नहीं बिताया, लेकिन, किसी भी मामले में, मुझे तैयार समाधान नहीं मिला। हालांकि, एक परियोजना में मैं एक कार्यान्वयन विचार के साथ आया था जो अच्छी तरह से सार्वभौमिक हो सकता है, इसलिए मैं इसे साझा करना चाहता था।

रिमार्क । हालाँकि यह Android पर MVVM के लिए तार्किक और उपयुक्त होगा, LiveData साथ एक कार्यान्वयन किया जा LiveData , इस स्तर पर मैं इसका उपयोग करके कोड लिखने के लिए तैयार नहीं हूँ। तो यह केवल भविष्य के लिए है। लेकिन अंतिम समाधान Android निर्भरताओं के बिना निकला, जो संभवतः किसी भी प्लेटफ़ॉर्म पर इसका उपयोग करना संभव बनाता है जहां कोटलिन काम कर सकता है।

SelectionManager

इस समस्या को हल करने के लिए, सामान्य SelectionManager इंटरफ़ेस संकलित किया गया था:

 interface SelectionManager { fun clearSelection() fun selectPosition(position: Int) fun isPositionSelected(position: Int): Boolean fun registerSelectionChangeListener(listener: (position: Int, isSelected: Boolean) -> Unit): Disposable fun getSelectedPositions(): ArrayList<Int> fun isAnySelected(): Boolean fun addSelectionInterceptor(interceptor: (position: Int, isSelected: Boolean, callback: () -> Unit) -> Unit): Disposable } 

डिफ़ॉल्ट रूप से, पहले से ही 3 अलग-अलग कार्यान्वयन हैं:

• MultipleSelection - ऑब्जेक्ट आपको सूची में से कई तत्वों को चुनने की अनुमति देता है;
• SingleSelection - एक ऑब्जेक्ट आपको केवल एक तत्व का चयन करने की अनुमति देता है;
• NoneSelection भी नहीं - वस्तु बिल्कुल भी तत्वों का चयन करने की अनुमति नहीं देती है।

संभवतः, बाद वाले के साथ सभी प्रश्न होंगे, इसलिए मैं पहले से ही एक उदाहरण पर दिखाने की कोशिश करूंगा।

अनुकूलक

यह एडेप्टर के लिए SelectionManager ऑब्जेक्ट को कंस्ट्रक्टर के माध्यम से निर्भरता के रूप में जोड़ने वाला है।

 class TestAdapter(private val selectionManager: SelectionManager) : RecyclerView.Adapter<TestHolder>() { //class body } 

उदाहरण में, मैं किसी तत्व पर क्लिक को संसाधित करने के तर्क से परेशान नहीं होऊंगा, इसलिए हम बस इस बात से सहमत हैं कि धारक (विवरण के बिना) क्लिक श्रोता की नियुक्ति के लिए पूरी तरह से जिम्मेदार है।

 class TestHolder(itemView: View) : RecyclerView.ViewHolder(itemView) { fun bind(item: Any, onItemClick: () -> Unit) { //all bind logic } } 

आगे, इस जादू के काम करने के लिए, एडेप्टर को निम्नलिखित 3 चरण करने होंगे:

1. onBindViewHolder

धारक की bind विधि के लिए एक कॉलबैक पास करें, जो प्रदर्शित तत्व के लिए selectionManager.selectPosition(position) को कॉल करेगा। यहां भी, आपको सबसे अधिक संभावना है कि डिस्प्ले को बदलना होगा (सबसे अधिक बार केवल पृष्ठभूमि) इस बात पर निर्भर करता है कि आइटम वर्तमान में चुना गया है - आप इसके लिए selectionManager.isPositionSelected(position) को कॉल कर सकते हैं।

 override fun onBindViewHolder(holder: TestHolder, position: Int) { val isItemSelected = selectionManager.isPositionSelected(position) //do whatever you need depending on `isItemSelected` value val item = ... //get current item by `position` value holder.bind(item) { selectionManager.selectPosition(position) } } 

2. registerSelectionChangeListener

एडेप्टर के लिए दबाए गए तत्वों को समय पर अद्यतन करने के लिए, आपको उचित कार्रवाई की सदस्यता लेनी चाहिए। और यह मत भूलो कि सदस्यता विधि द्वारा लौटाया गया परिणाम सहेजा जाना चाहिए।

 private val selectionDisposable = selectionManager.registerSelectionChangeListener { position, isSelected -> notifyItemChanged(position) } 

मैं ध्यान देता हूं कि इस मामले में isSelected पैरामीटर isSelected मान महत्वपूर्ण नहीं है, क्योंकि किसी भी परिवर्तन के साथ तत्व में परिवर्तन होता है। लेकिन कुछ भी आपको अतिरिक्त प्रसंस्करण को जोड़ने से रोकता है, जिसके लिए यह मूल्य महत्वपूर्ण है।

3. selectionDisposable

पिछले चरण में, मैंने सिर्फ यह नहीं कहा था कि विधि के परिणाम को बचाया जाना चाहिए - एक वस्तु लौटा दी जाती है जो लीक से बचने के लिए सदस्यता को साफ करती है। काम खत्म करने के बाद, इस वस्तु से परामर्श किया जाना चाहिए।

 fun destroy() { selectionDisposable.dispose() } 

ViewModel

जादू के एडाप्टर के लिए पर्याप्त है, हम ViewModel को पास करेंगे। SelectionManager शुरुआत बेहद सरल है:

 class TestViewModel: ViewModel() { val selectionManager: SelectionManager = SingleSelection() } 

यहां, एडॉप्टर के साथ सादृश्य द्वारा, आप परिवर्तनों को सब्सक्राइब कर सकते हैं (उदाहरण के लिए, "डिलीट" बटन को दुर्गम बनाने के लिए जब कोई आइटम नहीं चुने जाते हैं), लेकिन आप सभी चयनितों की सूची प्राप्त करने के लिए एक सारांश बटन (उदाहरण के लिए, "चयनित डाउनलोड करें") पर भी क्लिक कर सकते हैं। ।

 fun onDownloadClick() { val selectedPositions: ArrayList<Int> = selectionManager.getSelectedPositions() ... } 

और यहाँ मेरे समाधान का एक मंत्र सामने आता है: वर्तमान स्तर पर, वस्तु केवल तत्वों के पदों को संग्रहीत करने में सक्षम है। यही है, बिल्कुल चयनित वस्तुओं को प्राप्त करने के लिए, और उनके पदों पर नहीं, एडेप्टर से जुड़े डेटा स्रोत का उपयोग करके अतिरिक्त तर्क की आवश्यकता होगी (अफसोस, अब तक केवल)। लेकिन उम्मीद है कि आप इसे संभाल सकते हैं।

इसके अलावा यह केवल एडेप्टर को व्यू मॉडल से जोड़ने के लिए रहता है। यह पहले से ही गतिविधि स्तर पर है।

 class TestActivity: AppCompatActivity() { private lateinit var adapter: TestAdapter private lateinit var viewModel: TestViewModel override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) //`TestViewModel` initialization adapter = TestAdapter(viewModel.selectionManager) } } 

लचीलापन

कुछ के लिए, यह काफी समझ में आ सकता है, लेकिन मैं इसके अतिरिक्त ध्यान देना चाहता हूं कि इस कार्यान्वयन के साथ एडेप्टर में चयन विधि को नियंत्रित करना आसान हो जाता है। अब एडॉप्टर केवल एक तत्व का चयन कर सकता है, लेकिन यदि TestViewModel में selectionManager TestViewModel संपत्ति के आरंभीकरण को TestViewModel , तो बाकी कोड बिना किसी बदलाव की आवश्यकता के "नए तरीके से" काम करेंगे। यही है, val selectionManager: SelectionManager = MultipleSelection() सेट करें val selectionManager: SelectionManager = MultipleSelection() , और अब एडेप्टर आपको जितने चाहें उतने तत्वों का चयन करने की अनुमति देता है।

और यदि आपके पास पूरे आवेदन के लिए किसी प्रकार का आधार एडाप्टर वर्ग है, तो आप SelectionManager को उसी तरह से शामिल करने से डर नहीं सकते। वास्तव में, विशेष रूप से NoneSelection लिए जो तत्वों की पसंद का बिल्कुल भी मतलब नहीं रखते हैं, NoneSelection कार्यान्वयन है - कोई फर्क नहीं पड़ता कि आप इसके साथ क्या करते हैं, इसमें चयनित तत्व कभी नहीं होंगे और किसी भी श्रोता को कभी नहीं NoneSelection । नहीं, वह अपवादों को नहीं फेंकता है - वह बस सभी कॉलों की अनदेखी करता है, लेकिन एडॉप्टर को यह जानने की आवश्यकता नहीं है।

इंटरसेप्टर

ऐसे मामले भी हैं जिनमें एक तत्व की पसंद को बदलने के लिए अतिरिक्त संचालन (उदाहरण के लिए, विस्तृत जानकारी लोड करना) के साथ है, जब तक कि सफल परिवर्तन को लागू करने से एक गलत स्थिति नहीं हो जाती। विशेष रूप से इन मामलों के लिए, मैंने एक अवरोधन तंत्र जोड़ा।

इंटरसेप्टर को जोड़ने के लिए, आपको ऐड addSelectionInterceptor विधि को कॉल करने की आवश्यकता है (फिर से, आपको परिणाम को बचाने और पूरा होने के बाद इसे एक्सेस करने की आवश्यकता है)। callback: () -> Unit उदाहरण में इंटरसेप्टर के मापदंडों में से एक callback: () -> Unit - जब तक यह नहीं कहा जाता है, तब तक परिवर्तन लागू नहीं किया जाएगा। अर्थात्, नेटवर्क की अनुपस्थिति में, सर्वर से विस्तृत जानकारी को लोड करना सफलतापूर्वक पूरा नहीं किया जा सकता है, तदनुसार, उपयोग किए गए selectionManager प्रबंधक की स्थिति नहीं बदलेगी। यदि यह ठीक वही व्यवहार है जिसके लिए आप प्रयास कर रहे हैं - आपको इस विधि की आवश्यकता है।

 val interceptionDisposable = selectionManager.addSelectionInterceptor { position: Int, isSelected: Boolean, callback: () -> Unit -> if(isSelected) { val selectedItem = ... //get current item by `position` value val isDataLoadingSuccessful: Boolean = ... //download data for `selectedItem` if(isDataLoadingSuccessful) { callback() } } } 

यदि आवश्यक हो, तो आप जितने चाहें उतने इंटरसेप्टर कनेक्ट कर सकते हैं। इस स्थिति में, पहले इंटरसेप्टर का callback() कॉल दूसरे को संसाधित करना शुरू कर देता है। और उनमें से केवल callback() अंतिम रूप से selectionManager स्थिति में बदलाव का कारण होगा।

संभावनाओं

1. Disposable को साफ करने के लिए Disposable का उपयोग करना प्रभावी है, लेकिन LiveData जितना सुविधाजनक नहीं है। लाइन पर पहला सुधार अधिक सुविधाजनक काम के लिए android.arch.lifecycle की क्षमताओं का उपयोग करना है। सबसे अधिक संभावना है, यह एक अलग परियोजना होगी, इसलिए वर्तमान पर प्लेटफॉर्म की निर्भरता को जोड़ने के लिए नहीं।
2. जैसा कि मैंने कहा, चयनित वस्तुओं की सूची प्राप्त करना असुविधाजनक है। मैं एक ऑब्जेक्ट को लागू करने का प्रयास करना चाहता हूं जो उसी तरह से डेटा कंटेनर के साथ काम कर सकता है। उसी समय, यह एडॉप्टर के लिए डेटा स्रोत हो सकता है।

संदर्भ

आप लिंक पर स्रोत कोड पा सकते हैं - GitHub
यह परियोजना ru.ircover.selectionmanager:core:1.0.0 - ru.ircover.selectionmanager:core:1.0.0 माध्यम से कार्यान्वयन के लिए भी उपलब्ध है