Android Data Binding Library 官方文檔

2019-11-09 17:32:47

字體：大中小

來源：轉載

供稿：網友

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

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

構建環境

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

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

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

數據綁定的布局文件

書寫第一組數據綁定表達式

<?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>標簽中 <variable>描述了一個變量user，它對應的類型為”com.example.User” 布局中使用“@ { }”語法來書寫表達式。如為TextView的文本設置成user. firstName：

數據對象

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

也可以如下書寫：

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

在數據綁定中，訪問@{user.firstName}，那么默認就會訪問同名的屬性firstName，或對應的getFirstName方法

綁定數據

默認情況下，綁定類將基于布局文件的名稱來產生如布局文件為main_activity.xml，這樣生成的類是 MainActivityBinding 如下設置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);}

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

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

如果是在一個adapter中來使用，那么可以如下：

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

事件處理

可以在xml中編寫表達式處理事件。比如 View.OnLongClickListener有一個方法為onLongClick()，那么它對應的事件就是android:onLongClick。當綁定事件后，會自動將該listener綁定在View上。處理事件有兩種方法， 1. 方法引用：可以引用符合listener 任意方法簽名規則的方法。 2. 監聽器綁定：使用lambda表達式

方法引用

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

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>

監聽器綁定

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

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表達式作為根元素的表達式

像上面，我們并沒有定義onClick(android.view.View) 參數view。監聽器綁定，允許我們忽略所有的參數。如果想要使用參數，可以忽略參數類型，而隨意定義一個名字。比如，上面的表達式中寫上view參數：

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

如果要使用該參數，可以在對應回調方法中也定義上：

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

您可以使用一個lambda表達式，它操作多個參數:

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)}" />

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

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

如果表達式對于null對象無法評估，那最好對應方法返回一個基本數據類型的默認值。比如 null for reference types, 0 for int, false for boolean.

如下使用一個三元表達式：

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