Architecture Components (1) —— LiveData

LiveData is an observable data holder class. Unlike a regular observable, LiveData is lifecycle-aware, meaning it respects the lifecycle of other app components, such as activities, fragments, or services. This awareness ensures LiveData only updates app component observers that are in an active lifecycle state.

LiveData是一个可观察的数据持有类。和普通的可观察对象不同，LiveData具有生命周期感知性——即是说，它会遵循其他应用组件（如Activity、Fragment、Service）的生命周期。这保证了LiveData只会在这些组件活动的时候才去更新它们。

也就是说，LiveData实质上是一个被观察者，而Activity/Fragment等，则是作为观察者。每当LiveData所持有的数据发生改变，LiveData都会通知观察者，从而进行更新UI等操作——这跟RxJava的观察者模式是类似的。

1. LiveData的工作流程

1.1 创建一个LiveData对象。这通常是在ViewModel中进行的。
1.2 创建一个Observer，并实现onChanged()方法。onChanged()方法决定了当数据发生改变的时候需要做的操作，比如更新UI等。
1.3 通过LiveData的observe方法将其和Observer绑定。

当LiveData的数据发生更新时，他会通过setValue(T)/postValue(T)通知所有和他绑定的并且处于活动状态的观察者。

注意：

• LiveData对象应该保存在ViewModel中而不是Activity/Fragment。
• setValue方法必须在主线程调用。如果在子线程，使用postValue方法。

2. 继承LiveData

当一个观察者的状态是Lyfecycle.State.STARTED或者Lyfecycle.State.RESUMED的时候，它被认为是活动状态的。当与LiveData绑定的活动Observer数量从0变为1，则会调用它的onActive()回调；反之，onInactive()回调被调用。

class UserLiveData(val id: String) : LiveData() {
    private val userManager = UserManager()

    override fun onActive() {
        userManager.getUserProfile(id, object : Callback {
            override fun onFailure(call: Call, t: Throwable) {
                t.printStackTrace()
            }

            override fun onResponse(call: Call, response: Response) {
                postValue(response.body())
            }

        })
    }

}

3. 转换LiveData

通过Transformations类来转换LiveData的类型：

    val userLiveData: LiveData = UserLiveData(id)
    val userName : LiveData = Transformations.map(userLiveData) {
        user -> user.username 
    }

4. 使用LiveData类

因为LiveData的setValue/postValue方法不是public的，所以一般在使用LiveData的时候，会建立一个继承自LiveData的子类，或者直接使用MutableLiveData类。

例如，每隔一秒更新一个TextView的内容，可以这么写：

    // 继承方式
    fun subscribeUI() {
        val liveData = CountLiveData()
        liveData.observe(viewLifecycleOwner, Observer { countStr ->
            textView.text = countStr
        })
    }

    class CountLiveData : LiveData() {
        private var count = 0
        private val timer: Timer = Timer()
        private val task = timerTask {
            count++
            postValue(count.toString())
        }

        override fun onActive() {
            timer.schedule(task, 1000, 1000)
        }
    }

也可以直接这么写：

    // MutableLiveData方式
    var count = 0
    val liveData = MutableLiveData()

    fun subscribeUI() {
        val timer = Timer()
        val timerTask = timerTask {
            count++
            liveData.postValue(count.toString())
        }
        timer.schedule(timerTask, 1000, 1000)

        liveData.observe(viewLifecycleOwner, Observer { countStr ->
            textView.text = countStr
        })
    }