一、基础概念
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 代码,在大型项目中,可以节省大量时间和精力,提高开发效率。