Android MVVM 系列之 Databinding（二）

Android MVVM 系列之 Databinding（二）

这篇文章主要写关于 Databinding 核心功能之一：实现可观察的数据（Observable）

可观察性是指对象通知其他人数据变化的能力。数据绑定库允许您创建可观察的对象，字段或集合。

通俗来讲，任何普通的对象都可以用于数据绑定，但修改对象不会自动导致UI更新。数据绑定可用于为您的数据对象提供在数据更改时通知其他对象（称为侦听器）的功能。有三种不同类型的可观察类： 对象，字段和 集合。

当这些可观察数据对象绑定到UI并且数据对象的属性更改时，UI将自动更新（单向绑定）。
[TOC]

单向数据绑定

实现可观察的变量（ObservableField）

Databinding 库提供了一系列可观察的类来包装数据
- ObservableBoolean
- ObservableByte
- ObservableChar
- ObservableShort
- ObservableInt
- ObservableLong
- ObservableFloat
- ObservableDouble
- ObservableParcelable
- ObservableField 如果使用包装类型的话

Observable 字段是具有单个字段的独立可观察对象。要使用这些类的话，请使用public final 关键字来修饰（Google 官方写法），例：

public class User2 {
    //这里同样有两个个属性，不同的是它使用 ObservableField
    public final ObservableField<String> name = new ObservableField<>();
    public final ObservableInt age = new ObservableInt();
}

如果要访问字段里面的值，请使用 get() 和 set() 方法，例：

    user2.name.set("张三");
    user2.age.set(18);
    String name = user2.name.get();
    int age = user2.age.get();

有些应用程序使用 Map 结构来保存数据。比如下面的例子：

ObservableArrayMap<String, Object> user = new ObservableArrayMap<>();
user.put("name", "王五");
user.put("age", 17);

还有使用数组的：

ObservableArrayList<Object> user = new ObservableArrayList<>();
user.add("哈姆雷同");
user.add(1000);

在布局中监听变化的数据

我们实现了上面的代码以后，就要检测一下 UI 布局是不是能自动刷新了

示例代码：

    ActivityMain2Binding binding = DataBindingUtil.setContentView(this, R.layout.activity_main2);

    User2 user2 = new User2();
    user2.age.set(1000);
    user2.name.set("haruipote");
    binding.setUser(user2);
    binding.setEvent(new EventHandler());

    public void changeName(User2 user2, String name){
        user2.name.set(name);
    }

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">

    <data>

        <variable
            name="event"
            type="com.xxj.mvvm.demo.android_mvvm_demo.EventHandler" />

        <variable
            name="user"
            type="com.xxj.mvvm.demo.android_mvvm_demo.bean.User2" />
    </data>

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical">

        <Button
            android:text="改名字啦"
            android:onClick='@{() -> event.changeName(user, "Peter")}'
            android:layout_width="wrap_content"
            android:layout_height="wrap_content" />

        <TextView
            android:layout_width="200dp"
            android:layout_height="50dp"
            android:gravity="center"
            android:text='@{user.name}' />

        <TextView
            android:layout_width="200dp"
            android:layout_height="50dp"
            android:gravity="center"
            android:text="@{String.valueOf(user.age)}" />
    </LinearLayout>
</layout>

可观察的对象

Databinding 库提供了 Observable 接口，实现此接口便可添加想要通知可观察对象的属性更改的侦听器（PropertyChangeRegistry），Observable接口具有添加和删除侦听器的机制。

为了使开发更容易，数据绑定库提供了 BaseObservable 实现监听器注册机制的类。实现的数据类BaseObservable负责通知属性何时更改。通过给 getter 添加一个注解并在 setter 中调用 notifyPropertyChanged() 方法来完成，例：

public class User3 extends BaseObservable{
    private String name;
    private int age;

    @Bindable
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
        notifyPropertyChanged(BR.name);
    }

    @Bindable
    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
        notifyPropertyChanged(BR.age);
    }
}

Databinding 会在 Model 模块中生成一个 BR 命名的类，其中包含用于数据绑定的资源的 ID。它在添加 @Bindable 注解后产生一个资源 ID 。如果不能更改数据类的基类，则 可以使用实现 Observable 接口的方式来实现。

public class User4 implements Observable{
    private String name;
    private int age;
    private transient PropertyChangeRegistry mCallbacks;

    @Override
    public void addOnPropertyChangedCallback(@NonNull OnPropertyChangedCallback callback) {
        synchronized (this) {
            if (mCallbacks == null) {
                mCallbacks = new PropertyChangeRegistry();
            }
        }
        mCallbacks.add(callback);
    }

    @Override
    public void removeOnPropertyChangedCallback(@NonNull OnPropertyChangedCallback callback) {
        synchronized (this) {
            if (mCallbacks == null) {
                return;
            }
        }
        mCallbacks.remove(callback);
    }

    public void notifyChange() {
        synchronized (this) {
            if (mCallbacks == null) {
                return;
            }
        }
        mCallbacks.notifyCallbacks(this, 0, null);
    }

    public void notifyPropertyChanged(int fieldId) {
        synchronized (this) {
            if (mCallbacks == null) {
                return;
            }
        }
        mCallbacks.notifyCallbacks(this, fieldId, null);
    }
    @Bindable
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
        notifyPropertyChanged(BR.name);
    }

    @Bindable
    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
        notifyPropertyChanged(BR.age);
    }
}

代码多，怕不怕？

其实代码就在 BaseObservable 类中，原样抄过来，或者最好封装到自己的基类中（本人项目中用到的就是这种方式）。这些方法的原理什么的先就不和大家讲了，相信大家在使用的过程中爬的坑多了[:奸笑]肯定能了解其中的含义的，如果后续有时间的话会补上详解的。

双向数据绑定

既然有单向绑定就肯定有双向绑定，双向绑定也时 DataBinding 的核心功能之一，我们上边的代码实现了 Java 代码到 UI 布局的绑定，其实 Databinding 还能实现 UI 布局到 Java 代码的双向绑定，是不是很强大啊，嘿嘿。

实现双向绑定很简单，只需要把 @{} 换成 @={} 就可以了，这样的话当 UI 发生改变时，它所绑定的变量会同步改变的，比如 Edittext 的内容，Checkbox 的 check 状态等它们的值改变后相应的 Java 代码中的值也会相应改变，我们可以实现 checkbox 选中改变时更改布局之类的功能，后面使用 MVVM 架构的时候会大量用到的，这里我就懒得提供例子了，大家自己去实践下

高级绑定

在上一篇文章中为了避免一次性讲太多东西，我把 RecyclerView 中使用 Databinding 的方法放到这里了

有时，特定的绑定类是未知的。例如，RecyclerView.Adapter 针对任意布局的操作不知道特定的绑定类。它仍然必须在调用 onBindViewHolder() 方法期间分配绑定值。

在以下示例中，所有RecyclerView绑定具有 item变量的布局。该BindingHolder对象有一个getBinding()返回ViewDataBinding基类的方法 。

public void onBindViewHolder(BindingHolder holder, int position) {
  final T item = mItems.get(position);
  holder.getBinding().setVariable(BR.item, item);
  holder.getBinding().executePendingBindings();
}

当变量或可观察对象发生更改时，绑定会安排在下一帧之前更改。然而，有时候，绑定必须立即执行。要强制执行，请使用该 executePendingBindings() 方法。

demo 传送门