前言
本文翻译自【LiveData with SnackBar, Navigation and other events (the SingleLiveEvent case)】，详细介绍了 liveData 的使用。感谢作者 Jose Alcérreca。水平有限，欢迎指正讨论。
前面两篇介绍 LiveData 的文章（【译】Android Architecture - ViewModel 与 View 的通信 和 【译】LiveData 使用详解）都提到了 SingleLiveEvent，本篇重点来看下它是个什么东西，以及它的使用场景。
正文
LiveData 一般被用于 View 与 ViewModel 的通信。View 通过订阅 LiveData 的变化来更新 UI，这适用于需要长时间展示在屏幕上的数据。
然而，有些数据可能只需要展示一次，例如 SnackBar 消息，一个 Navigation 事件，或者一个触发 Dialog 展示/消失的数据。
我们不应该尝试用 Architecture Components 基础或扩展库来解决这个问题，相反这是一个设计问题。我们建议你将这些事件作为数据状态的一部分。在本文中，我们将展示一些常见错误和推荐方法。
❌ Bad: 1. Using LiveData for events
这种用法是在 LiveData 中保存一个 SnackBar 消息，或一个 Navigation 事件。尽管原则上是 LiveData 的正常使用，但这存在一些问题。
在一个包含首页和详情页的应用中，首页的 ListViewModel.kt 代码如下：
// Don't use this for events
class ListViewModel : ViewModel {
private val _navigateToDetails = MutableLiveData<Boolean>()
val navigateToDetails : LiveData<Boolean>
get() = _navigateToDetails
fun userClicksOnButton() {
_navigateToDetails.value = true
}
}
MyFragment.kt 代码如下：
myViewModel.navigateToDetails.observe(this, Observer {
if (it) startActivity(DetailsActivity...)
})
这种使用方式的问题是：_navigateToDetails 中的值会永远为 true，从而导致无法回到首页。
复现步骤是：
- 用户点击按钮，启动详情页
DetailsActivity - 用户点击返回键，返回到主界面
MasterActivity - 这时
MasterActivity由非活动状态恢复到活动状态 - 但
myViewModel观察到_navigateToDetails仍旧为true，就又跳转到详情页DetailsActivity
一种看起来没问题的解决方案是：页面跳转后立马把标志位设为 false，如 ListViewModel.kt 所示：
fun userClicksOnButton() {
_navigateToDetails.value = true
_navigateToDetails.value = false // Don't do this
}
然而，需要注意的是：LiveData 不能保证发射它接收到的每个数据值。例如我们在没有活动的观察者时设置了一个新值，这个新值不会被发送，此外，在多个子线程中操作 LiveData 可能发生竞争状况，从而导致观察者只会收到一次回调。
但这个方案的主要问题是：别人很难看懂这个代码，并且这种代码也很丑陋。那么，我们应该怎么确保在导航事件发生后恢复初值呢？
❌ Better: 2. Using LiveData for events, resetting event values in observer
另一种稍微好点，但仍有问题的方案是：View 告诉 ViewModel，导航事件已经完成，LiveData 应该恢复默认值了。
Usage
基于第一节的例子，对观察者代码做如下改动即可，MyFragment.kt：
listViewModel.navigateToDetails.observe(this, Observer {
if (it) {
myViewModel.navigateToDetailsHandled()
startActivity(DetailsActivity...)
}
})
然后在 ListViewModel.kt 中添加一个 navigateToDetailsHandled() 方法：
class ListViewModel : ViewModel {
private val _navigateToDetails = MutableLiveData<Boolean>()
val navigateToDetails : LiveData<Boolean>
get() = _navigateToDetails
fun userClicksOnButton() {
_navigateToDetails.value = true
}
fun navigateToDetailsHandled() {
_navigateToDetails.value = false
}
}
Issues
这种方法的问题是：存在很多样板代码，ViewModel 中每添加一个事件都要添加一个对应的方法，并且很容易出错。此外，观察者（View）很容易忘记调用 ViewModel 的这个方法。
✅ OK: Use SingleLiveEvent
一种还可以接受的解决方案是：SingleLiveEvent。这个类是 Google 官方 Demo 中的适用于这种特殊场景的解决方案，它是一个仅发送一次更新的 LiveData。
public class SingleLiveEvent<T> extends MutableLiveData<T> {
private static final String TAG = "SingleLiveEvent";
private final AtomicBoolean mPending = new AtomicBoolean(false);
@MainThread
public void observe(LifecycleOwner owner, final Observer<T> observer) {
if (hasActiveObservers()) {
Log.w(TAG, "Multiple observers registered but only one will be notified of changes.");
}
// Observe the internal MutableLiveData
super.observe(owner, new Observer<T>() {
@Override
public void onChanged(@Nullable T t) {
if (mPending.compareAndSet(true, false)) {
observer.onChanged(t);
}
}
});
}
@MainThread
public void setValue(@Nullable T t) {
mPending.set(true);
super.setValue(t);
}
/**
* Used for cases where T is Void, to make calls cleaner.
*/
@MainThread
public void call() {
setValue(null);
}
}
Usage
ListViewModel.kt 代码如下：
class ListViewModel : ViewModel {
private val _navigateToDetails = SingleLiveEvent<Any>()
val navigateToDetails : LiveData<Any>
get() = _navigateToDetails
fun userClicksOnButton() {
_navigateToDetails.call()
}
}
MyFragment.kt 代码如下：
myViewModel.navigateToDetails.observe(this, Observer {
startActivity(DetailsActivity...)
})
Issues
SingleLiveEvent 的问题在于：它仅限于一个观察者。如果你无意中添加了多个，则只会有一个收到回调，并且无法保证哪一个会收到。
✅ Recommended: Use an Event wrapper
推荐的解决方案是：封装事件。通过这种方式，我们可以明确地管理实践是否被处理，从而减少错误。
Usage
Event.kt 封装了事件，代码如下：
/**
* Used as a wrapper for data that is exposed via a LiveData that represents an event.
*/
open class Event<out T>(private val content: T) {
var hasBeenHandled = false
private set // Allow external read but not write
/**
* Returns the content and prevents its use again.
*/
fun getContentIfNotHandled(): T? {
return if (hasBeenHandled) {
null
} else {
hasBeenHandled = true
content
}
}
/**
* Returns the content, even if it's already been handled.
*/
fun peekContent(): T = content
}
ListViewModel.kt 代码如下：
class ListViewModel : ViewModel {
private val _navigateToDetails = MutableLiveData<Event<String>>()
val navigateToDetails : LiveData<Event<String>>
get() = _navigateToDetails
fun userClicksOnButton(itemId: String) {
_navigateToDetails.value = Event(itemId) // Trigger the event by setting a new Event as a new value
}
}
MyFragment.kt 代码如下：
myViewModel.navigateToDetails.observe(this, Observer {
// Only proceed if the event has never been handled
it.getContentIfNotHandled()?.let {
startActivity(DetailsActivity...)
}
})
这种方案的优势在于：用户需要调用 Event#getContentIfNotHandled() 方法或 Event#peekContent() 来指定跳转 Intent。这种方案将事件作为 UI 状态的一部分：现在它们只是一个已被消费或未被消费的消息。
总结
design events as part of your state. 我们可以包装自己的 Event 来满足自己的需求。
Bonus! 如果有很多事件，可以使用 EventObserver 避免一些样板代码。
评论中的问题
//TODO
