ทำงานกับออบเจ็กต์ข้อมูลที่เห็นได้

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

คุณสามารถใช้ออบเจ็กต์ใดก็ได้สำหรับการเชื่อมโยงข้อมูล แต่การแก้ไขออบเจ็กต์จะไม่ทำให้ UI อัปเดตโดยอัตโนมัติ คุณสามารถใช้การเชื่อมโยงข้อมูลเพื่อให้ความสามารถแก่ออบเจ็กต์ข้อมูลในการแจ้งเตือนออบเจ็กต์อื่นๆ (เรียกว่า Listener) เมื่อข้อมูลมีการเปลี่ยนแปลง คลาสที่สังเกตได้มี 3 ประเภท ได้แก่ ฟิลด์ คอลเล็กชัน และออบเจ็กต์

เมื่อออบเจ็กต์ข้อมูลที่ได้รับอนุญาตให้สังเกตพฤติกรรมผู้ใช้ได้รายการใดรายการหนึ่งเชื่อมโยงกับ UI และพร็อพเพอร์ตี้ของออบเจ็กต์ข้อมูลมีการเปลี่ยนแปลง UI จะอัปเดตโดยอัตโนมัติ

ช่องที่สังเกตได้

หากคลาสมีพร็อพเพอร์ตี้เพียงไม่กี่รายการ การสร้างคลาสที่ใช้อินเทอร์เฟซ Observable อาจไม่คุ้มค่า ในกรณีนี้ คุณสามารถใช้คลาส Observable ทั่วไปและคลาสเฉพาะพื้นฐานต่อไปนี้เพื่อทำให้ฟิลด์สังเกตได้

ฟิลด์ที่สังเกตได้คือออบเจ็กต์ที่สังเกตได้ในตัวซึ่งมีฟิลด์เดียว เวอร์ชันพื้นฐานจะหลีกเลี่ยงการทำ Boxing และ Unboxing ระหว่างการดำเนินการเข้าถึง หากต้องการใช้กลไกนี้ ให้สร้างพร็อพเพอร์ตี้ 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 ช่วยให้สามารถลงทะเบียน Listener ที่ต้องการรับการแจ้งเตือนการเปลี่ยนแปลงพร็อพเพอร์ตี้จากออบเจ็กต์ที่สังเกตได้

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

ออบเจ็กต์ที่รับรู้ถึงวงจรชีวิต

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

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

ใช้ 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}" />

UI จะอัปเดตโดยอัตโนมัติทุกครั้งที่ค่าชื่อของผู้ใช้มีการเปลี่ยนแปลง

ปิดใช้การรองรับ StateFlow

สำหรับแอปที่ใช้ Kotlin และ AndroidX ระบบจะรวมการรองรับ StateFlow ไว้กับการเชื่อมโยงข้อมูลโดยอัตโนมัติ ซึ่งหมายความว่าระบบจะรวมทรัพยากร Dependency ของ Coroutine ไว้ในแอปโดยอัตโนมัติหากทรัพยากร Dependency ยังไม่พร้อมใช้งาน

คุณเลือกไม่ใช้ฟังก์ชันนี้ได้โดยเพิ่มข้อความต่อไปนี้ลงในไฟล์ 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

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

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

ตัวอย่าง

Codelab

บล็อกโพสต์