קישור נתונים דו-כיווני

באמצעות קישור נתונים חד-כיווני, אפשר להגדיר ערך במאפיין ולהגדיר מאזין שמגיב לשינוי במאפיין הזה:

<CheckBox
    android:id="@+id/rememberMeCheckBox"
    android:checked="@{viewmodel.rememberMe}"
    android:onCheckedChanged="@{viewmodel.rememberMeChanged}"
/>

קישור נתונים דו-כיווני מספק קיצור דרך לתהליך הזה:

<CheckBox
    android:id="@+id/rememberMeCheckBox"
    android:checked="@={viewmodel.rememberMe}"
/>

הסימון @={}, שכולל את הסימן "=", מקבל שינויים בנתונים של המאפיין ומאזין לעדכוני משתמשים בו-זמנית.

כדי להגיב לשינויים בנתוני הגיבוי, אפשר להגדיר את משתנה הפריסה כהטמעה של Observable, בדרך כלל BaseObservable, ולהשתמש בהערה @Bindable, כמו שמוצג בקטע הקוד הבא:

Kotlin

class LoginViewModel : BaseObservable {
    // val data = ...

    @Bindable
    fun getRememberMe(): Boolean {
        return data.rememberMe
    }

    fun setRememberMe(value: Boolean) {
        // Avoids infinite loops.
        if (data.rememberMe != value) {
            data.rememberMe = value

            // React to the change.
            saveData()

            // Notify observers of a new value.
            notifyPropertyChanged(BR.remember_me)
        }
    }
}

Java

public class LoginViewModel extends BaseObservable {
    // private Model data = ...

    @Bindable
    public Boolean getRememberMe() {
        return data.rememberMe;
    }

    public void setRememberMe(Boolean value) {
        // Avoids infinite loops.
        if (data.rememberMe != value) {
            data.rememberMe = value;

            // React to the change.
            saveData();

            // Notify observers of a new value.
            notifyPropertyChanged(BR.remember_me);
        }
    }
}

מכיוון שה-getter method של המאפיין שניתן לקישור נקראת getRememberMe(), ה-setter method התואמת של המאפיין משתמשת באופן אוטומטי בשם setRememberMe().

מידע נוסף על השימוש ב-BaseObservable וב-@Bindable זמין במאמר עבודה עם אובייקטים של נתונים גלויים.

קישור נתונים דו-כיווני באמצעות מאפיינים מותאמים אישית

הפלטפורמה מספקת הטמעות של קישור נתונים דו-כיווני למאפיינים הדו-כיווניים הנפוצים ביותר ולמאזינים לשינויים, שבהם אתם יכולים להשתמש כחלק מהאפליקציה. אם אתם רוצים להשתמש בקישור נתונים דו-כיווני עם מאפיינים מותאמים אישית, אתם צריכים לעבוד עם ההערות @InverseBindingAdapter ו-@InverseBindingMethod.

לדוגמה, כדי להפעיל קישור נתונים דו-כיווני במאפיין "time" בתצוגה מותאמת אישית בשם MyView, מבצעים את השלבים הבאים:

  1. מוסיפים הערה ל-method שמגדירה את הערך הראשוני ומעדכנת כשהערך משתנה באמצעות @BindingAdapter:

    Kotlin

    @BindingAdapter("time")
    @JvmStatic fun setTime(view: MyView, newValue: Time) {
        // Important to break potential infinite loops.
        if (view.time != newValue) {
            view.time = newValue
        }
    }
    

    Java

    @BindingAdapter("time")
    public static void setTime(MyView view, Time newValue) {
        // Important to break potential infinite loops.
        if (view.time != newValue) {
            view.time = newValue;
        }
    }
    
  2. מוסיפים הערה ל-method שקורא את הערך מהתצוגה באמצעות @InverseBindingAdapter:

    Kotlin

    @InverseBindingAdapter("time")
    @JvmStatic fun getTime(view: MyView) : Time {
        return view.getTime()
    }
    

    Java

    @InverseBindingAdapter("time")
    public static Time getTime(MyView view) {
        return view.getTime();
    }
    

בשלב הזה, קישור הנתונים יודע מה לעשות כשהנתונים משתנים (הוא קורא ל-method שמסומן ב-@BindingAdapter) ולמה לקרוא כשמאפיין התצוגה משתנה (הוא קורא ל-InverseBindingListener). עם זאת, הוא לא יודע מתי או איך המאפיין משתנה.

כדי לעשות את זה, צריך להגדיר מאזין בתצוגה. הוא יכול להיות מאזין בהתאמה אישית שמשויך לתצוגה בהתאמה אישית, או אירוע כללי, כמו אובדן מיקוד או שינוי טקסט. מוסיפים את ההערה @BindingAdapter לשיטה שמגדירה את המאזין לשינויים במאפיין:

Kotlin

@BindingAdapter("app:timeAttrChanged")
@JvmStatic fun setListeners(
        view: MyView,
        attrChange: InverseBindingListener
) {
    // Set a listener for click, focus, touch, etc.
}

Java

@BindingAdapter("app:timeAttrChanged")
public static void setListeners(
        MyView view, final InverseBindingListener attrChange) {
    // Set a listener for click, focus, touch, etc.
}

המאזין כולל InverseBindingListener כפרמטר. משתמשים ב-InverseBindingListener כדי להודיע למערכת של קישור הנתונים שהמאפיין השתנה. לאחר מכן, המערכת יכולה להתחיל לקרוא לשיטה שסומנה באמצעות @InverseBindingAdapter.

בפועל, המאזין הזה כולל לוגיקה לא טריוויאלית, כולל מאזינים לכריכת נתונים חד-כיוונית. לדוגמה, אפשר לעיין במתאם לשינוי מאפיין הטקסט, TextViewBindingAdapter.

משתמשים שהשלימו המרות

אם צריך לעצב, לתרגם או לשנות את המשתנה שקשור לאובייקט View לפני שהוא מוצג, אפשר להשתמש באובייקט Converter.

לדוגמה, נניח שיש אובייקט EditText שמציג תאריך:

<EditText
    android:id="@+id/birth_date"
    android:text="@={Converter.dateToString(viewmodel.birthDate)}"
/>

המאפיין viewmodel.birthDate מכיל ערך מסוג Long, ולכן צריך להשתמש בממיר כדי לשנות את הפורמט שלו.

בגלל שמשתמשים בביטוי דו-כיווני, צריך גם ממיר הפוך כדי שהספרייה תדע איך להמיר את המחרוזת שהמשתמש סיפק בחזרה לסוג הנתונים התומך, במקרה הזה Long. כדי לעשות את זה, מוסיפים את ההערה @InverseMethod לאחד מהממירים, וגורמים להערה הזו להפנות לממיר ההפוך. דוגמה להגדרה הזו מופיעה בקטע הקוד הבא:

Kotlin

object Converter {
    @InverseMethod("stringToDate")
    @JvmStatic fun dateToString(
        view: EditText, oldValue: Long,
        value: Long
    ): String {
        // Converts long to String.
    }

    @JvmStatic fun stringToDate(
        view: EditText, oldValue: String,
        value: String
    ): Long {
        // Converts String to long.
    }
}

Java

public class Converter {
    @InverseMethod("stringToDate")
    public static String dateToString(EditText view, long oldValue,
            long value) {
        // Converts long to String.
    }

    public static long stringToDate(EditText view, String oldValue,
            String value) {
        // Converts String to long.
    }
}

לולאות אינסופיות באמצעות קישור נתונים דו-כיווני

חשוב להיזהר לא ליצור לולאות אינסופיות כשמשתמשים בקישור נתונים דו-כיווני. כשהמשתמש משנה מאפיין, מתבצעת קריאה ל-method שמסומן באמצעות @InverseBindingAdapter, והערך מוקצה למאפיין הגיבוי. הפעולה הזו תפעיל את ה-method עם ההערה @BindingAdapter, שתפעיל קריאה נוספת ל-method עם ההערה @InverseBindingAdapter, וכך הלולאה תימשך.

לכן, חשוב להשוות בין הערכים החדשים והישנים בשיטות שמסומנות באמצעות @BindingAdapter כדי למנוע לולאות אינסופיות.

מאפיינים דו-כיווניים

הפלטפורמה מספקת תמיכה מובנית בקישור נתונים דו-כיווני כשמשתמשים במאפיינים שבטבלה הבאה. כדי להבין איך הפלטפורמה מספקת את התמיכה הזו, אפשר לעיין בהטמעות של מתאמי הקישור המתאימים:

דרגה מאפיינים מתאם קישור
AdapterView android:selectedItemPosition
android:selection
AdapterViewBindingAdapter
CalendarView android:date CalendarViewBindingAdapter
CompoundButton android:checked CompoundButtonBindingAdapter
DatePicker android:year
android:month
android:day
DatePickerBindingAdapter
NumberPicker android:value NumberPickerBindingAdapter
RadioButton android:checkedButton RadioGroupBindingAdapter
RatingBar android:rating RatingBarBindingAdapter
SeekBar android:progress SeekBarBindingAdapter
TabHost android:currentTab TabHostBindingAdapter
TextView android:text TextViewBindingAdapter
TimePicker android:hour
android:minute
TimePickerBindingAdapter

מקורות מידע נוספים

כדי לקבל מידע נוסף על קישור נתונים, אפשר לעיין במקורות המידע הבאים.

דוגמאות

פוסטים בבלוגים