本文档介绍了如何使用数据绑定库来编写声明性布局,并最大限度地减少绑定应用程序逻辑和布局所需的粘贴代码。
数据绑定库提供了灵活性和广泛的兼容性 - 它是一个支持库,因此您可以将其与所有Android平台版本一起使用到Android 2.1(API级别为7+).要使用数据绑定,需要Android Plugin for Gradle 1.5.0-alpha1或更高版本。
建立环境
要开始使用数据绑定,请从Android SDK管理器的支持信息库中下载库。要将应用程序配置为使用数据绑定,请将dataBinding元素添加到应用程序模块中的build.gradle文件中。
使用以下代码段来配置数据绑定:
android {
....
dataBinding {
enabled = true
}
}
如果您有一个依赖于使用数据绑定的库的应用程序模块,则应用程序模块必须在其build.gradle文件中配置数据绑定。另外,请确保您使用的兼容版本的Android Studio。 Android Studio 1.3及更高版本支持数据绑定。
数据绑定布局文件
编写第一组数据绑定表达式
数据绑定布局文件略有不同,从布局的根标记开始,后跟数据元素和视图根元素。此视图元素是您的根在不具有约束力的布局文件中的位置。示例文件如下所示:
<?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>
数据内的用户变量描述了可在此布局中使用的属性。
<variable name="user" type="com.example.User"/>
布局中的表达式使用“@ {}”语法写入属性属性。这里,TextView的文本设置为userName的firstName属性:
<TextView android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@{user.firstName}"/>
数据对象
我们现在假设你有一个简单的Java对象(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;
}
}
这种类型的对象具有从不改变的数据。在应用程序中通常会读取一次数据,从此不会更改。也可以使用JavaBeans对象:
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;
}
}
从数据绑定的角度来看,这两个类是等价的。用于TextView的android:text属性的表达式@ {user.firstName}将访问前一个类中的firstName字段,并在后一类中访问getFirstName()方法。或者,如果该方法存在,它也将被解析为firstName()。
绑定数据
默认情况下,将根据布局文件的名称生成一个Binding类,将其转换为Pascal大小写,后缀为“Binding”。上面的布局文件是main_activity.xml,所以生成类是MainActivityBinding。该类保存从布局属性(例如用户变量)到布局的视图的所有绑定,并知道如何为绑定表达式分配值。创建绑定的最简单方法是在充气时执行:
@Override
protected 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);
}
你完成了!运行应用程序,您将在UI中看到测试用户。或者,您可以通过以下方式获取视图:
MainActivityBinding binding = MainActivityBinding.inflate(getLayoutInflater());
如果您在ListView或RecyclerView适配器中使用数据绑定项目,则可能更喜欢使用:
ListItemBinding binding = ListItemBinding.inflate(layoutInflater, viewGroup, false);
//or
ListItemBinding binding = DataBindingUtil.inflate(layoutInflater, R.layout.list_item, viewGroup, false);