所谓Data Binding(以下简称DB),就是把数据提供者和消费者绑定起来并实时同步。DB其实并不是安卓所独有的,不过在安卓领域,DB一般指谷歌提供的DB框架,作用就是把数据和UI绑定同步。
在DB出现以前,数据和UI的同步都是靠手动实现。现在,DB能够(部分)替我们完成这项工作。
使用准备
只需在app级的build.gradle
文件内添加以下声明。当然,假如有别的模块使用DB,也要做类似声明。
android {
....
dataBinding {
enabled = true
}
}
据说以前还要添加第三方库依赖,以及对Android Studio的版本有一定要求。具体可以参考官网。
Layout文件的改变
DB要求对layout的XML文件做一定变化,即以<layout ...>
元素开头,之后跟一个<data...>
元素。官网给的例子如下:
<?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}"/>
</LinearLayout>
</layout>
大致可以理解为<data...>
元素里声明的是依赖的数据。声明过的数据在下面就可以使用@{}
符号来表示绑定。
当然,这里还支持一系列的操作符,具体可以参考官网。不过我个人不是很支持在XML文件里面带入过于复杂的逻辑代码,因为调试可能会变得困难,而且编译器对XML的逻辑代码语法支持也不是很完美。
好了,我也不打算把官网文章翻译一遍,还是自己动手搞一个例子吧。
第一个DB项目
使用DB实现一个更改用户名的项目,要求能实现实时同步。
首先看看数据层。DB在这里提供了三种选择,我们需要学习一下来决定采用哪一种:
- Observable Objects。这是对POJO( plain old Java object)对象的绑定,具体实现就是在get方法上面添加标注
@Bindable
。 - ObservableFields。这是对某个成员的绑定,具体做法就是用
public final
修饰的Observable<T>
来包裹成员变量,然后修改和读取方法也有变化,需要使用set和get方法。 - Observable Collections。顾名思义,这是对集合的绑定,例如
ObservableArrayList<T>
和ObservableArrayMap<K, V>
。
不是很理解谷歌的排序,不过今天就用ObservableFields来实现。
数据对象
public class User {
public final ObservableField<String> name = new ObservableField<String>() {};
}
官网教程上是static对象内定义的,事实证明非static的对象内也可以。
Layout文件
我们需要一个EditText
控件来输入,然后一个Button
来显示数据的值,方便知道数据是否真的改变了。
用你自己的包名替换your.package.name。
<?xml version="1.0" encoding="utf-8"?>
<layout
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools">
<data>
<variable name="user" type="your.package.name.User"/>
<variable name="activity" type="your.package.name.MainActivity"/>
</data>
<android.support.constraint.ConstraintLayout
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context="your.package.name.MainActivity">
<EditText
android:layout_width="0dp"
android:layout_height="wrap_content"
android:hint="@string/name"
android:text="@={user.name}"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintLeft_toLeftOf="parent"
app:layout_constraintRight_toRightOf="parent"
app:layout_constraintTop_toTopOf="parent"
android:id="@+id/editText"
android:inputType="textCapWords"
android:layout_marginLeft="16dp"
app:layout_constraintHorizontal_bias="0.0"
android:layout_marginRight="16dp"
android:layout_marginStart="16dp"
android:layout_marginEnd="16dp"/>
<Button
android:onClick="onClick"
android:id="@+id/button"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@string/button"
android:layout_marginTop="8dp"
app:layout_constraintTop_toBottomOf="@+id/editText"
android:layout_marginLeft="8dp"
app:layout_constraintLeft_toLeftOf="parent"
android:layout_marginRight="8dp"
app:layout_constraintRight_toRightOf="parent"
app:layout_constraintBottom_toBottomOf="parent"
android:layout_marginBottom="8dp"
android:layout_marginStart="8dp"
android:layout_marginEnd="8dp"/>
</android.support.constraint.ConstraintLayout>
</layout>
注意我使用了android:text="@={user.name}
,而不是android:text="@{user.name}
,因为后者只是单向绑定。官网关于这一点丝毫未提及,有点坑的。
当然,要用android:text="@{user.name}
也行,不过值的反馈需要自己再写一个@BindingAdapter
注解函数,多少有点麻烦。
另外,我这里Button
直接引用MainActivity
内的onClick(View v)
函数,这个跟DB关系不大。假如不是MainActivity
而是别的什么的话,又是另一种做法了,以后再说。
绑定
MainActivity
public class MainActivity extends AppCompatActivity {
private User user = new User();
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
ActivityMainBinding binding = DataBindingUtil.setContentView(this, R.layout.activity_main);
user.name.set("Mark");
binding.setUser(user);
}
public void onClick(View v) {
Toast.makeText(MainActivity.this, user.name.get(), Toast.LENGTH_SHORT).show();
}
}
绑定其实不难,根据Layout文件的名字,对应的Binding
对象会在名字后面加上Binding。好了,更改名字再按Button
可以发现确实实现了双向绑定。
总结与回顾
- DB的准备工作
- Layout文件
- Layout依赖的声明
- Layout数据的绑定
- 数据层的绑定方式
- ObservableField
- ObservableCollections
- ObservableObjects
- 绑定细节