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