JetPack组件Databinding

---

---

简介

DataBinding 是 Google 在 Jetpack 中推出的一款数据绑定的支持库，利用该库可以实现在页面组件中直接绑定应用程序的数据源。使其维护起来更加方便，架构更明确简介。

DataBinding 唯一的作用，也是他的使命，就是绑定数据，以及所有的支持库，本质上都是为了支持这个功能。绑定一词有两种解释，第一是将数据绑定在 UI 元素；第二是将 UI 上的数据绑定到对应的数据模型，还支持对数据及 UI 的变动观察，其中一个发生变动就需要同步到另一个上去。

---

启用databinding

首先设置使用 Databinding，在 app module 的 build.gradle 中添加如下代码即可：

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

布局xml

根结点必须为<layout>，只能存在一个<data>和一个直接子View结点。

variable (变量标签)

变量的属性名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别名属性

data (数据标签)

它有个属性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.

对单个变量的绑定：fields

对于一些数据类只需要其中几个字段支持可观察，那么可以使用这种方式来创建可观察数据

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>

对集合的绑定：collections

<data>
    <import type="android.databinding.ObservableList"/>
    <variable name="user" type="ObservableList<Object>"/>
</data>
<TextView android:text="@{user[index]}" ... />

可以直接使用 [] 运算符（ list[0] ）获取对应位置的元素

绑定对象：objects

需要绑定的数据实体类继承 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

LiveData也支持数据绑定

<?xml version="1.0" encoding="utf-8"?>
<layout>
    <data>
        <variable name="desc" type="androidx.lifecycle.MutableLiveData&lt;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&lt;String>" />
    </data>
...
<EditText
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:text="@={input}"/>