बाइंडिंग अडैप्टर, वैल्यू सेट करने के लिए सही फ़्रेमवर्क कॉल करने के लिए ज़िम्मेदार होते हैं. इसका एक उदाहरण है, प्रॉपर्टी की वैल्यू सेट करना. जैसे, setText() तरीके को कॉल करना. इसका एक और उदाहरण, इवेंट लिसनर सेट करना है. जैसे, setOnClickListener() तरीके को कॉल करना.
डेटा बाइंडिंग लाइब्रेरी की मदद से, वैल्यू सेट करने के लिए कॉल किए गए तरीके को तय किया जा सकता है. साथ ही, अपना बाइंडिंग लॉजिक दिया जा सकता है और अडैप्टर का इस्तेमाल करके, रिटर्न किए गए ऑब्जेक्ट का टाइप तय किया जा सकता है.
एट्रिब्यूट की वैल्यू सेट करना
जब भी बाउंड वैल्यू बदलती है, तो जनरेट की गई बाइंडिंग क्लास को बाइंडिंग एक्सप्रेशन के साथ व्यू पर सेटर मेथड को कॉल करना चाहिए. डेटा बाइंडिंग लाइब्रेरी को अपने-आप तरीका तय करने की अनुमति दी जा सकती है. इसके अलावा, तरीका साफ़ तौर पर बताया जा सकता है या तरीका चुनने के लिए कस्टम लॉजिक दिया जा सकता है.
अपने-आप तरीका चुनने की सुविधा
example नाम के एट्रिब्यूट के लिए, लाइब्रेरी अपने-आप setExample(arg) तरीका ढूंढ लेती है. यह तरीका, आर्ग्युमेंट के तौर पर काम करने वाले टाइप को स्वीकार करता है. एट्रिब्यूट के नेमस्पेस को ध्यान में नहीं रखा जाता. किसी तरीके को खोजते समय, सिर्फ़ एट्रिब्यूट के नाम और टाइप का इस्तेमाल किया जाता है.
उदाहरण के लिए, android:text="@{user.name}" एक्सप्रेशन के लिए, लाइब्रेरी setText(arg) मेथड को खोजती है. यह मेथड, user.getName() से मिले टाइप को स्वीकार करता है. अगर user.getName() का रिटर्न टाइप String है, तो लाइब्रेरी setText() मेथड को खोजती है, जो String आर्ग्युमेंट को स्वीकार करता है. अगर एक्सप्रेशन int दिखाता है, तो लाइब्रेरी setText() वाले तरीके को खोजती है, जो int आर्ग्युमेंट को स्वीकार करता है. एक्सप्रेशन से सही टाइप का डेटा मिलना चाहिए. ज़रूरत पड़ने पर, रिटर्न वैल्यू को कास्ट किया जा सकता है.
डेटा बाइंडिंग की सुविधा तब भी काम करती है, जब दिए गए नाम वाला कोई एट्रिब्यूट मौजूद न हो. डेटा बाइंडिंग का इस्तेमाल करके, किसी भी सेटर के लिए एट्रिब्यूट बनाए जा सकते हैं. उदाहरण के लिए, सहायता क्लास DrawerLayout में एट्रिब्यूट नहीं होते, लेकिन इसमें कई सेटर होते हैं. नीचे दिया गया लेआउट,
setScrimColor(int)
और
addDrawerListener(DrawerListener)
तरीकों का इस्तेमाल,
app:scrimColor और app:drawerListener
एट्रिब्यूट के लिए सेटर के तौर पर अपने-आप करता है:
<androidx.drawerlayout.widget.DrawerLayout
android:layout_width="wrap_content"
android:layout_height="wrap_content"
app:scrimColor="@{@color/scrim}"
app:drawerListener="@{fragment.drawerListener}">
कस्टम तरीके का नाम बताएं
कुछ एट्रिब्यूट में ऐसे सेटर होते हैं जिनके नाम मेल नहीं खाते. ऐसे मामलों में, BindingMethods एनोटेशन का इस्तेमाल करके, किसी एट्रिब्यूट को सेटर के साथ जोड़ा जा सकता है. एनोटेशन का इस्तेमाल किसी क्लास के साथ किया जाता है. इसमें एक से ज़्यादा BindingMethod एनोटेशन हो सकते हैं. इनमें से हर एनोटेशन, नाम बदले गए हर तरीके के लिए होता है. बाइंडिंग मेथड ऐसे एनोटेशन होते हैं जिन्हें आपके ऐप्लिकेशन की किसी भी क्लास में जोड़ा जा सकता है.
इस उदाहरण में, android:tint एट्रिब्यूट को setImageTintList(ColorStateList) तरीके से जोड़ा गया है, न कि setTint() तरीके से:
Kotlin
@BindingMethods(value = [ BindingMethod( type = android.widget.ImageView::class, attribute = "android:tint", method = "setImageTintList")])
Java
@BindingMethods({ @BindingMethod(type = "android.widget.ImageView", attribute = "android:tint", method = "setImageTintList"), })
आम तौर पर, आपको Android फ़्रेमवर्क क्लास में सेटर का नाम बदलने की ज़रूरत नहीं होती. एट्रिब्यूट पहले से ही लागू हैं. इसके लिए, नाम रखने के तरीके का इस्तेमाल किया जाता है, ताकि मैच करने वाले तरीके अपने-आप मिल जाएं.
कस्टम लॉजिक उपलब्ध कराना
कुछ एट्रिब्यूट के लिए, कस्टम बाइंडिंग लॉजिक की ज़रूरत होती है. उदाहरण के लिए, android:paddingLeft एट्रिब्यूट के लिए कोई सेटर नहीं है. इसके बजाय, setPadding(left,
top, right, bottom) तरीका उपलब्ध कराया गया है. BindingAdapter एनोटेशन वाले स्टैटिक बाइंडिंग अडैप्टर तरीके की मदद से, यह तय किया जा सकता है कि किसी एट्रिब्यूट के लिए सेटर को कैसे कॉल किया जाए.
Android फ़्रेमवर्क क्लास के एट्रिब्यूट में पहले से ही BindingAdapter एनोटेशन मौजूद होते हैं. यहां दिए गए उदाहरण में, paddingLeft एट्रिब्यूट के लिए बाइंडिंग अडैप्टर दिखाया गया है:
Kotlin
@BindingAdapter("android:paddingLeft") fun setPaddingLeft(view: View, padding: Int) { view.setPadding(padding, view.getPaddingTop(), view.getPaddingRight(), view.getPaddingBottom()) }
Java
@BindingAdapter("android:paddingLeft") public static void setPaddingLeft(View view, int padding) { view.setPadding(padding, view.getPaddingTop(), view.getPaddingRight(), view.getPaddingBottom()); }
पैरामीटर के टाइप अहम होते हैं. पहला पैरामीटर, एट्रिब्यूट से जुड़े व्यू का टाइप तय करता है. दूसरा पैरामीटर यह तय करता है कि दिए गए एट्रिब्यूट के लिए, बाइंडिंग एक्सप्रेशन में किस तरह का टाइप स्वीकार किया जाएगा.
बाइंडिंग अडैप्टर, अन्य तरह के कस्टमाइज़ेशन के लिए भी काम के होते हैं. उदाहरण के लिए, किसी इमेज को लोड करने के लिए, वर्कर थ्रेड से कस्टम लोडर को कॉल किया जा सकता है.
आपके पास ऐसे अडैप्टर भी हो सकते हैं जो कई एट्रिब्यूट को स्वीकार करते हैं. इसके बारे में यहां दिए गए उदाहरण में बताया गया है:
Kotlin
@BindingAdapter("imageUrl", "error") fun loadImage(view: ImageView, url: String, error: Drawable) { Picasso.get().load(url).error(error).into(view) }
Java
@BindingAdapter({"imageUrl", "error"}) public static void loadImage(ImageView view, String url, Drawable error) { Picasso.get().load(url).error(error).into(view); }
अपने लेआउट में अडैप्टर का इस्तेमाल किया जा सकता है, जैसा कि इस उदाहरण में दिखाया गया है. ध्यान दें कि @drawable/venueError आपके ऐप्लिकेशन में मौजूद किसी संसाधन के बारे में बताता है. संसाधन को @{} के साथ जोड़ने से, यह एक मान्य बाइंडिंग एक्सप्रेशन बन जाता है.
<ImageView app:imageUrl="@{venue.imageUrl}" app:error="@{@drawable/venueError}" />
अगर ImageView ऑब्जेक्ट के लिए, imageUrl और error का इस्तेमाल किया जाता है, तो अडैप्टर को कॉल किया जाता है. imageUrl एक स्ट्रिंग है और error एक Drawable है. अगर आपको कोई भी एट्रिब्यूट सेट होने पर अडैप्टर को कॉल करना है, तो अडैप्टर के वैकल्पिक requireAll फ़्लैग को false पर सेट करें. इसका उदाहरण यहां दिया गया है:
Kotlin
@BindingAdapter(value = ["imageUrl", "placeholder"], requireAll = false) fun setImageUrl(imageView: ImageView, url: String?, placeHolder: Drawable?) { if (url == null) { imageView.setImageDrawable(placeholder); } else { MyImageLoader.loadInto(imageView, url, placeholder); } }
Java
@BindingAdapter(value={"imageUrl", "placeholder"}, requireAll=false) public static void setImageUrl(ImageView imageView, String url, Drawable placeHolder) { if (url == null) { imageView.setImageDrawable(placeholder); } else { MyImageLoader.loadInto(imageView, url, placeholder); } }
बाइंडिंग अडैप्टर के तरीके, अपने हैंडलर में पुरानी वैल्यू ले सकते हैं. पुरानी और नई वैल्यू का इस्तेमाल करने वाले तरीके में, एट्रिब्यूट के लिए पहले सभी पुरानी वैल्यू का एलान करना ज़रूरी है. इसके बाद, नई वैल्यू का एलान करना ज़रूरी है. जैसा कि इस उदाहरण में दिखाया गया है:
Kotlin
@BindingAdapter("android:paddingLeft") fun setPaddingLeft(view: View, oldPadding: Int, newPadding: Int) { if (oldPadding != newPadding) { view.setPadding(newPadding, view.getPaddingTop(), view.getPaddingRight(), view.getPaddingBottom()) } }
Java
@BindingAdapter("android:paddingLeft") public static void setPaddingLeft(View view, int oldPadding, int newPadding) { if (oldPadding != newPadding) { view.setPadding(newPadding, view.getPaddingTop(), view.getPaddingRight(), view.getPaddingBottom()); } }
इवेंट हैंडलर का इस्तेमाल सिर्फ़ इंटरफ़ेस या ऐब्स्ट्रैक्ट क्लास के साथ किया जा सकता है. इनमें एक ऐब्स्ट्रैक्ट तरीका होता है, जैसा कि इस उदाहरण में दिखाया गया है:
Kotlin
@BindingAdapter("android:onLayoutChange") fun setOnLayoutChangeListener( view: View, oldValue: View.OnLayoutChangeListener?, newValue: View.OnLayoutChangeListener? ) { if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) { if (oldValue != null) { view.removeOnLayoutChangeListener(oldValue) } if (newValue != null) { view.addOnLayoutChangeListener(newValue) } } }
Java
@BindingAdapter("android:onLayoutChange") public static void setOnLayoutChangeListener(View view, View.OnLayoutChangeListener oldValue, View.OnLayoutChangeListener newValue) { if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) { if (oldValue != null) { view.removeOnLayoutChangeListener(oldValue); } if (newValue != null) { view.addOnLayoutChangeListener(newValue); } } }
अपने लेआउट में इस इवेंट हैंडलर का इस्तेमाल इस तरह करें:
<View android:onLayoutChange="@{() -> handler.layoutChanged()}"/>
जब किसी लिसनर के पास कई तरीके होते हैं, तो उसे कई लिसनर में बांटना ज़रूरी होता है.
उदाहरण के लिए,
View.OnAttachStateChangeListener
के दो तरीके हैं:
onViewAttachedToWindow(View)
और
onViewDetachedFromWindow(View).
लाइब्रेरी में दो इंटरफ़ेस होते हैं, ताकि एट्रिब्यूट और उनके हैंडलर के बीच अंतर किया जा सके:
Kotlin
// Translation from provided interfaces in Java: @TargetApi(Build.VERSION_CODES.HONEYCOMB_MR1) interface OnViewDetachedFromWindow { fun onViewDetachedFromWindow(v: View) } @TargetApi(Build.VERSION_CODES.HONEYCOMB_MR1) interface OnViewAttachedToWindow { fun onViewAttachedToWindow(v: View) }
Java
@TargetApi(VERSION_CODES.HONEYCOMB_MR1) public interface OnViewDetachedFromWindow { void onViewDetachedFromWindow(View v); } @TargetApi(VERSION_CODES.HONEYCOMB_MR1) public interface OnViewAttachedToWindow { void onViewAttachedToWindow(View v); }
एक लिसनर को बदलने से दूसरे पर असर पड़ सकता है. इसलिए, आपको एक ऐसे अडैप्टर की ज़रूरत होगी जो किसी एक एट्रिब्यूट या दोनों के लिए काम करे. एनोटेशन में requireAll को false पर सेट किया जा सकता है. इससे यह तय किया जा सकता है कि हर एट्रिब्यूट को बाइंडिंग एक्सप्रेशन असाइन करना ज़रूरी नहीं है. इसका उदाहरण यहां दिया गया है:
Kotlin
@BindingAdapter( "android:onViewDetachedFromWindow", "android:onViewAttachedToWindow", requireAll = false ) fun setListener(view: View, detach: OnViewDetachedFromWindow?, attach: OnViewAttachedToWindow?) { if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB_MR1) { val newListener: View.OnAttachStateChangeListener? newListener = if (detach == null && attach == null) { null } else { object : View.OnAttachStateChangeListener { override fun onViewAttachedToWindow(v: View) { attach.onViewAttachedToWindow(v) } override fun onViewDetachedFromWindow(v: View) { detach.onViewDetachedFromWindow(v) } } } val oldListener: View.OnAttachStateChangeListener? = ListenerUtil.trackListener(view, newListener, R.id.onAttachStateChangeListener) if (oldListener != null) { view.removeOnAttachStateChangeListener(oldListener) } if (newListener != null) { view.addOnAttachStateChangeListener(newListener) } } }
Java
@BindingAdapter({"android:onViewDetachedFromWindow", "android:onViewAttachedToWindow"}, requireAll=false) public static void setListener(View view, OnViewDetachedFromWindow detach, OnViewAttachedToWindow attach) { if (VERSION.SDK_INT >= VERSION_CODES.HONEYCOMB_MR1) { OnAttachStateChangeListener newListener; if (detach == null && attach == null) { newListener = null; } else { newListener = new OnAttachStateChangeListener() { @Override public void onViewAttachedToWindow(View v) { if (attach != null) { attach.onViewAttachedToWindow(v); } } @Override public void onViewDetachedFromWindow(View v) { if (detach != null) { detach.onViewDetachedFromWindow(v); } } }; } OnAttachStateChangeListener oldListener = ListenerUtil.trackListener(view, newListener, R.id.onAttachStateChangeListener); if (oldListener != null) { view.removeOnAttachStateChangeListener(oldListener); } if (newListener != null) { view.addOnAttachStateChangeListener(newListener); } } }
ऊपर दिया गया उदाहरण थोड़ा मुश्किल है, क्योंकि View क्लास, OnAttachStateChangeListener के लिए सेटर तरीके के बजाय, addOnAttachStateChangeListener() और removeOnAttachStateChangeListener() तरीकों का इस्तेमाल करती है.
android.databinding.adapters.ListenerUtil क्लास, इन लिसनर को ट्रैक करने में मदद करती है, ताकि उन्हें बाइंडिंग अडैप्टर से हटाया जा सके.
ऑब्जेक्ट कन्वर्ज़न
ऑब्जेक्ट अपने-आप कन्वर्ट होने की सुविधा
जब बाइंडिंग एक्सप्रेशन से Object मिलता है, तो लाइब्रेरी प्रॉपर्टी की वैल्यू सेट करने के लिए इस्तेमाल किया गया तरीका चुनती है. Object को चुने गए तरीके के पैरामीटर टाइप में कास्ट किया जाता है. यह व्यवहार उन ऐप्लिकेशन में सुविधाजनक होता है जो डेटा सेव करने के लिए, ObservableMap क्लास का इस्तेमाल करते हैं. जैसा कि इस उदाहरण में दिखाया गया है:
<TextView
android:text='@{userMap["lastName"]}'
android:layout_width="wrap_content"
android:layout_height="wrap_content" />
एक्सप्रेशन में मौजूद userMap ऑब्जेक्ट, एक वैल्यू दिखाता है. यह वैल्यू, setText(CharSequence) तरीके में मौजूद पैरामीटर टाइप में अपने-आप कास्ट हो जाती है. इस तरीके का इस्तेमाल, android:text एट्रिब्यूट की वैल्यू सेट करने के लिए किया जाता है. अगर पैरामीटर टाइप साफ़ तौर पर नहीं बताया गया है, तो एक्सप्रेशन में रिटर्न टाइप को कास्ट करें.
कस्टम कन्वर्ज़न
कुछ मामलों में, खास तरह के कन्वर्ज़न के बीच कस्टम कन्वर्ज़न की ज़रूरत होती है. उदाहरण के लिए, किसी व्यू के android:background एट्रिब्यूट के लिए Drawable की ज़रूरत होती है, लेकिन color वैल्यू एक पूर्णांक है. यहां दिए गए उदाहरण में, एक ऐसा एट्रिब्यूट दिखाया गया है जिसमें Drawable की उम्मीद की जाती है. हालांकि, इसके बजाय एक पूर्णांक दिया गया है:
<View
android:background="@{isError ? @color/red : @color/white}"
android:layout_width="wrap_content"
android:layout_height="wrap_content"/>
जब भी Drawable की उम्मीद हो और कोई पूर्णांक दिखाया जाए, तो int को ColorDrawable में बदलें.
कन्वर्ज़न के लिए,
BindingConversion
एनोटेशन के साथ स्टैटिक तरीके का इस्तेमाल करें, जैसा कि यहां बताया गया है:
Kotlin
@BindingConversion fun convertColorToDrawable(color: Int) = ColorDrawable(color)
Java
@BindingConversion public static ColorDrawable convertColorToDrawable(int color) { return new ColorDrawable(color); }
हालांकि, बाइंडिंग एक्सप्रेशन में दी गई वैल्यू टाइप एक जैसी होनी चाहिए. एक ही एक्सप्रेशन में अलग-अलग टाइप का इस्तेमाल नहीं किया जा सकता. जैसा कि इस उदाहरण में दिखाया गया है:
// The @drawable and @color represent different value types in the same
// expression, which causes a build error.
<View
android:background="@{isError ? @drawable/error : @color/white}"
android:layout_width="wrap_content"
android:layout_height="wrap_content"/>
अन्य संसाधन
डेटा बाइंडिंग के बारे में ज़्यादा जानने के लिए, यहां दिए गए लेख पढ़ें.
सैंपल
ब्लॉग पोस्ट
आपके लिए सुझाव
- ध्यान दें: JavaScript बंद होने पर, लिंक टेक्स्ट दिखता है
- डेटा बाइंडिंग लाइब्रेरी
- लेआउट और बाइंडिंग एक्सप्रेशन
- बाइंडिंग देखें