استخدام عناصر البيانات القابلة للملاحظة

تشير إمكانية تتبّع البيانات إلى قدرة عنصر على إرسال إشعارات إلى عناصر أخرى بشأن التغييرات في بياناته. تتيح لك "مكتبة ربط البيانات" جعل العناصر أو الحقول أو المجموعات قابلة للتتبّع.

يمكنك استخدام أي كائن لربط البيانات، ولكن تعديل الكائن لا يؤدي تلقائيًا إلى تعديل واجهة المستخدم. يمكنك استخدام ربط البيانات لمنح كائنات البيانات القدرة على إعلام الكائنات الأخرى - المعروفة باسم المستمعين - عند تغيير بياناتها. هناك ثلاثة أنواع من الفئات القابلة للتتبّع: الحقول والمجموعات والعناصر.

عندما يكون أحد كائنات البيانات القابلة للتتبّع مرتبطًا بواجهة المستخدم وتتغيّر إحدى سمات كائن البيانات، يتم تعديل واجهة المستخدم تلقائيًا.

الحقول القابلة للملاحظة

إذا كانت فئاتك تحتوي على عدد قليل من السمات، قد لا يستحق الأمر عناء إنشاء فئات تنفّذ واجهة Observable. في هذه الحالة، يمكنك استخدام فئة Observable العامة والفئات التالية الخاصة بالأنواع الأساسية لجعل الحقول قابلة للتتبّع:

الحقول القابلة للملاحظة هي كائنات قابلة للملاحظة ومستقلة بذاتها وتحتوي على حقل واحد. تتجنب الإصدارات الأولية الملاكمة وإلغاء الملاكمة أثناء عمليات الوصول. لاستخدام هذه الآلية، أنشئ سمة 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&lt;String, Object&gt;"/>
</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&lt;Object&gt;"/>
</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
    }
}

كما هو موضّح في ربط طرق عرض التنسيق بمكوّنات البنية، تعمل ميزة &quot;ربط البيانات&quot; بسلاسة مع عناصر 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

مراجع إضافية

لمزيد من المعلومات حول ربط البيانات، يُرجى الاطّلاع على المراجع الإضافية التالية:

نماذج

منشورات المدوّنات