Liên kết chế độ xem bố cục với thành phần kiến trúc

Thư viện AndroidX bao gồm Thành phần cấu trúc mà bạn có thể dùng để thiết kế các ứng dụng mạnh mẽ, có thể kiểm thử và bảo trì. Thư viện liên kết dữ liệu hoạt động liền mạch với các Thành phần cấu trúc để đơn giản hoá hơn nữa quá trình phát triển giao diện người dùng. Bố cục trong ứng dụng có thể liên kết với dữ liệu trong Thành phần cấu trúc, giúp bạn quản lý vòng đời của bộ điều khiển giao diện người dùng và thông báo cho giao diện người dùng về các thay đổi trong dữ liệu.

Tài liệu này trình bày cách kết hợp các Thành phần cấu trúc vào ứng dụng của bạn để khai thác tối đa Thư viện liên kết dữ liệu.

Sử dụng LiveData để thông báo cho giao diện người dùng về các thay đổi đối với dữ liệu

Bạn có thể dùng các đối tượng LiveData làm nguồn liên kết dữ liệu để tự động thông báo cho giao diện người dùng về các thay đổi trong dữ liệu. Để biết thêm thông tin về Thành phần cấu trúc này, hãy xem phần Tổng quan về LiveData.

Không giống như các đối tượng triển khai Observable (chẳng hạn như trường có thể quan sát), đối tượng LiveData biết về vòng đời của các đối tượng tiếp nhận dữ liệu đã đăng ký nhận thông báo về các thay đổi đối với dữ liệu. Kiến thức này mang lại nhiều lợi ích, được giải thích trong phần Ưu điểm của việc sử dụng LiveData. Trong Android Studio phiên bản 3.1 trở lên, bạn có thể thay thế các trường có thể quan sát bằng đối tượng LiveData trong mã liên kết dữ liệu.

Để dùng một đối tượng LiveData với lớp liên kết, bạn cần chỉ định một chủ sở hữu vòng đời để xác định phạm vi của đối tượng LiveData. Ví dụ sau đây chỉ định hoạt động là chủ sở hữu vòng đời sau khi lớp liên kết được tạo thực thể:

Kotlin

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.setLifecycleOwner(this)
    }
}

Java

class ViewModelActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        // Inflate view and obtain an instance of the binding class.
        UserBinding binding = DataBindingUtil.setContentView(this, R.layout.user);

        // Specify the current activity as the lifecycle owner.
        binding.setLifecycleOwner(this);
    }
}

Bạn có thể sử dụng thành phần ViewModel (như giải thích trong phần sau) để liên kết dữ liệu với bố cục. Trong thành phần ViewModel, bạn có thể sử dụng đối tượng LiveData để biến đổi dữ liệu hoặc hợp nhất nhiều nguồn dữ liệu. Ví dụ sau đây cho thấy cách chuyển đổi dữ liệu trong ViewModel:

Kotlin

class ScheduleViewModel : ViewModel() {
    val userName: LiveData<String>

    init {
        val result = Repository.userName
        userName = Transformations.map(result) { result -> result.value }
    }
}

Java

class ScheduleViewModel extends ViewModel {
    LiveData<String> username;

    public ScheduleViewModel() {
        String result = Repository.userName;
        userName = Transformations.map(result, result -> result.value);
    }
}

Sử dụng ViewModel để quản lý dữ liệu liên quan đến giao diện người dùng

Thư viện liên kết dữ liệu hoạt động liền mạch với các thành phần ViewModel. ViewModel hiển thị dữ liệu mà bố cục quan sát và phản ứng với các thay đổi của bố cục. Việc sử dụng các thành phần ViewModel với Thư viện liên kết dữ liệu cho phép bạn di chuyển logic giao diện người dùng ra khỏi bố cục và vào các thành phần, giúp dễ dàng kiểm thử hơn. Thư viện liên kết dữ liệu đảm bảo các thành phần hiển thị được liên kết và huỷ liên kết khỏi nguồn dữ liệu khi cần. Hầu hết công việc còn lại là đảm bảo rằng bạn đang hiển thị đúng dữ liệu. Để biết thêm thông tin về Thành phần cấu trúc này, hãy xem phần Tổng quan về ViewModel.

Để sử dụng thành phần ViewModel với Thư viện liên kết dữ liệu, bạn phải tạo thực thể cho thành phần của mình (kế thừa từ lớp ViewModel), lấy một thực thể của lớp liên kết và chỉ định thành phần ViewModel cho một thuộc tính trong lớp liên kết. Ví dụ sau đây cho thấy cách sử dụng thành phần này với thư viện:

Kotlin

class ViewModelActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        // Obtain the ViewModel component.
        val userModel: UserModel by viewModels()

        // Inflate view and obtain an instance of the binding class.
        val binding: UserBinding = DataBindingUtil.setContentView(this, R.layout.user)

        // Assign the component to a property in the binding class.
        binding.viewmodel = userModel
    }
}

Java

class ViewModelActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        // Obtain the ViewModel component.
        UserModel userModel = new ViewModelProvider(this).get(UserModel.class);

        // Inflate view and obtain an instance of the binding class.
        UserBinding binding = DataBindingUtil.setContentView(this, R.layout.user);

        // Assign the component to a property in the binding class.
        binding.viewmodel = userModel;
    }
}

Trong bố cục, hãy chỉ định các thuộc tính và phương thức của thành phần ViewModel cho khung hiển thị tương ứng thông qua biểu thức liên kết, như minh hoạ trong ví dụ sau đây:

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

Sử dụng ViewModel có thể quan sát để kiểm soát tốt hơn các bộ chuyển đổi liên kết

Bạn có thể sử dụng thành phần ViewModel triển khai giao diện Observable để thông báo cho các thành phần khác của ứng dụng về những thay đổi trong dữ liệu, tương tự như cách bạn sử dụng đối tượng LiveData.

Có những trường hợp bạn nên sử dụng thành phần ViewModel triển khai giao diện Observable thay vì sử dụng đối tượng LiveData, ngay cả khi bạn mất khả năng quản lý vòng đời của LiveData. Việc sử dụng thành phần ViewModel triển khai Observable giúp bạn kiểm soát tốt hơn các bộ chuyển đổi liên kết trong ứng dụng. Ví dụ: mẫu này giúp bạn kiểm soát tốt hơn các thông báo khi dữ liệu thay đổi; mẫu này cũng cho phép bạn chỉ định một phương thức tuỳ chỉnh để đặt giá trị của một thuộc tính trong liên kết dữ liệu hai chiều.

Để triển khai một thành phần ViewModel có thể quan sát, bạn phải tạo một lớp kế thừa từ lớp ViewModel và triển khai giao diện Observable. Bạn có thể cung cấp logic tuỳ chỉnh khi một trình quan sát đăng ký hoặc huỷ đăng ký nhận thông báo bằng cách sử dụng các phương thức addOnPropertyChangedCallback() và removeOnPropertyChangedCallback(). Bạn cũng có thể cung cấp logic tuỳ chỉnh chạy khi các thuộc tính thay đổi trong phương thức notifyPropertyChanged(). Ví dụ về mã sau đây cho thấy cách triển khai ViewModel có thể quan sát:

Kotlin

/**
 * A ViewModel that is also an Observable,
 * to be used with the Data Binding Library.
 */
open class ObservableViewModel : ViewModel(), Observable {
    private val callbacks: PropertyChangeRegistry = PropertyChangeRegistry()

    override fun addOnPropertyChangedCallback(
            callback: Observable.OnPropertyChangedCallback) {
        callbacks.add(callback)
    }

    override fun removeOnPropertyChangedCallback(
            callback: Observable.OnPropertyChangedCallback) {
        callbacks.remove(callback)
    }

    /**
     * Notifies observers that all properties of this instance have changed.
     */
    fun notifyChange() {
        callbacks.notifyCallbacks(this, 0, null)
    }

    /**
     * Notifies observers that a specific property has changed. The getter for the
     * property that changes must be marked with the @Bindable annotation to
     * generate a field in the BR class to be used as the fieldId parameter.
     *
     * @param fieldId The generated BR id for the Bindable field.
     */
    fun notifyPropertyChanged(fieldId: Int) {
        callbacks.notifyCallbacks(this, fieldId, null)
    }
}

Java

/**
 * A ViewModel that is also an Observable,
 * to be used with the Data Binding Library.
 */
class ObservableViewModel extends ViewModel implements Observable {
    private PropertyChangeRegistry callbacks = new PropertyChangeRegistry();

    @Override
    protected void addOnPropertyChangedCallback(
            Observable.OnPropertyChangedCallback callback) {
        callbacks.add(callback);
    }

    @Override
    protected void removeOnPropertyChangedCallback(
            Observable.OnPropertyChangedCallback callback) {
        callbacks.remove(callback);
    }

    /**
     * Notifies observers that all properties of this instance have changed.
     */
    void notifyChange() {
        callbacks.notifyCallbacks(this, 0, null);
    }

    /**
     * Notifies observers that a specific property has changed. The getter for the
     * property that changes must be marked with the @Bindable annotation to
     * generate a field in the BR class to be used as the fieldId parameter.
     *
     * @param fieldId The generated BR id for the Bindable field.
     */
    void notifyPropertyChanged(int fieldId) {
        callbacks.notifyCallbacks(this, fieldId, null);
    }
}

Tài nguyên khác

Để tìm hiểu thêm về liên kết dữ liệu, hãy tham khảo thêm những tài nguyên sau đây.