使用可观察数据对象 [翻译]

官方英文文档:https://developer.android.google.cn/topic/libraries/data-binding/observability

一、介绍

观察能力是指一个对象可以通知别人它的数据已经发生改变的能力。DataBinding库允许你让你的对象、字段、集合具备观察能力。

普通对象可以用于DataBinding,但是它们不会自动通知UI它们发生改变了. DataBinding可以赋予对象在数据改变时通知其他对象的能力 。

二、可观察字段(Observable Fields

当对象只有少量有效字段时,就没有必要创建一个实现Observable接口的类了,对于这种情况,可以使用以下专用类来让字段具备观察能力。

  • ObservableBoolean
  • ObservableByte
  • ObservableChar
  • ObservableShort
  • ObservableInt
  • ObservableLong
  • ObservableFloat
  • ObservableDouble
  • ObservableParcelable

可观察对象只有单个字段,基本类型版本在访问时可以避免自动装箱和自动拆箱,而要使用这一机制,可以如下创建public finalJava属性,或者创建只读read-onlyKotlin属性

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

// kotlin
class User {
    val firstName = ObservableField()
    val lastName = ObservableField()
    val age = ObservableInt()
}

通过setget方法刚问字段值:

// kotlin 
user.firstName = "Google"
val age = user.age

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

Note:Android studio 3.1及以上版本中可以通过使用LiveData来替换可观察字段,并且使用LiveData可以带来额外的好处,具体看 这里.

三、可观察集合

一些应用需要使用动态数据结构来来存储数据,可观察集合允许通过key来访问这些数据结构,如 ObservableArrayMap.

 // Kotlin
ObservableArrayMap().apply {
    put("firstName", "Google")
    put("lastName", "Inc.")
    put("age", 17)
}

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

而在布局中的使用方法如下示例:


    
    


ObservableArrayListkey为整型数据时非常有用,如下:

//Kotlin
ObservableArrayList().apply {
    add("Google")
    add("Inc.")
    add(17)
} 

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

对用在布局中可以通过索引来访问这个列表的数据,如下:


    
    
    


四、可观察对象

实现了Observable接口的类允许注册的监听器接收到它的字段数据发生改变的通知。

Observable接口包含注册和移除监听器的机制,但是我们需要决定什么是时候发送通知,为了方便开发,Databinding库提供了BaseObservable类来实现这个监听器注册机制。继承了BaseObservable的类负责在对象属性改变时发送通知,当给get方法加上@Bindable注解,且在set方法中调用notifyPropertyChanged方法时,这个流程就完成了,如下示例:

// Java
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);
    }
}

// Kotlin
class User : BaseObservable() {

    @get:Bindable
    var firstName: String = ""
        set(value) {
            field = value
            notifyPropertyChanged(BR.firstName)
        }

    @get:Bindable
    var lastName: String = ""
        set(value) {
            field = value
            notifyPropertyChanged(BR.lastName)
        }
}

Data Binding会在模块包生成一个叫做BR的类,它包含了用于数据绑定的资源ID@Bindable注解则会在编译时在BR中生成一个entry。如果数据类仍不能改变,那么可以通过PropertyChangeRegistry对象注册和高效地通知监听器。

关于 Bindable

@Bindable必须作为get方法的注解,如下示例,注意到@Bindable({"firstName", "lastName"}}, 这里可以绑定多个字段,而在这些字段中,当有一个字段被更新后,与之相关联的字段(如这里的name,它依赖于firstNamelastName)都会被视作垃圾数据而被更新。但是这并不意味会onPropertyChanged(Observable, int)会接收到因为BR.name变成垃圾数据而触发的通知,当且仅当绑定表达式(binding expressions)中包含name字段的情况才会被视作垃圾数据并更新

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

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

 @Bindable({"firstName", "lastName"}}
 public void getName() { return this.firstName + ' ' + this.lastName; }

你可能感兴趣的:(使用可观察数据对象 [翻译])