Lớp liên kết được tạo

Thư viện liên kết dữ liệu tạo ra các lớp liên kết mà bạn có thể dùng để truy cập vào các biến và thành phần hiển thị của bố cục. Tài liệu này hướng dẫn cách tạo và tuỳ chỉnh các lớp liên kết được tạo.

Lớp liên kết được tạo sẽ liên kết các biến bố cục với các thành phần hiển thị trong bố cục. Bạn có thể tuỳ chỉnh tên và gói của liên kết. Tất cả các lớp liên kết được tạo đều kế thừa từ lớp ViewDataBinding.

Một lớp liên kết được tạo cho mỗi tệp bố cục. Theo mặc định, tên của lớp là tên của tệp bố cục được chuyển đổi thành Pascal case và có thêm hậu tố Binding. Ví dụ: nếu tên tệp bố cục là activity_main.xml, thì lớp được tạo tương ứng là ActivityMainBinding. Lớp này chứa tất cả các liên kết từ thuộc tính bố cục đến thành phần hiển thị của bố cục và biết cách gán giá trị cho biểu thức liên kết.

Tạo đối tượng liên kết

Đối tượng liên kết được tạo ngay sau khi tăng cường bố cục để đảm bảo hệ phân cấp view không bị sửa đổi trước khi liên kết với các view có biểu thức trong bố cục. Phương thức phổ biến nhất để liên kết đối tượng với một bố cục là sử dụng các phương thức tĩnh trên lớp liên kết. Bạn có thể tăng cường hệ phân cấp view và liên kết đối tượng với hệ phân cấp đó bằng cách sử dụng phương thức inflate() của lớp liên kết, như trong ví dụ sau:

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    val binding: MyLayoutBinding = MyLayoutBinding.inflate(layoutInflater)

    setContentView(binding.root)
}

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    MyLayoutBinding binding = MyLayoutBinding.inflate(getLayoutInflater());

    setContentView(binding.root);
}

Có một phiên bản thay thế của phương thức inflate() lấy đối tượng ViewGroup ngoài đối tượng LayoutInflater, như trong ví dụ sau:

Kotlin

val binding: MyLayoutBinding = MyLayoutBinding.inflate(getLayoutInflater(), viewGroup, false)

Java

MyLayoutBinding binding = MyLayoutBinding.inflate(getLayoutInflater(), viewGroup, false);

Nếu bố cục được tăng cường bằng một cơ chế khác, bạn có thể liên kết bố cục đó riêng biệt, như sau:

Kotlin

val binding: MyLayoutBinding = MyLayoutBinding.bind(viewRoot)

Java

MyLayoutBinding binding = MyLayoutBinding.bind(viewRoot);

Đôi khi, bạn không biết trước loại liên kết. Trong những trường hợp như vậy, bạn có thể tạo liên kết bằng cách sử dụng lớp DataBindingUtil, như minh hoạ trong đoạn mã sau:

Kotlin

val viewRoot = LayoutInflater.from(this).inflate(layoutId, parent, attachToParent)
val binding: ViewDataBinding? = DataBindingUtil.bind(viewRoot)

Java

View viewRoot = LayoutInflater.from(this).inflate(layoutId, parent, attachToParent);
ViewDataBinding binding = DataBindingUtil.bind(viewRoot);

Nếu đang sử dụng các mục liên kết dữ liệu bên trong bộ chuyển đổi Fragment, ListView hoặc RecyclerView, bạn nên sử dụng các phương thức inflate() của các lớp liên kết hoặc lớp DataBindingUtil, như trong đoạn mã ví dụ sau:

Kotlin

val listItemBinding = ListItemBinding.inflate(layoutInflater, viewGroup, false)
// or
val listItemBinding = DataBindingUtil.inflate(layoutInflater, R.layout.list_item, viewGroup, false)

Java

ListItemBinding binding = ListItemBinding.inflate(layoutInflater, viewGroup, false);
// or
ListItemBinding binding = DataBindingUtil.inflate(layoutInflater, R.layout.list_item, viewGroup, false);

Chế độ xem có mã nhận dạng

Thư viện liên kết dữ liệu tạo một trường không thể thay đổi trong lớp liên kết cho mỗi thành phần hiển thị có mã nhận dạng trong bố cục. Ví dụ: Thư viện liên kết dữ liệu tạo các trường firstName và lastName thuộc loại TextView từ bố cục sau:

<layout xmlns:android="http://schemas.android.com/apk/res/android">
   <data>
       <variable name="user" type="com.example.User"/>
   </data>
   <LinearLayout
       android:orientation="vertical"
       android:layout_width="match_parent"
       android:layout_height="match_parent">
       <TextView android:layout_width="wrap_content"
           android:layout_height="wrap_content"
           android:text="@{user.firstName}"
   android:id="@+id/firstName"/>
       <TextView android:layout_width="wrap_content"
           android:layout_height="wrap_content"
           android:text="@{user.lastName}"
  android:id="@+id/lastName"/>
   </LinearLayout>
</layout>

Thư viện trích xuất các thành phần hiển thị, bao gồm cả mã nhận dạng, từ hệ phân cấp thành phần hiển thị trong một lượt duy nhất. Cơ chế này có thể nhanh hơn so với việc gọi phương thức findViewById() cho mọi thành phần hiển thị trong bố cục.

Mã nhận dạng không cần thiết như khi không có liên kết dữ liệu, nhưng vẫn có một số trường hợp cần truy cập vào các thành phần hiển thị từ mã.

Biến

Thư viện liên kết dữ liệu tạo các phương thức truy cập cho mỗi biến được khai báo trong bố cục. Ví dụ: bố cục sau đây tạo các phương thức setter và getter trong lớp liên kết cho các biến user, image và note:

<data>
   <import type="android.graphics.drawable.Drawable"/>
   <variable name="user" type="com.example.User"/>
   <variable name="image" type="Drawable"/>
   <variable name="note" type="String"/>
</data>

ViewStub

Không giống như các khung hiển thị thông thường, các đối tượng ViewStub bắt đầu dưới dạng khung hiển thị không nhìn thấy được. Khi được hiển thị hoặc được tăng cường một cách rõ ràng, chúng sẽ tự thay thế trong bố cục bằng cách tăng cường một bố cục khác.

Vì ViewStub biến mất khỏi hệ phân cấp view, nên view trong đối tượng liên kết cũng phải biến mất để được thu gom rác. Vì các khung hiển thị là cuối cùng, nên đối tượng ViewStubProxy sẽ thay thế ViewStub trong lớp liên kết được tạo, cho phép bạn truy cập vào ViewStub khi nó tồn tại và truy cập vào hệ phân cấp khung hiển thị được tăng cường khi ViewStub được tăng cường.

Khi tăng cường một bố cục khác, bạn phải thiết lập một liên kết cho bố cục mới. Do đó, ViewStubProxy phải theo dõi ViewStub OnInflateListener và thiết lập liên kết khi cần. Vì mỗi lần chỉ có thể tồn tại một trình nghe, nên ViewStubProxy cho phép bạn đặt OnInflateListener, trình nghe này sẽ được gọi sau khi thiết lập liên kết.

Ràng buộc ngay lập tức

Khi một biến hoặc đối tượng có thể quan sát thay đổi, liên kết sẽ được lên lịch thay đổi trước khung hình tiếp theo. Tuy nhiên, có những lúc bạn phải thực thi liên kết ngay lập tức. Để buộc thực thi, hãy sử dụng phương thức executePendingBindings().

Biến động

Đôi khi, lớp liên kết cụ thể không xác định được. Ví dụ: một RecyclerView.Adapter hoạt động dựa trên bố cục tuỳ ý sẽ không biết lớp liên kết cụ thể. Hàm này phải chỉ định giá trị liên kết trong lệnh gọi đến phương thức onBindViewHolder().

Trong ví dụ sau, tất cả bố cục mà RecyclerView liên kết đều có biến item. Đối tượng BindingHolder có phương thức getBinding() trả về lớp cơ sở ViewDataBinding.

Kotlin

override fun onBindViewHolder(holder: BindingHolder, position: Int) {
    item: T = items.get(position)
    holder.binding.setVariable(BR.item, item);
    holder.binding.executePendingBindings();
}

Java

public void onBindViewHolder(BindingHolder holder, int position) {
    final T item = items.get(position);
    holder.getBinding().setVariable(BR.item, item);
    holder.getBinding().executePendingBindings();
}

Luồng ở chế độ nền

Bạn có thể thay đổi mô hình dữ liệu trong một luồng nền, miễn là mô hình đó không phải là một tập hợp. Liên kết dữ liệu sẽ bản địa hoá từng biến hoặc trường trong quá trình đánh giá để tránh mọi vấn đề về tính đồng thời.

Tên lớp liên kết tuỳ chỉnh

Theo mặc định, một lớp liên kết được tạo dựa trên tên của tệp bố cục, bắt đầu bằng một chữ cái viết hoa, xoá dấu gạch dưới ( _ ), viết hoa chữ cái tiếp theo và thêm hậu tố Binding. Ví dụ: tệp bố cục contact_item.xml tạo lớp ContactItemBinding. Lớp này được đặt trong gói databinding thuộc gói mô-đun. Ví dụ: nếu gói mô-đun là com.example.my.app, thì lớp liên kết sẽ được đặt trong gói com.example.my.app.databinding.

Bạn có thể đổi tên hoặc đặt các lớp liên kết vào các gói khác nhau bằng cách điều chỉnh thuộc tính class của phần tử data. Ví dụ: bố cục sau đây tạo lớp liên kết ContactItem trong gói databinding trong mô-đun hiện tại:

<data class="ContactItem">
    ...
</data>

Bạn có thể tạo lớp liên kết trong một gói khác bằng cách thêm dấu chấm vào trước tên lớp. Ví dụ sau đây tạo lớp liên kết trong gói mô-đun:

<data class=".ContactItem">
    ...
</data>

Bạn cũng có thể sử dụng tên gói đầy đủ mà bạn muốn tạo lớp liên kết. Ví dụ sau đây tạo lớp liên kết ContactItem trong gói com.example:

<data class="com.example.ContactItem">
    ...
</data>

Tài nguyên khác

Để tìm hiểu thêm về liên kết dữ liệu, hãy xem thêm các tài nguyên sau đây.