Data Binding Library官网文档翻译 3 - 使用可观察数据

Work with observable data objects - 使用可观察的数据对象

这一篇是整个系列的第三篇翻译，像上一篇一样，翻译不准确的地方欢迎大家批评指正。同样附上官网链接。同时，转载请注明出处，https://www.jianshu.com/p/210f9331f3b2

首先解释一下什么是可观察性，他指的是一个对象在他的data数据变化时可以通知别人的能力。data binding可以帮助你创建可观察的对象，变量和集合。

Data binding当然也可以使用老式的对象，但是这样的话修改对象时不会自动的修改UI。data binding赋予了数据对象在数据变化时，通知别的对象的能力(这里的被通知的对象就是Listener)。

Data binding中一共有三种不同类型的可观察类： objects, fields, 和 collections.。当一个可观察数据对象绑定到UI，并且数据对象的属性发生变化时，UI将自动更新。

1. Observable fields 可观察的类变量

实现Observable接口需要额外的工作量。如果你的数据类中只有少数几个属性，那么这种方式是不值得的。在这种情况下，您可以使用以下的类，来创建可观察字段：

ObservableBoolean
ObservableByte
ObservableChar
ObservableShort
ObservableInt
ObservableLong
ObservableFloat
ObservableDouble
ObservableParcelable

Observable fields是具有单个字段的自包含可观察对象。原始版本在访问操作期间避免装箱和拆箱。要使用此机制，请在Java中创建 public final 的属性，或在Kotlin中创建只读属性，如以下示例所示：

private static class User {
    public final ObservableField<String> firstName = new ObservableField<>();
    public final ObservableField<String> lastName = new ObservableField<>();
    public final ObservableInt age = new ObservableInt();
}

如果要访问变量的值，可以使用set()和get()方法

user.firstName.set("Google");
int age = user.age.get();

注意：Android Studio 3.1以上版本允许使用LiveData对象替换Observable fields，还带来了额外的好处。有关更多信息，请参阅Use LiveData to notify the UI about data changes。

2. Observable collections 可观察集合

一些应用程序使用动态结构来保存数据。可观察集合允许使用key访问这些结构。当key是引用类型（如String）时，ObservableArrayMap类非常有用，如以下示例所示

ObservableArrayMap<String, Object> user = new ObservableArrayMap<>();
user.put("firstName", "Google");
user.put("lastName", "Inc.");
user.put("age", 17);

// layout中的使用
<data>
    <import type="android.databinding.ObservableMap"/>
    <variable name="user" type="ObservableMap<String, Object>"/>
</data>
…
<TextView
    android:text="@{user.lastName}"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"/>
<TextView
    android:text="@{String.valueOf(1 + (Integer)user.age)}"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"/>

下面再举一个例子，当key时integer类时，我们可以使用ObservableArrayList

ObservableArrayList<Object> user = new ObservableArrayList<>();
user.add("Google");
user.add("Inc.");
user.add(17);

// layout中可以使用通过index来访问对应数据
<data>
    <import type="android.databinding.ObservableList"/>
    <import type="com.example.my.app.Fields"/>
    <variable name="user" type="ObservableList<Object>"/>
</data>
…
<TextView
    android:text='@{user[Fields.LAST_NAME]}'
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"/>
<TextView
    android:text='@{String.valueOf(1 + (Integer)user[Fields.AGE])}'
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"/>

3. Observable objects 可观察的对象

实现Observable接口的类，允许注册一个在Observable objects的属性更改时可以被通知到的Listener。

Observable接口本身有添加移除监听器的机制，但是你必须决定何时发送通知。

为了使用方便，Data Binding Library提供了BaseObservable类，这个类已经实现了监听器的注册机制。实现了BaseObservable接口的数据类，需要在属性变化的时候进行通知。

通过下面的例子可以了解到，这是通过在get方法中使用@Bindable注解，set方法中使用notifyPropertyChanged()实现的。

private static class User extends BaseObservable {
    private String firstName;
    private String lastName;

    @Bindable
    public String getFirstName() {
        return this.firstName;
    }

    @Bindable
    public String getLastName() {
        return this.lastName;
    }

    public void setFirstName(String firstName) {
        this.firstName = firstName;
        notifyPropertyChanged(BR.firstName);
    }

    public void setLastName(String lastName) {
        this.lastName = lastName;
        notifyPropertyChanged(BR.lastName);
    }
}

Data binding会在module package中生成一个BR文件，包含了所有data binding中使用到的资源id。Bindable注解会在编译的时候在BR类中生成一个entry。如果数据类的基类无法修改，则可以使用PropertyChangeRegistry对象实现Observable接口，以有效地注册和通知侦听器。