ความสามารถในการสังเกตหมายถึงความสามารถของออบเจ็กต์ในการแจ้งเตือนผู้อื่นเกี่ยวกับการเปลี่ยนแปลงในข้อมูลของออบเจ็กต์ ไลบรารีการเชื่อมโยงข้อมูลช่วยให้คุณทำให้วัตถุ ฟิลด์ หรือคอลเล็กชันสังเกตได้
คุณสามารถใช้ออบเจ็กต์ใดก็ได้สำหรับการเชื่อมโยงข้อมูล แต่การแก้ไขออบเจ็กต์จะไม่ทำให้ UI อัปเดตโดยอัตโนมัติ คุณสามารถใช้การเชื่อมโยงข้อมูลเพื่อให้ความสามารถแก่ออบเจ็กต์ข้อมูลในการแจ้งเตือนออบเจ็กต์อื่นๆ (เรียกว่า Listener) เมื่อข้อมูลมีการเปลี่ยนแปลง คลาสที่สังเกตได้มี 3 ประเภท ได้แก่ ฟิลด์ คอลเล็กชัน และออบเจ็กต์
เมื่อออบเจ็กต์ข้อมูลที่ได้รับอนุญาตให้สังเกตพฤติกรรมผู้ใช้ได้รายการใดรายการหนึ่งเชื่อมโยงกับ UI และพร็อพเพอร์ตี้ของออบเจ็กต์ข้อมูลมีการเปลี่ยนแปลง UI จะอัปเดตโดยอัตโนมัติ
ช่องที่สังเกตได้
หากคลาสมีพร็อพเพอร์ตี้เพียงไม่กี่รายการ การสร้างคลาสที่ใช้อินเทอร์เฟซ Observable อาจไม่คุ้มค่า ในกรณีนี้ คุณสามารถใช้คลาส Observable ทั่วไปและคลาสเฉพาะพื้นฐานต่อไปนี้เพื่อทำให้ฟิลด์สังเกตได้
ObservableBooleanObservableByteObservableCharObservableShortObservableIntObservableLongObservableFloatObservableDoubleObservableParcelable
ฟิลด์ที่สังเกตได้คือออบเจ็กต์ที่สังเกตได้ในตัวซึ่งมีฟิลด์เดียว เวอร์ชันพื้นฐานจะหลีกเลี่ยงการทำ 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<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 ช่วยให้สามารถลงทะเบียน 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
บล็อกโพสต์
แนะนำสำหรับคุณ
- หมายเหตุ: ข้อความลิงก์จะแสดงเมื่อ JavaScript ปิดอยู่
- โมดูลสถานะที่บันทึกไว้สำหรับ ViewModel
- เชื่อมโยงมุมมองเลย์เอาต์กับคอมโพเนนต์สถาปัตยกรรม
- ภาพรวมของไลบรารี Paging