การเชื่อมโยงข้อมูลแบบ 2 ทาง

เมื่อใช้การเชื่อมโยงข้อมูลแบบทางเดียว คุณจะตั้งค่าในแอตทริบิวต์และตั้งค่า Listener ที่ตอบสนองต่อการเปลี่ยนแปลงในแอตทริบิวต์นั้นได้ ดังนี้

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

การเชื่อมโยงข้อมูลแบบ 2 ทางเป็นทางลัดสำหรับกระบวนการนี้ ดังนี้

<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 ของพร็อพเพอร์ตี้ที่เชื่อมโยงได้มีชื่อว่า getRememberMe() เมธอด Setter ที่เกี่ยวข้องของพร็อพเพอร์ตี้จึงใช้ชื่อ setRememberMe() โดยอัตโนมัติ

ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ BaseObservable และ @Bindable ได้ที่หัวข้อทำงานกับ ออบเจ็กต์ข้อมูลที่สังเกตได้

การเชื่อมโยงข้อมูลแบบ 2 ทางโดยใช้แอตทริบิวต์ที่กำหนดเอง

แพลตฟอร์มนี้มีการติดตั้งใช้งานการเชื่อมโยงข้อมูลแบบ 2 ทางสำหรับแอตทริบิวต์แบบ 2 ทางที่พบบ่อยที่สุดและ Listener การเปลี่ยนแปลง ซึ่งคุณสามารถใช้เป็นส่วนหนึ่งของแอปได้ หากต้องการใช้การเชื่อมโยงข้อมูลแบบ 2 ทางกับแอตทริบิวต์ที่กำหนดเอง คุณต้องใช้คำอธิบายประกอบ @InverseBindingAdapter และ @InverseBindingMethod

ตัวอย่างเช่น หากต้องการเปิดใช้การเชื่อมโยงข้อมูลแบบ 2 ทางในแอตทริบิวต์ "time" ในมุมมองที่กำหนดเองชื่อ MyView ให้ทำตามขั้นตอนต่อไปนี้

  1. ใส่คำอธิบายประกอบเมธอดที่ตั้งค่าเริ่มต้นและอัปเดตเมื่อค่าเปลี่ยนแปลงโดยใช้ @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. ใส่คำอธิบายประกอบเมธอดที่อ่านค่าจากมุมมองโดยใช้ @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();
    }
    

ณ จุดนี้ การเชื่อมโยงข้อมูลจะทราบสิ่งที่ต้องทำเมื่อข้อมูลมีการเปลี่ยนแปลง (โดยจะเรียกใช้เมธอดที่มีคำอธิบายประกอบเป็น @BindingAdapter) และสิ่งที่ต้องเรียกใช้เมื่อแอตทริบิวต์มุมมองมีการเปลี่ยนแปลง (โดยจะเรียกใช้ InverseBindingListener) อย่างไรก็ตาม การเชื่อมโยงข้อมูลจะไม่ทราบว่าแอตทริบิวต์มีการเปลี่ยนแปลงเมื่อใดหรืออย่างไร

ซึ่งคุณต้องตั้งค่า Listener ในมุมมอง ซึ่งอาจเป็น Listener ที่กำหนดเองซึ่งเชื่อมโยงกับมุมมองที่กำหนดเอง หรืออาจเป็นเหตุการณ์ทั่วไป เช่น การสูญเสียโฟกัสหรือการเปลี่ยนแปลงข้อความ เพิ่มคำอธิบายประกอบ @BindingAdapter ลงในเมธอดที่ตั้งค่า Listener สำหรับการเปลี่ยนแปลงในพร็อพเพอร์ตี้

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.
}

Listener จะมี InverseBindingListener เป็นพารามิเตอร์ คุณใช้ InverseBindingListener เพื่อบอกระบบการเชื่อมโยงข้อมูลว่าแอตทริบิวต์มีการเปลี่ยนแปลง จากนั้นระบบจะเริ่มเรียกใช้เมธอดที่มีคำอธิบายประกอบโดยใช้ @InverseBindingAdapter

ในทางปฏิบัติ Listener นี้มีตรรกะที่สำคัญบางอย่าง รวมถึง Listener สำหรับการเชื่อมโยงข้อมูลแบบทางเดียว ตัวอย่างเช่น ดูอะแดปเตอร์สำหรับการเปลี่ยนแปลงแอตทริบิวต์ข้อความ TextViewBindingAdapter

ผู้ทำ Conversion

หากตัวแปรที่เชื่อมโยงกับออบเจ็กต์ View ต้องได้รับการจัดรูปแบบ แปล หรือเปลี่ยนแปลงก่อนที่จะแสดง คุณสามารถใช้ออบเจ็กต์ Converter ได้

ตัวอย่างเช่น ลองดูออบเจ็กต์ EditText ที่แสดงวันที่ต่อไปนี้

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

แอตทริบิวต์ viewmodel.birthDate มีค่าประเภท Long จึงต้องจัดรูปแบบโดยใช้ตัวแปลง

เนื่องจากมีการใช้นิพจน์แบบ 2 ทาง จึงต้องมีตัวแปลงผกผันเพื่อให้ไลบรารีทราบวิธีแปลงสตริงที่ผู้ใช้ระบุกลับเป็นประเภทข้อมูลสำรอง ซึ่งในกรณีนี้คือ 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.
    }
}

ลูปไม่สิ้นสุดที่ใช้การเชื่อมโยงข้อมูลแบบ 2 ทาง

โปรดระวังอย่าให้เกิดลูปไม่สิ้นสุดเมื่อใช้การเชื่อมโยงข้อมูลแบบ 2 ทาง เมื่อผู้ใช้เปลี่ยนแอตทริบิวต์ ระบบจะเรียกใช้เมธอดที่มีคำอธิบายประกอบโดยใช้ @InverseBindingAdapter และกำหนดค่าให้กับพร็อพเพอร์ตี้สำรอง ซึ่งจะเรียกใช้เมธอดที่มีคำอธิบายประกอบโดยใช้ @BindingAdapter ซึ่งจะทริกเกอร์การเรียกใช้เมธอดที่มีคำอธิบายประกอบโดยใช้ @InverseBindingAdapter อีกครั้ง และวนซ้ำไปเรื่อยๆ

ด้วยเหตุนี้ คุณจึงต้องหยุดการวนซ้ำที่อาจเกิดขึ้นไม่สิ้นสุดโดยการเปรียบเทียบค่าใหม่และค่าเก่าในเมธอดที่มีคำอธิบายประกอบโดยใช้ @BindingAdapter

แอตทริบิวต์แบบ 2 ทาง

แพลตฟอร์มนี้รองรับการเชื่อมโยงข้อมูลแบบ 2 ทางในตัวเมื่อคุณใช้แอตทริบิวต์ในตารางต่อไปนี้ ดูรายละเอียดเกี่ยวกับวิธีที่แพลตฟอร์มให้การสนับสนุนนี้ได้ที่การติดตั้งใช้งานสำหรับอะแดปเตอร์การเชื่อมโยงที่เกี่ยวข้อง ดังนี้

ชั้น แอตทริบิวต์ อะแดปเตอร์การเชื่อมโยง
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

แหล่งข้อมูลเพิ่มเติม

ดูข้อมูลเพิ่มเติมเกี่ยวกับการเชื่อมโยงข้อมูลได้ที่แหล่งข้อมูลเพิ่มเติมต่อไปนี้

ตัวอย่าง

Codelab

บล็อกโพสต์