Bind layout views to Architecture Components (綁定佈局到架構元件)

前言

AndroidX 函式庫包含架構元件(Architecture Components)，可以使用它來設計健壯，可測試和可維護的應用程序。

Data Binding Library 可與架構元件無縫協作，進一步簡化 UI 的開發。

應用程序中的 layout 可以綁定到架構元件中的數據，這些數據可以幫助管理 UI 控制器生命週期並通知數據中的更改。

以下介紹如何將架構元件合併到應用程序，以進一步使用 Data Binding Library 的好處。

 

Use LiveData to notify the UI about data changes

可以使用 LiveData 物件作為數據綁定來源，以自動通知UI有關數據更改的訊息。更多的資訊可以參考 LiveData Overview

與實現 Observable 的物件(例如 observable fields)不同，LiveData 物件了解訂閱對象的生命週期。相關的好處可以參考 The advantages of using LiveData

在 Android Studio 3.1 或之後的版本可以使用 LiveData 取代 observable fields。

要將 LiveData 與綁定類別一起使用，需要指定生命週期所有者(lifecycle owner)以定義 LiveData 對象的範圍。如下，在綁定類別初始化之後指定了 Activity 本身為生命週期所有者。

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);  
      }  
  }

可以使用 ViewModel元件(如 Use ViewModel to manage UI-related data)將數據綁定到佈局。在 ViewModel 中，可以使用 LiveData 對象轉換數據或合併多個數據來源。

如下示範如何在 ViewModel 中轉換數據。

class ScheduleViewModel extends ViewModel {  
      LiveData username;  
    
      public ScheduleViewModel() {  
          String result = Repository.userName;  
          userName = Transformations.map(result, result -> result.value);  
  }

 

Use VeiwModel to manage UI-related data

Data binding library 和 ViewModel 可以無縫協作，以顯示數據並對其更改做出反應。

將 ViewModel 元件與 data binding library 一起使用，可以將 UI 邏輯從佈局移動到元件中，讓元件更易於測試。

Data binding library 可確保在需要時綁定和取消綁定數據來源。

更多的訊息可以參考 ViewModel Overview

要將 ViewModel 與 data binding library 一起使用，必須實體化繼承自 ViewModel 的元件，取得綁定類別的實體，並將 ViewModel 元件分配給綁定類別中的屬性。如下

class ViewModelActivity extends AppCompatActivity {  
      @Override  
      protected void onCreate(Bundle savedInstanceState) {  
          // Obtain the ViewModel component.  
          UserModel userModel = ViewModelProviders.of(getActivity())  
                                                    .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;  
      }  
  }

在 layout 中，使用表達式將 ViewModel 元件的屬性和方法分配給相對應的視圖。

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

 

Use an Observable ViewModel for more control over binding adapters

可以使用實現 Observable 的 ViewModel 來通知其他應用程序元件有關數據更改的信息，類似於使用 LiveData 對象的方式。

在某些情況下，可能更適合使用 ViewModel 元件來實現 Observable 介面而不是使用 LiveData 對象，即使沒有 LiveData 的生命週期管理功能。

使用實現 Observable 的 ViewModel 元件可以更好地控制應用程序中的綁定適配器。此模式可以在數據變化時更容易控制通知，允許指定自定義方法以在雙向數據綁定中設置屬性的值。

要實現可觀察的 ViewModel 元件，必須創建一個繼承 ViewModel 並實現 Observable 介面的類別。

當觀察者使用 addOnPropertyChangedCallback() 和 removeOnPropertyChangedCallback()方法訂閱或取消訂閱通知時，使用者可以提供自定義邏輯。

還可以提供在 notifyPropertyChanged()方法中屬性更改時執行的自定義邏輯。

以下示範如何實現可觀察的 ViewModel

/**  
   * 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 should 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);  
      }  
  }

 

---

Orignal From: Bind layout views to Architecture Components (綁定佈局到架構元件)