“可观测性”是指一个对象将其数据更改通知给其他对象的能力。借助数据绑定库,您可以将对象、字段或集合设为可观察。
您可以使用任何对象进行数据绑定,但修改对象不会自动导致界面更新。您可以使用数据绑定让数据对象能够在数据发生更改时通知其他对象(称为监听器)。可观察类有三种类型:字段、集合和对象。
当其中一个可观察的数据对象绑定到界面并且数据对象的属性发生更改时,界面会自动更新。
可观察字段
如果您的类只有几个属性,则不值得费力创建实现 Observable
接口的类。在这种情况下,您可以使用通用 Observable
类和以下特定于基元的类,使字段可观察:
ObservableBoolean
ObservableByte
ObservableChar
ObservableShort
ObservableInt
ObservableLong
ObservableFloat
ObservableDouble
ObservableParcelable
可观察字段是具有单个字段的自包含可观察对象。原语版本避免在访问操作期间进行装箱和开箱。如需使用此机制,请使用 Java 编程语言创建 public final
属性,或在 Kotlin 中创建只读属性,如以下示例所示:
Kotlin
class User { val firstName = ObservableField<String>() val lastName = ObservableField<String>() val age = ObservableInt() }
Java
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()
访问器方法,或使用 Kotlin 属性语法:
Kotlin
user.firstName = "Google" val age = user.age
Java
user.firstName.set("Google"); int age = user.age.get();
可观察集合
某些应用使用动态结构来保存数据。可观察集合允许使用键访问这些结构。当键是引用类型(例如 String
)时,ObservableArrayMap
类非常有用,如以下示例所示:
Kotlin
ObservableArrayMap<String, Any>().apply { put("firstName", "Google") put("lastName", "Inc.") put("age", 17) }
Java
ObservableArrayMap<String, Object> user = new ObservableArrayMap<>(); user.put("firstName", "Google"); user.put("lastName", "Inc."); user.put("age", 17);
在布局中,您可以使用字符串键查找映射,如以下示例所示:
<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"/>
当键是整数时,ObservableArrayList
类非常有用,如下所示:
Kotlin
ObservableArrayList<Any>().apply { add("Google") add("Inc.") add(17) }
Java
ObservableArrayList<Object> user = new ObservableArrayList<>(); user.add("Google"); user.add("Inc."); user.add(17);
在布局中,您可以通过索引访问列表,如以下示例所示:
<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"/>
可观察对象
实现 Observable
接口的类允许注册监听器,以便监听器接收可观察对象的属性更改通知。
Observable
接口具有添加和移除监听器的机制,但何时发送通知由您决定。为了简化开发,数据绑定库提供了用于实现监听器注册机制的 BaseObservable
类。实现 BaseObservable
的数据类负责在属性发生更改时发出通知。为此,请为 getter 分配一个 Bindable
注解,并在 setter 中调用 notifyPropertyChanged()
方法,如以下示例所示:
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) } }
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); } }
数据绑定会在模块软件包中生成一个名为 BR
的类,其中包含用于数据绑定的资源的 ID。Bindable
注解会在编译期间在 BR
类文件中生成一个条目。如果数据类的基类无法更改,您可以使用 PropertyChangeRegistry
对象实现 Observable
接口,以便高效地注册和通知监听器。
生命周期感知型对象
应用中的布局还可以绑定到数据绑定来源,数据绑定来源会自动通知界面有关数据的变化。这样,您的绑定就能够感知生命周期,并且仅在界面显示在屏幕上时才会触发。
数据绑定支持 StateFlow
和 LiveData
。如需详细了解如何在数据绑定中使用 LiveData
,请参阅使用 LiveData 向界面通知数据更改。
使用 StateFlow
如果您的应用将 Kotlin 与协程搭配使用,您可以使用 StateFlow
对象作为数据绑定来源。如需将 StateFlow
对象与绑定类一起使用,请指定生命周期所有者以定义 StateFlow
对象的范围。以下示例在绑定类实例化后将 activity 指定为生命周期所有者:
class ViewModelActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
// Inflate view and obtain an instance of the binding class.
val binding: UserBinding = DataBindingUtil.setContentView(this, R.layout.user)
// Specify the current activity as the lifecycle owner.
binding.lifecycleOwner = this
}
}
如将布局视图绑定到架构组件中所述,数据绑定可与 ViewModel
对象无缝协作。您可以将 StateFlow
和 ViewModel
一起使用,如下所示:
class ScheduleViewModel : ViewModel() {
private val _username = MutableStateFlow<String>("")
val username: StateFlow<String> = _username
init {
viewModelScope.launch {
_username.value = Repository.loadUserName()
}
}
}
在您的布局中,使用绑定表达式将 ViewModel
对象的属性和方法分配给相应的视图,如以下示例所示:
<TextView
android:id="@+id/name"
android:text="@{viewmodel.username}" />
每当用户的名称值发生更改时,界面都会自动更新。
停用 StateFlow 支持
对于使用 Kotlin 和 AndroidX 的应用,数据绑定会自动包含 StateFlow
支持。这意味着,协程依赖项尚不可用时,会自动包含在您的应用中。
您可以将以下代码添加到 build.gradle
文件中,停用此功能:
Groovy
android { ... dataBinding { addKtx = false } }
Kotlin
android { ... dataBinding { addKtx = false } }
或者,您也可以向 gradle.properties
文件添加以下行,在项目中全局停用 StateFlow
:
Groovy
android.defaults.databinding.addKtx = false
Kotlin
android.defaults.databinding.addKtx = false
其他资源
如需详细了解数据绑定,请参阅下面列出的其他资源:
示例
Codelab
博文
为您推荐
- 注意:当 JavaScript 处于关闭状态时,系统会显示链接文字
- ViewModel 的已保存状态模块
- 将布局视图绑定到架构组件
- Paging 库概览