Jetpack系列(三) — LiveData

LiveData简单介绍

初步印象

LiveData 具有生命周期感知能力，是一种可观察的数据存储器类

LiveData 遵循其他应用组件（如 Activity、Fragment 或 Service）的生命周期，因此感知只发生在 LifecycleOwner的活跃生命周期状态

基本概念

MutableLiveData 是LiveData 的实现类

MediatorLiveData是MutableLiveData 的实现类

LiveData 基本使用

简单使用

创建LiveData对象， LiveData 是一种可用于任何数据的封装容器，存放在ViewModel当中

class HomeViewModel : ViewModel() {

    private var tapCount = 0

    private var _taps = MutableLiveData<String>("$tapCount taps")

    val taps: LiveData<String>
        get() = _taps

    fun updateTaps() {
        tapCount++
        _taps.postValue("$tapCount taps")
    }
}

观察LiveData 对象

// HomeFragment.kt
private val viewModel: HomeViewModel by viewModels()

// 观察Observer 
viewModel.taps.observe(viewLifecycleOwner, ::tapsUpdate)

private fun tapsUpdate(s: String?) {
    binding.tvCount.text = s ?: ""
}

更新LiveData 对象

MutableLiveData类将公开 setValue(T) 和 postValue(T)方法，

// 触发
binding.btnAdd.setOnClickListener {
    viewModel.updateTaps()
}
复制代码

扩展LiveData

继承LiveData，自定义LiveData 实现扩展功能，重写onActive()和onInactive() 方法

当 LiveData 对象具有活跃观察者时，会调用 onActive() 方法
当 LiveData 对象没有任何活跃观察者时，会调用 onInactive()
setValue(T) 方法将更新 LiveData 实例的值，并将更改告知活跃观察者。

// 官方代码
class StockLiveData(symbol: String) : LiveData<BigDecimal>() {
    private val stockManager: StockManager = StockManager(symbol)

    private val listener = { price: BigDecimal ->
        value = price
    }

    override fun onActive() {
        stockManager.requestPriceUpdates(listener)
    }

    override fun onInactive() {
        stockManager.removeUpdates(listener)
    }

    companion object {
        private lateinit var sInstance: StockLiveData

        @MainThread
        fun get(symbol: String): StockLiveData {
            sInstance = if (::sInstance.isInitialized) sInstance else StockLiveData(symbol)
            return sInstance
        }
    }
}

观察StockLiveData

StockLiveData.get(symbol).observe(viewLifecycleOwner, Observer<BigDecimal> { price: BigDecimal? ->
            // Update the UI.
})

转换LiveData

Lifecycle软件包会提供 Transformations类，可以根据另一个实例的值返回不同的 LiveData 实例，在将 LiveData 对象分派给观察者之前对存储在其中的值进行更改

map() 用于将实际包含数据的LiveData和仅用于观察数据的LiveData进行转换

//User.kt
data class User(var firstName: String, var lastName: String, var age: Int)

//HomeViewModel.kt
class HomeViewModel : ViewModel() {

    private val _userLiveData = MutableLiveData<User>()

    val userName: LiveData<String> = Transformations.map(_userLiveData) { user ->
        "${user.firstName} ${user.lastName}"
    }

    fun updateTaps() { 
        _userLiveData.postValue(User("aa", "bb", 12))
    }
}

switchMap()对存储在 LiveData 对象中的值应用函数

//HomeViewModel.kt
class HomeViewModel : ViewModel() {

    private val _userIdLiveData = MutableLiveData<String>()

    val user: LiveData<User> = Transformations.switchMap(_userIdLiveData) { userId ->
        Repository.getUser(userId)
    }

    fun updateTaps() {
        _userIdLiveData.postValue("cc")
    }
}

// 测试
object Repository {
    fun getUser(userId: String): LiveData<User> {
        val liveData = MutableLiveData<User>()
        liveData.value = User(userId, userId, 0)
        return liveData
    }
}

合并多个 LiveData 源

MediatorLiveData允许合并多个 LiveData 源，适用于一个观察者，多个被观察者

//HomeViewModel.kt
class HomeViewModel : ViewModel() {
    private val _user1 = MutableLiveData<User>()
    private val _user2 = MutableLiveData<User>()

    var mediatorLiveData: MediatorLiveData<User> = MediatorLiveData()

    init {
        mediatorLiveData.addSource(_user1) {
            mediatorLiveData.value = it
        }
        mediatorLiveData.addSource(_user2) {
            mediatorLiveData.value = it
        }
    }

    fun updateTaps() { 
        _user1.postValue(User("ll", "nn", 12))
        _user2.postValue(User("xx", "bb", 12))
    }
}

// HomeFragment.kt
...
private fun subscribeUI() {
    observe(viewModel.mediatorLiveData, ::mediatorLiveDataUpdate)
}

private fun mediatorLiveDataUpdate(user: User?) {
    Log.e("==========","$user")
}