Android Data Binding Library 官方文檔

2019-11-09 17:32:47

字體：大中小

來(lái)源：轉(zhuǎn)載

供稿：網(wǎng)友

地址：https://developer.android.google.cn/topic/libraries/data-binding/index.html

Data Binding Library （數(shù)據(jù)綁定庫(kù)），旨在減少綁定應(yīng)用程序邏輯和布局所需的一些耦合性代碼最低支持Android 2.1 (API Level 7)

構(gòu)建環(huán)境

使用gradle插件1.5-alpha1以上在build.gradle添加如下聲明

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

注：如果子Moudle使用了數(shù)據(jù)綁定，那么最好也在app Moudle中配置一下

數(shù)據(jù)綁定的布局文件

書(shū)寫(xiě)第一組數(shù)據(jù)綁定表達(dá)式

<?xml version="1.0" encoding="utf-8"?><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}"/> <TextView android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="@{user.lastName}"/> </LinearLayout></layout>

如上，在<data>標(biāo)簽中 <variable>描述了一個(gè)變量user，它對(duì)應(yīng)的類型為”com.example.User” 布局中使用“@ { }”語(yǔ)法來(lái)書(shū)寫(xiě)表達(dá)式。如為T(mén)extView的文本設(shè)置成user. firstName：

數(shù)據(jù)對(duì)象

a plain-old java object (POJO) for User：

public class User { public final String firstName; public final String lastName; public User(String firstName, String lastName) { this.firstName = firstName; this.lastName = lastName; }}

也可以如下書(shū)寫(xiě)：

public class User { PRivate final String firstName; private final String lastName; public User(String firstName, String lastName) { this.firstName = firstName; this.lastName = lastName; } public String getFirstName() { return this.firstName; } public String getLastName() { return this.lastName; }}

在數(shù)據(jù)綁定中，訪問(wèn)@{user.firstName}，那么默認(rèn)就會(huì)訪問(wèn)同名的屬性firstName，或?qū)?yīng)的getFirstName方法

綁定數(shù)據(jù)

默認(rèn)情況下，綁定類將基于布局文件的名稱來(lái)產(chǎn)生如布局文件為main_activity.xml，這樣生成的類是 MainActivityBinding 如下設(shè)置Activity的contentView：

@Overrideprotected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); MainActivityBinding binding = DataBindingUtil.setContentView(this, R.layout.main_activity); User user = new User("Test", "User"); binding.setUser(user);}

上文說(shuō)，在xml中用表達(dá)式可以獲取數(shù)據(jù)，那么同樣的，在代碼中也可以設(shè)置數(shù)據(jù)，如這里的：binding.setUser(user); 還可以使用inflate的方式來(lái)獲取生成數(shù)據(jù)綁定類：

MainActivityBinding binding = MainActivityBinding.inflate(getLayoutInflater());

如果是在一個(gè)adapter中來(lái)使用，那么可以如下：

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

事件處理

可以在xml中編寫(xiě)表達(dá)式處理事件。比如 View.OnLongClickListener有一個(gè)方法為onLongClick()，那么它對(duì)應(yīng)的事件就是android:onLongClick。當(dāng)綁定事件后，會(huì)自動(dòng)將該listener綁定在View上。處理事件有兩種方法， 1. 方法引用：可以引用符合listener 任意方法簽名規(guī)則的方法。 2. 監(jiān)聽(tīng)器綁定：使用lambda表達(dá)式

方法引用

比如定義一個(gè)符合OnClickListener#onClick(View view)方法參數(shù)簽名規(guī)則的方法：

public class MyHandlers { public void onClickFriend(View view) { ... }}

如下在xml中綁定并使用：

<?xml version="1.0" encoding="utf-8"?><layout xmlns:android="http://schemas.android.com/apk/res/android"> <data> <variable name="handlers" type="com.example.Handlers"/> <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:onClick="@{handlers::onClickFriend}"/> </LinearLayout></layout>

監(jiān)聽(tīng)器綁定

表達(dá)式使用的方法就可以定義的比較隨意了，不用像”方法引用”那樣遵循特定規(guī)則，如一個(gè)方法

public class Presenter { public void onSaveClick(Task task){}}

使用它

<?xml version="1.0" encoding="utf-8"?> <layout xmlns:android="http://schemas.android.com/apk/res/android"> <data> <variable name="task" type="com.android.example.Task" /> <variable name="presenter" type="com.android.example.Presenter" /> </data> <LinearLayout android:layout_width="match_parent" android:layout_height="match_parent"> <Button android:layout_width="wrap_content" android:layout_height="wrap_content" android:onClick="@{() -> presenter.onSaveClick(task)}" /> </LinearLayout> </layout>

注：只允許由lambda表達(dá)式作為根元素的表達(dá)式

像上面，我們并沒(méi)有定義onClick(android.view.View) 參數(shù)view。監(jiān)聽(tīng)器綁定，允許我們忽略所有的參數(shù)。如果想要使用參數(shù)，可以忽略參數(shù)類型，而隨意定義一個(gè)名字。比如，上面的表達(dá)式中寫(xiě)上view參數(shù)：

android:onClick="@{(view) -> presenter.onSaveClick(task)}"

如果要使用該參數(shù)，可以在對(duì)應(yīng)回調(diào)方法中也定義上：

public class Presenter { public void onSaveClick(View view, Task task){}}android:onClick="@{(theView) -> presenter.onSaveClick(theView, task)}"

您可以使用一個(gè)lambda表達(dá)式，它操作多個(gè)參數(shù):

public class Presenter { public void onCompletedChanged(Task task, boolean completed){}}<CheckBox android:layout_width="wrap_content" android:layout_height="wrap_content" android:onCheckedChanged="@{(cb, isChecked) -> presenter.completeChanged(task, isChecked)}" />

如果事件有返回值，那么我們定義的方法，最好也有相應(yīng)的返回值。如：

public class Presenter { public boolean onLongClick(View view, Task task){}}android:onLongClick="@{(theView) -> presenter.onLongClick(theView, task)}"

如果表達(dá)式對(duì)于null對(duì)象無(wú)法評(píng)估，那最好對(duì)應(yīng)方法返回一個(gè)基本數(shù)據(jù)類型的默認(rèn)值。比如 null for reference types, 0 for int, false for boolean.

如下使用一個(gè)三元表達(dá)式：

android:onClick="@{(v) -> v.isVisible() ? doSomething() : void}"