1. 程式人生 > >Android 官方資料繫結框架 Data Binding 簡單使用

Android 官方資料繫結框架 Data Binding 簡單使用

參考資料

配置 Data Binding 環境

在需要使用 Data Binding 的 module 里加上如下配置:

android {
    ....
    dataBinding {
        enabled = true
    }
}

若 module 所依賴的包使用了 Data Binding,module 裡也仍然需要加上。
設定好之後,需要使用 gradle 同步專案,使專案載入依賴包。

從繫結物件裡獲取資料的幾種方式

  • 直接獲取 public 修飾的變數的值,如下面的firstName
  • 從屬性的 getter 方法獲取,如下面的lastName
  • 直接以欄位名為名字的方法獲取,如下面的nativePlace

模擬一個 User 物件

首先要有物件來提供繫結才行,所以這裡先建好一個用於測試的User類。

其中有 3 個欄位,用於測試上面描述的獲取資料的幾種方式是否有效。

package com.zjq.databindingpractice;

/**
 * 模擬使用者物件
 * Created by softwater on 2017/4/19.
 * Modified by softwater on 2017/4/19.
 */

public class User {
  /**
   * 姓,不提供 getter、setter 方法
   */
public String firstName; /** * 名,提供標準的 getter、setter 方法 */ private String lastName; /** * 籍貫,提供標準的 setter 方法,getter 方法為 {@link #nativePlace()} */ private String nativePlace; public void setLastName(String lastName) { this.lastName = lastName; } public String getLastName
() { return this.lastName; } public void setNativePlace(String nativePlace) { this.nativePlace = nativePlace; } public String nativePlace() { return nativePlace; } }

修改佈局檔案

使用 Data Binding 的佈局檔案有一點不同,就是最外層的標籤是<layout>,不再是以前的各種ViewGroup<layout>標籤裡使用<data>標籤來指定介面繫結的資料物件。格式如下:

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">
  <data>
    <variable
        name="user"
        type="com.zjq.databindingpractice.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}"
        />
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@{user.lastName}"
        />
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@{user.nativePlace}"
        />
  </LinearLayout>
</layout>

其中

<data>
<variable name="user"
    type="com.zjq.databindingpractice.User"/>
</data>

這樣就將com.zjq.databindingpractice.User物件繫結到了當前介面之中,並設定 name 屬性為 user。
之後就可以使用@{}語法直接獲取值設定到對應的 View 中。

此時繫結到介面的具體物件是不確定的,因為物件都還沒有例項化,都還沒有為 User 賦值,所以需要在程式碼裡建立物件,並賦值,然後傳遞給介面。

在 Activity 裡建立User物件並繫結到檢視

@Override protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    //setContentView(R.layout.activity_main);
    ActivityMainBinding binding = DataBindingUtil.setContentView(this, R.layout.activity_main);

    User user = new User();
    user.firstName = "王";
    user.setLastName("菲菲");
    user.setLastName("背景");
    binding.setUser(user);
  }

上面的程式碼是在 Activity 里加載的,若介面使用了 Data Binding,就不能使用以前的setContentView()方法了,而要使用DataBindingUtil.setContentView(this, R.layout.activity_main);,這裡的返回值是ActivityMainBinding,這個類是根據 layout 的檔名來的,就在 layout 檔名後面加上 Binding。如果編輯器提示找不到ActivityMainBinding類,請 sync 一下程式碼,或者 build 一次。
有了 User物件之後,需要使用binding.setUser(user);方法設定進去。

執行檢視效果

簡單的繫結效果