翻译自android官网,可直接去官网观看
Jetpack系列之Data Binding----入门(一)
概览
数据绑定库 Android Jetpack 的一部分。
数据绑定库是一种支持库,借助该库,您可以使用声明性格式(而非程序化地)将布局中的界面组件绑定到应用中的数据源。
布局通常是使用调用界面框架方法的代码在 Activity 中定义的。例如,以下代码调用 findViewById() 来查找 TextView 微件并将其绑定到 viewModel 变量的 userName 属性:
TextView textView = findViewById(R.id.sample_text);
textView.setText(viewModel.getUserName());
以下示例展示了如何在布局文件中使用数据绑定库将文本直接分配到控件。这样就无需调用上述任何 Java 代码。请注意赋值表达式中 @{} 语法的使用:
<TextView
android:text="@{viewmodel.userName}" />
借助布局文件中的绑定组件,您可以移除 Activity 中的许多界面框架调用,使其维护起来更简单、方便。还可以提高应用性能,并且有助于防止内存泄漏以及避免发生 Null 指针异常。
注意:在许多情况下,视图绑定可简化实现,提高性能,提供与数据绑定相同的好处。如果您使用数据绑定的主要目的是取代 findViewById() 调用,请考虑改用视图绑定。
使用数据绑定库
要了解如何在 Android 应用中使用数据绑定库,请参阅以下页面。
使用入门
了解如何准备开发环境以使用数据绑定库,包括在 Android Studio 中支持数据绑定代码。
布局和绑定表达式
借助表达式语言,您可以编写将变量关联到布局中的视图的表达式。数据绑定库会自动生成将布局中的视图与您所需的类对象的数据绑定。该库提供了可在布局中使用的导入、变量和包含等功能
。
该库的这些功能可与您的现有布局无缝地共存。例如,可以在表达式中使用的绑定变量在 data 元素(界面布局根元素的同级)内定义。这两个元素都封装在 layout 标记中,如以下示例所示:
<layout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto">
<data>
<variable
name="viewmodel"
type="com.myapp.data.ViewModel" />
</data>
<ConstraintLayout... /> <!-- UI layout's root element -->
</layout>
使用可观察的数据对象
数据绑定库提供了可让您轻松地观察数据更改情况的类和方法。您不必操心在底层数据源发生更改时刷新界面。您可以将变量或其属性设为可观察。借助该库,您可以将对象、字段或集合设为可观察。
生成的绑定类
数据绑定库可以生成用于访问布局变量和视图的绑定类。此页面展示了如何使用和自定义所生成的绑定类。
绑定适配器
每一个布局表达式都有一个对应的绑定适配器,要求必须进行框架调用来设置相应的属性或监听器。例如,绑定适配器负责调用 setText() 方法来设置文本属性,或者调用 setOnClickListener() 方法向点击事件添加监听器。最常用的绑定适配器(例如针对本页面的示例中使用的 android:text 属性)在 android.databinding.adapters 软件包中可供您使用。如需常用绑定适配器列表,请参阅适配器。您也可以按照以下示例所示创建自定义适配器:
@BindingAdapter("app:goneUnless")
public static void goneUnless(View view, Boolean visible) {
view.visibility = visible ? View.VISIBLE : View.GONE;
}
将布局视图绑定到架构组件
这个Android 支持库包含架构组件,您可以使用这些组件设计稳健、可测试且易维护的应用。您可以将架构组件与数据绑定库一起使用,以进一步简化界面开发。
双向数据绑定
数据绑定库支持双向数据绑定。此类绑定使用的表示法支持以下操作:接收对属性的数据更改,同时监听用户对此属性的更新
。
使用入门
了解如何准备开发环境以使用数据绑定库,包括支持 Android Studio 中的数据绑定代码。
数据绑定库不但灵活,而且兼容性广,它是一个支持库,因此您可以在运行 Android 4.0(API 级别 14)或更高级别的设备上使用它。
建议您在项目中使用最新的 Android Plugin for Gradle。不过,1.5.0 版及更高版本支持数据绑定。有关详情,请参阅介绍如何更新 Android Plugin for Gradle的说明。
编译环境
要开始使用数据绑定,请从 Android SDK 管理器中的支持代码库下载该库。有关详情,请参阅更新 IDE 和 SDK 工具。
要将应用配置为使用数据绑定,请在应用模块的 build.gradle 文件中添加 dataBinding 元素,如以下示例所示:
android {
...
dataBinding {
enabled = true
}
}
注意:即使应用模块不直接使用数据绑定,也必须为依赖于使用数据绑定的库的应用模块配置数据绑定。
Android Studio 对数据绑定的支持
Android Studio 支持许多用于修改数据绑定代码的功能。例如,它支持用于数据绑定表达式的以下功能:
注意:数组和通用类型(如 Observable 类)可能会不正确地显示错误。
Layout Editor 中的 Preview 窗格显示数据绑定表达式的默认值(如果提供)。例如,Preview 窗格会在以下示例声明的 TextView 微件上显示 my_default 值:
<TextView android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@{user.firstName, default=my_default}"/>
如果您只需要在项目的设计阶段显示默认值,则可以使用 tools 属性,而不是默认表达式值,详情请参阅工具属性参考中的描述。
布局和绑定表达式
借助表达式语言,您可以编写表达式来处理视图分派的事件。数据绑定库会自动生成将布局中的视图与您所需的类的数据对象绑定。
数据绑定布局文件略有不同,以根标记 layout 开头,后跟 data 元素和 view 根元素。此视图元素是非绑定布局文件中的根。以下代码展示了示例布局文件:
<?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}"/