美文网首页
Data Binding Library官网文档翻译 3 - 使

Data Binding Library官网文档翻译 3 - 使

作者: kirito0424 | 来源:发表于2018-07-22 23:21 被阅读9次

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接口,以有效地注册和通知侦听器。

相关文章

网友评论

      本文标题:Data Binding Library官网文档翻译 3 - 使

      本文链接:https://www.haomeiwen.com/subject/lkarmftx.html