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);
方法設定進去。