تشير إمكانية تتبّع البيانات إلى قدرة عنصر على إرسال إشعارات إلى عناصر أخرى بشأن التغييرات في بياناته. تتيح لك "مكتبة ربط البيانات" جعل العناصر أو الحقول أو المجموعات قابلة للتتبّع.
يمكنك استخدام أي كائن لربط البيانات، ولكن تعديل الكائن لا يؤدي تلقائيًا إلى تعديل واجهة المستخدم. يمكنك استخدام ربط البيانات لمنح كائنات البيانات القدرة على إعلام الكائنات الأخرى - المعروفة باسم المستمعين - عند تغيير بياناتها. هناك ثلاثة أنواع من الفئات القابلة للتتبّع: الحقول والمجموعات والعناصر.
عندما يكون أحد كائنات البيانات القابلة للتتبّع مرتبطًا بواجهة المستخدم وتتغيّر إحدى سمات كائن البيانات، يتم تعديل واجهة المستخدم تلقائيًا.
الحقول القابلة للملاحظة
إذا كانت فئاتك تحتوي على عدد قليل من السمات، قد لا يستحق الأمر عناء إنشاء فئات تنفّذ واجهة Observable. في هذه الحالة، يمكنك استخدام فئة Observable العامة والفئات التالية الخاصة بالأنواع الأساسية لجعل الحقول قابلة للتتبّع:
ObservableBooleanObservableByteObservableCharObservableShortObservableIntObservableLongObservableFloatObservableDoubleObservableParcelable
الحقول القابلة للملاحظة هي كائنات قابلة للملاحظة ومستقلة بذاتها وتحتوي على حقل واحد. تتجنب الإصدارات الأولية الملاكمة وإلغاء الملاكمة أثناء عمليات
الوصول. لاستخدام هذه الآلية، أنشئ سمة public final في لغة برمجة Java أو سمة للقراءة فقط في Kotlin، كما هو موضّح في المثال التالي:
Kotlin
class User { val firstName = ObservableField<String>() val lastName = ObservableField<String>() val age = ObservableInt() }
Java
private static class User { public final ObservableField<String> firstName = new ObservableField<>(); public final ObservableField<String> lastName = new ObservableField<>(); public final ObservableInt age = new ObservableInt(); }
للوصول إلى قيمة الحقل، استخدِم طريقتَي استرجاع البيانات
set() وget()
أو استخدِم بنية سمة
Kotlin:
Kotlin
user.firstName = "Google" val age = user.age
Java
user.firstName.set("Google"); int age = user.age.get();
المجموعات القابلة للتتبّع
تستخدم بعض التطبيقات هياكل ديناميكية للاحتفاظ بالبيانات. تتيح المجموعات القابلة للملاحظة
الوصول إلى هذه البُنى باستخدام مفتاح. تُعدّ الفئة ObservableArrayMap مفيدة عندما يكون المفتاح نوعًا مرجعيًا، مثل String، كما هو موضّح في المثال التالي:
Kotlin
ObservableArrayMap<String, Any>().apply { put("firstName", "Google") put("lastName", "Inc.") put("age", 17) }
Java
ObservableArrayMap<String, Object> user = new ObservableArrayMap<>(); user.put("firstName", "Google"); user.put("lastName", "Inc."); user.put("age", 17);
في التنسيق، يمكنك العثور على الخريطة باستخدام مفاتيح السلسلة، كما هو موضّح في المثال التالي:
<data>
<import type="android.databinding.ObservableMap"/>
<variable name="user" type="ObservableMap<String, Object>"/>
</data>
…
<TextView
android:text="@{user.lastName}"
android:layout_width="wrap_content"
android:layout_height="wrap_content"/>
<TextView
android:text="@{String.valueOf(1 + (Integer)user.age)}"
android:layout_width="wrap_content"
android:layout_height="wrap_content"/>
تكون الفئة ObservableArrayList مفيدة عندما يكون المفتاح عددًا صحيحًا، على النحو التالي:
Kotlin
ObservableArrayList<Any>().apply { add("Google") add("Inc.") add(17) }
Java
ObservableArrayList<Object> user = new ObservableArrayList<>(); user.add("Google"); user.add("Inc."); user.add(17);
في التنسيق، يمكنك الوصول إلى القائمة من خلال الفهارس، كما هو موضّح في المثال التالي:
<data>
<import type="android.databinding.ObservableList"/>
<import type="com.example.my.app.Fields"/>
<variable name="user" type="ObservableList<Object>"/>
</data>
…
<TextView
android:text='@{user[Fields.LAST_NAME]}'
android:layout_width="wrap_content"
android:layout_height="wrap_content"/>
<TextView
android:text='@{String.valueOf(1 + (Integer)user[Fields.AGE])}'
android:layout_width="wrap_content"
android:layout_height="wrap_content"/>
العناصر القابلة للتتبّع
تسمح الفئة التي تنفّذ واجهة Observable بتسجيل المستمعين الذين يريدون تلقّي إشعارات بشأن تغييرات الخصائص من الكائن القابل للملاحظة.
تحتوي واجهة Observable على آلية لإضافة المستمعين وإزالتهم، ولكن يمكنك
تحديد وقت إرسال الإشعارات. لتسهيل عملية التطوير، توفّر مكتبة ربط البيانات الفئة BaseObservable التي تنفّذ آلية تسجيل المستمع. تكون فئة البيانات التي تنفّذ
BaseObservable مسؤولة عن إرسال إشعار عند تغيير السمات. لإجراء ذلك، يمكنك تخصيص تعليق توضيحي Bindable لأسلوب getter واستدعاء أسلوب notifyPropertyChanged() في أسلوب setter، كما هو موضّح في المثال التالي:
Kotlin
class User : BaseObservable() { @get:Bindable var firstName: String = "" set(value) { field = value notifyPropertyChanged(BR.firstName) } @get:Bindable var lastName: String = "" set(value) { field = value notifyPropertyChanged(BR.lastName) } }
Java
private static class User extends BaseObservable { private String firstName; private String lastName; @Bindable public String getFirstName() { return this.firstName; } @Bindable public String getLastName() { return this.lastName; } public void setFirstName(String firstName) { this.firstName = firstName; notifyPropertyChanged(BR.firstName); } public void setLastName(String lastName) { this.lastName = lastName; notifyPropertyChanged(BR.lastName); } }
ينشئ ربط البيانات فئة باسم BR في حزمة الوحدة، والتي تحتوي على
أرقام تعريف الموارد المستخدمة لربط البيانات. ينشئ التعليق التوضيحي Bindable إدخالاً في ملف الفئة BR أثناء عملية التجميع. إذا تعذّر تغيير الصنف الأساسي لأصناف البيانات، يمكنك تنفيذ واجهة Observable باستخدام عنصر PropertyChangeRegistry لتسجيل المستمعين وإرسال الإشعارات إليهم بكفاءة.
العناصر التي تراعي مراحل النشاط
يمكن أيضًا ربط التنسيقات في تطبيقك بمصادر ربط البيانات التي تُعلم واجهة المستخدم تلقائيًا بالتغييرات في البيانات. بهذه الطريقة، تكون عمليات الربط مدركة لدورة الحياة ولا يتم تشغيلها إلا عندما تكون واجهة المستخدم مرئية على الشاشة.
يتيح ربط البيانات استخدام
StateFlow وLiveData. لمزيد من المعلومات حول
استخدام LiveData في ربط البيانات، يُرجى الاطّلاع على استخدام LiveData لإعلام واجهة المستخدم بالتغييرات في البيانات.
استخدام StateFlow
إذا كان تطبيقك يستخدم Kotlin مع coroutines، يمكنك استخدام عناصر StateFlow كمصدر لربط البيانات. لاستخدام عنصر StateFlow مع فئة الربط، حدِّد مالك مراحل النشاط لتحديد نطاق عنصر StateFlow. يحدّد المثال التالي النشاط على أنّه مالك دورة الحياة بعد إنشاء مثيل لفئة الربط:
class ViewModelActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
// Inflate view and obtain an instance of the binding class.
val binding: UserBinding = DataBindingUtil.setContentView(this, R.layout.user)
// Specify the current activity as the lifecycle owner.
binding.lifecycleOwner = this
}
}
كما هو موضّح في ربط طرق عرض التنسيق بمكوّنات البنية، تعمل ميزة "ربط البيانات" بسلاسة مع عناصر ViewModel. يمكنك استخدام StateFlow وViewModel معًا على النحو التالي:
class ScheduleViewModel : ViewModel() {
private val _username = MutableStateFlow<String>("")
val username: StateFlow<String> = _username
init {
viewModelScope.launch {
_username.value = Repository.loadUserName()
}
}
}
في التنسيق، يمكنك تخصيص سمات وطُرق عنصر ViewModel لطرق العرض المقابلة باستخدام تعبيرات الربط، كما هو موضّح في المثال التالي:
<TextView
android:id="@+id/name"
android:text="@{viewmodel.username}" />
يتم تعديل واجهة المستخدم تلقائيًا كلما تغيّرت قيمة اسم المستخدم.
إيقاف استخدام StateFlow
بالنسبة إلى التطبيقات التي تستخدم Kotlin وAndroidX، يتم تضمين دعم StateFlow تلقائيًا مع ربط البيانات. وهذا يعني أنّ تبعية الكوروتين يتم تضمينها تلقائيًا في تطبيقك إذا لم تكن التبعية متاحة من قبل.
يمكنك إيقاف هذه الوظيفة من خلال إضافة ما يلي إلى ملف build.gradle:
أنيق
android { ... dataBinding { addKtx = false } }
Kotlin
android { ... dataBinding { addKtx = false } }
بدلاً من ذلك، يمكنك إيقاف StateFlow بشكل عام في مشروعك من خلال إضافة السطر التالي إلى ملف gradle.properties:
أنيق
android.defaults.databinding.addKtx = false
Kotlin
android.defaults.databinding.addKtx = false
مراجع إضافية
لمزيد من المعلومات حول ربط البيانات، يُرجى الاطّلاع على المراجع الإضافية التالية:
نماذج
منشورات المدوّنات
التطبيقات المقترَحة لك
- ملاحظة: يتم عرض نص الرابط عندما يكون JavaScript غير مفعَّل
- وحدة الحالة المحفوظة لـ ViewModel
- ربط طرق عرض التنسيق بمكوّنات البنية
- نظرة عامة على مكتبة Paging