DataBinding 是 Google 在 Jetpack 中推出的一款数据绑定的支持库,利用该库可以实现在页面组件中直接绑定应用程序的数据源。使其维护起来更加方便,架构更明确简介。
DataBinding 唯一的作用,也是他的使命,就是绑定数据
,以及所有的支持库,本质上都是为了支持这个功能。绑定一词有两种解释,第一是将数据绑定在 UI 元素
;第二是将 UI 上的数据绑定到对应的数据模型
,还支持对数据及 UI 的变动观察,其中一个发生变动就需要同步到另一个上去。
首先设置使用 Databinding,在 app module 的 build.gradle 中添加如下代码即可:
android {
...
dataBinding {
enabled = true
}
}
根结点必须为
变量的属性名name不能包含_下划线
,否则再kt文件里会找不到变量,有时可能需要指定自定义类型
,可以使用 import 语法来导入类,以及使用 alias 设置别名
<data>
<import type="com.example.databinding.Entity.User"/>
<import type="com.example.databinding.Entity.user.User" alias="member"/>
<variable
name="user"
type="User" />
<variable
name="member"
type="member" />
data>
当需要使用两个同名但不同包名的类,可以使用alias别名属性
它有个属性class,可以自定义DataBinding生成的类名及路径
<data class="ObservableDataBinding"> </data>
运算符
运算类型 | 运算符 |
---|---|
算术运算符 | + - / * % |
字符串连接运算符 | + |
逻辑运算符 | && |
二元运算符 | & |
一元运算符 | + - ! ~ |
移位运算符 | >> >>> << |
三元运算符 | == > < >= <= |
分组运算符 | () |
关键字
instanceof
字符、字符串、数字、null
类型转换
方法调用
字段访问
数组访问 []
DataBinding 可以绑定普通数据对象(非 Observable/LiveData)
<data>
<import type="java.lang.String"/>
<variable name="content" type="String" />
data>
绑定可观察数据意味着当数据变化时 UI 会跟着一起变化,绑定可观察数据有三种方式:objects
、fields
和 collections
.
对于一些数据类只需要其中几个字段支持可观察,那么可以使用这种方式来创建可观察数据
data class User(
val name: ObservableField<String>,
val likes: ObservableInt
)
基本数据类型直接使用对应的包装类
基本数据类型 | 包装类 |
---|---|
boolean | ObservableBoolean |
byte | ObservableByte |
char | ObservableChar |
short | ObservableShort |
int | ObservableInt |
long | ObservableLong |
float | ObservableFloat |
double | ObservableDouble |
引用类型使用带有泛型参数的 ObservableField 类来创建
val name: ObservableField<String>
<data>
<import type="android.databinding.ObservableList"/>
<variable name="user" type="ObservableList/>
</data>
<TextView android:text="@{user[index]}" ... />
可以直接使用 [] 运算符( list[0] )获取对应位置的元素
需要绑定的数据实体类继承 BaseObservable
class Person : BaseObservable() {
@get:Bindable
var country: String = ""
set(value) {
field = value
notifyPropertyChanged(BR.country)
}
@get:Bindable
var sex: String = ""
set(value) {
field = value
notifyPropertyChanged(BR.sex)
}
}
需要支持可观察的数据上添加 @get:Bindable 注解,然后重写 set 方法,在其中调用 notifyPropertyChanged 方法表示更新该数据,BR 是自动生成的,包名跟当前包名一致,会根据 Bindable 注解的变量生成对应的值;也可以调用 notifyChange() 方法更新所有数据
LiveData也支持数据绑定
<layout>
<data>
<variable name="desc"
type="androidx.lifecycle.MutableLiveData<String>" />
data>
...
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="center_vertical"
android:text="@{desc}" />
layout>
我们可以直接将 LiveData 赋值给 text,然后绑定数据
val desc = MutableLiveData<String>()
binding.desc = desc
单向绑定是指数据变化后更新 UI,而双向绑定是指其中任意一个变化后都会同步更新到另一个。
双向绑定使用 @={} 表达式来实现:
<data>
...
<variable
name="input"
type="androidx.databinding.ObservableField<String>" />
</data>
...
<EditText
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="@={input}"/>