Android数据绑定——Databinding使用详解

一、基础概念

Android数据绑定库是一种支持库，使用 XML 布局文件来申明应用程序 UI 组件（如 TextView、ImageView 等）与计算后端逻辑之间的连接。

Databinding 提供了一种自动化的方式将 UI 上的数据绑定到应用逻辑上，以减少使用传统 findViewById 代码的频率，同时减少了大量重复代码的开发，提高了开发效率。

与传统的 findViewById 或 ButterKnife 等第三方库相比，Databinding 具有以下优势：

• 不需要定义变量或绑定变量，样板代码更少。
• 编译时会生成绑定代码，避免了运行时反射所带来的性能问题。
• 减少了Activity和Fragment的代码量。

二、使用方法

1. 添加依赖

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

   	def databinding_version = "4.2.0"

   	implementation "com.android.databinding:compiler:$databinding_version"
	implementation "androidx.databinding:databinding-common:$databinding_version"
	implementation "androidx.databinding:databinding-runtime:$databinding_version"
}

2. 布局文件创建

在需要使用 Databinding 的布局文件中的根布局添加 <layout> 标签，该布局文件中的其他控件，可以使用该布局文件中的变量进行数据绑定。

<layout xmlns:android="http://schemas.android.com/apk/res/android">
    <data>
        <import type="java.util.List" />
        <variable
            name="user"
            type="com.example.User" />
    </data>

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent">
        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@{user.name}" />
    </LinearLayout>
</layout>

3. 绑定变量

在 Activity 或 Fragment 中，使用 DataBindingUtil.inflate() 或 DataBindingUtil.setContentView() 方法来获得与布局文件进行绑定的 Binding 对象。

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        val binding: ActivityMainBinding =
            DataBindingUtil.setContentView(this, R.layout.activity_main)
        
        val user = User("Bob")
        binding.user = user
    }
}

三、数据绑定

可以在布局文件中使用表达式语言（表达式由 @{} 标签限定），可以将布局中的控件绑定到变量。表达式语言将在编译时计算，这与早期的绑定库不同。

表达式语言可以访问以下内容：

• 变量
• 变量上的方法
• Layout 上的绑定适配器
• 静态 Global 方法

<data>
    <variable
        name="user"
        type="com.example.User" />
</data>

<TextView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="@{user.name}" />

变量 user 的类型是 com.example.User ，可以在表达式中访问 user 对象的属性，如 user.name 。

四、事件绑定

可以使用 Databinding 将布局文件中的事件与特定的方法绑定。

在 Android 中， View.OnClickListener 接口被用于处理点击事件。通过使用 Databinding，可以省略掉这个步骤，并直接将要调用的方法绑定到事件处理程序。要将事件绑定到方法，请将 @{} 表达式添加到布局中的属性或方法。

<Button
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:onClick="@{() -> presenter.onButtonClick()}"
    android:text="@string/button_text" />

上面的代码将按钮与 presenter.onButtonClick() 方法绑定在一起，当按钮被点击时，该方法将被调用。

五、观察

变量可以成为可观察的，当变量发生更改时，布局将自动更新。通常，这是通过在变量声明中添加 Observable 标记来完成的。

<data>
    <import type="androidx.databinding.ObservableList" />
    <variable
        name="users"
        type="ObservableList<com.example.User>"
        />
</data>

在上述示例中，变量 users 通过添加 Observable 标签变为可观察的。这意味着当 users 变化时，视图自动更新。

由于 Databinding 支持字段和 map 的绑定，因此还可以通过在关键字段上使用 ObservableField 类型来更改单个字段。

@BindingAdapter("android:text")
fun setText(view: TextView, value: String?) {
    view.text = value ?: ""
}

class User(val name: ObservableField<String>, val age: ObservableField<Int>) {}

<TextView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="@{user.name}" />

在上面的示例中，User 类中的字段在其类型声明中使用了 ObservableField，并且可以将其直接绑定到布局文件中的字段中。

六、绑定适配器

绑定适配器是一种强大的技术，可用于将 Activity 或 Fragment 中方法的返回值用于数据绑定中的视图属性。

@BindingAdapter("imageUrl")
fun setImageUrl(view: ImageView, url: String) {
    Glide.with(view.context).load(url).into(view)
}

<ImageView android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    app:imageUrl="@{user.imageUrl}" />

在上面的示例中，setImageUrl() 方法带有 @BindingAdapter 注释，用于将 url 映射到 ImageView 的 imageUrl 属性。可以通过 app:imageUrl=”@{…}” 将该方法绑定到布局中。

七、总结

本文详细阐述了 Android 数据绑定的使用方法和优势，通过布局文件的绑定，可以避免在 Activity 或 Fragment 中编写冗长的 findViewById 代码，在大型项目中，可以节省大量时间和精力，提高开发效率。