要看本系列其他文章,可访问此链接Jetpack架构学习 | Stars-One的杂货小窝
原文地址:Jetpack架构组件学习(2)——ViewModel和Livedata使用 | Stars-One的杂货小窝
Jetpack架构推荐使用MVVM结构,为此推出了几个MVVM的组件库供我们开发者快速接入,首先要讲的就是ViewModel
个人理解:Activity为View,VM就是ViewModel,负责数据的逻辑处理,Model则是数据源
ViewModel
介绍
ViewModel能做什么?
ViewModel生命周期与Activity独立,可以优雅的保存内存中的数据(在屏幕旋转的横竖屏切换时,数据可以得到保留)
可以将ViewMoel看做是数据的处理器和数据仓库,其只负责处理数据
基本使用
首先,导入依赖
def lifecycle_version = \"2.2.0\"implementation \"androidx.lifecycle:lifecycle-livedata-ktx:$lifecycle_version\"
这里,由于我是使用了Kotlin,所以使用的是具有kotlin特性的版本,如果是纯Java,可以使用下述依赖
def lifecycle_version = \"2.2.0\"implementation \"androidx.lifecycle:lifecycle-livedata-extensions:$lifecycle_version\"
下面来个简单的计数器例子:
class ViewModelActivity : AppCompatActivity() {//4.声明变量lateinit var myViewModel:MyViewModeloverride fun onCreate(savedInstanceState: Bundle?) {super.onCreate(savedInstanceState)setContentView(R.layout.activity_view_model)//5.通过ViewModelProvider获取单一实例对象myViewModel = ViewModelProvider(this).get(MyViewModel::class.java)//7.设置按钮的点击监听器btnPlus.setOnClickListener {myViewModel.countPlus()refreshCount()}refreshCount()}//6.设置更新数据(暂时,后面会调整为livedata形式)fun refreshCount() {tvContent.text = myViewModel.count.toString()}}//1.定义ViewModelclass MyViewModel : ViewModel() {//2.定义数据var count = 0//3.对外暴露方法,用来修改数值fun countPlus() {count++}}
效果如下所示:
为什么上面需要使用ViewmodelProvider来获取单一对象?原因是ViewModel的生命周期是独立于Activity,可以临时保存数据
上述还是使用的比较传统的方式,在对应按钮的点击监听对UI进行修改,之后会使用LiveData进行改造
ViewModel的构造函数传参
由于之前说过ViewModel是单例模式,所以想要传参,需要借助
ViewModelProvider.Factory
这个接口类来实现
假如上面我MainViewModel需要接收一个Activity中传来的参数,我们可以这样写:
3ff8
将原来的MainViewModel类增加个构造方法
class MyViewModel(val saveCount: Int?) : ViewModel() {var count = 0init {//不传参数的话,则默认是0count = saveCount ?: 0}fun countPlus() {count++}}
之后,定义个工厂类
MyViewModelFactory
去实现
ViewModelProvider.Factory
接口
class MyViewModelFactory(val myCount: Int) : ViewModelProvider.Factory {override fun <T : ViewModel?> create(modelClass: Class<T>): T {//这里使用构造方法传参return MyViewModel(myCount) as T}}
PS:可以把
MyViewModelFactory
写在
MyViewModel
中,这样没必要再整多一个文件了
在Activity中,我们需要新建一个
MyViewModelFactory
对象和
ViewModelProvider
一起使用即可,代码如下所示
myViewModel = ViewModelProvider(this,MyViewModelFactory(12)).get(MyViewModel::class.java)
可以看到,现在默认是从12开始了,如下图所示
PS:感觉想要实现Activity中给ViewModel传参的话,步骤是有点多的,不过考虑下架构,这种使用构造方法进行传参其实不太符合MVVM架构。
因为Activity改变数据,触发对应的数据更改即可,而不是在构造方法的时候传参;不过,也可以会有特殊需求(比如说ViewModel中需要context对象),所以才留下了这个实现方式吧
AndroidViewModel(ViewModel扩展类)
上文说到,如果ViewModel中需要Context对象,我们怎么办呢?
经常遇到的情况,是需要获取一个Context上下文对象,可能你想到,我们把当前的Activity传入到ViewModel中不就可以了吗?
这样做虽然是可以,不过会引起其他的问题,会导致ViewModel与Activity耦合过深,原本设计ViewModel就是为了减少耦合,这样做却是本末倒置了
使用ViewModel的时候,需要注意的是ViewModel不能够持有View、Lifecycle、Acitivity引用,而且不能够包含任何包含前面内容的类。因为这样很有可能会造成内存泄漏。
开发团队也是考虑到这样的问题,提供了一个子类
AndroidViewModel
供我们使用,其也是继承于ViewModel,其中存在有个
application
实例(即application对象)
可以看下AndroidViewModel的源码
由于每个APP只有一个application对象,所以就不用担心会出现上述问题
使用的话,和上述是一样,也需要使用到Factory接口,不过无需我们去实现了的,我们使用内置的
ViewModelProvider.AndroidViewModelFactory
这个类即可
具体代码如下所示:
class MyViewModel(application: Application) : AndroidViewModel(application) {fun getCacheDirPath() :String {//MyApplication是我的自定义Application入口类,如果没有使用自定义的Application,这里直接写Application即可var application = getApplication<MyApplication>()//使用application对象获取缓存目录路径return application.cacheDir.path}}
Activity中使用:
myViewModel = ViewModelProvider(this,ViewModelProvider.AndroidViewModelFactory(application)).get(MyViewModel::class.java)
可以看到TextView设置的数值即为路径
进阶用法
- 由于之前提及到ViewModel实际是单例模式的,且生命周期与Activity独立,所以可以使用ViewModel进行Activity和Fragment之间或Fragment之间的数据共享
LiveData
上述ViewModel只是提供了个数据仓库,如果我们使用传统的对象是无法实现MVVM架构的,这个时候就得使用LiveData
LiveData即相当于给数据加多一层包装,让数据可以被观察
由于LiveData内部也是使用的LifeCycle实现的,所以它设计成当数据发生改变时候,只要在页面可见状态才会触发页面改变,节省资源及错误的发生
基本使用
1.导入依赖
首先还是导入依赖,版本与上述使用的版本一致即可,根据项目所属类型选择对应的版本
//kotlin特性版本implementation \"androidx.lifecycle:lifecycle-livedata-ktx:$lifecycle_version\"//Java版本implementation \"androidx.lifecycle:lifecycle-livedata-extensions:$lifecycle_version\"
2.使用
MutableLiveData
来包装数据
LiveData中提供了
MutableLiveData
和
LiveData
两个类用来包装数据,这里先以
MutableLiveData
为例讲解下使用方式,两者的不同在下文再补充
我们以上文为例,稍微修改了(主要修改了
2
、
3
、
7
步)
class ViewModelActivity : AppCompatActivity() {//4.声明变量lateinit var myViewModel:MyViewModeloverride fun onCreate(savedInstanceState: Bundle?) {super.onCreate(savedInstanceState)setContentView(R.layout.activity_view_model)//5.通过ViewModelProvider获取单一实例对象myViewModel = ViewModelProvider(this).get(MyViewModel::class.java)//监听数据,UI更改myViewModel.count.observe(this){tvContent.text = it.toString()}//7.设置按钮的点击监听器btnPlus.setOnClickListener {//点击操作只处罚对应的数据修改,不做更新UI操作myViewModel.countPlus()}}}//1.定义ViewModelclass MyViewModel : ViewModel() {//2.定义数据var count = MutableLiveData<Int>(0)//3.对外暴露方法,用来修改数值fun countPlus() {val value = count.value as Intcount.value = value+1}}
这里的主要区别就是,我们不在点击事件中去更改UI,更改UI的操作则是写了个数据监听方法,去监听数据更改再更新UI
虽然这里感觉还是和之前一样,也是要通过TextView对象去修改数值,但是,从代码上来看,数据处理逻已经和页面渲染分离开来了,也是方便我们的编写测试用例
setValue()
和
postValue()
的区别
上述代码中,我们通过
count.value=value+1
来设置数据,这里由于是kotlin的写法所以看不出来是
setValue()
方法,如果是Java的话,是要调用
setValue()
方法来设置数据
除了
setValue()
,LiveData还提供了
postValue()
方法,这两种的方法区别在于
setValue()
要再主线程(UI线程)才能操作,而
postValue()
则是在子线程或主线程都可以
我们把上述代码中的第7步稍微改动下,点击按钮就开启一个线程,然后等待1s后才更新数据
然后运行的时候报错了,如下图所示
把第3步的设置数据操作改下
就可以正常运行了,点击按钮会等1s后,数据才会发生变化,如下图:
map
此方法主要是将LiveData包装的数据类转为单一另外类型的LiveData,举个例子说明
比如我们有个User类,里面包含两个字段(姓名和年龄),而我们页面只需要观察姓名的改变,而不关心年龄的改变,那么我们就可以没有必要把整个对象都观察
只需要像下面这样写,可以把
MutableLiveData<User>
转为
MutableLiveData<String>
注:以下代码是在ViewMode抽出来的一段代码
data class User(var name: String, var age: Int)//改为private,不对外提供访问private val user = MutableLiveData<User>(User(\"张三\", 5))val userName = Transformations.map(user){ it.name }
之后,我们在Activity只需要对userName数据进行监听,改变UI即可
PS:补充一下,LiveData中是无法做到对对象中的某个字段进行监听,只能做到对对象内存地址进行监听
如果两个对象的内存地址是相同的,那么不会触发对应的数据改变监听事件
若是想要实现,目前个人摸索的方式就是使用koltin扩展方法
copy()
,如下代码,就是快速复制一个对象,且改变其的某个字段的数据,之后即可正常触发数据变更的监听事件
val user = User(\"zz\", 11)val newUser = user.copy(name = \"hello\")
switchMap
前面所讲述内容,LiveData的对象都是都是位于同个ViewModel中,但实际情况,我们需要从别的地方拿取数据,这个时候就是可以考虑使用此方法
假设我们User对象是要通过userId来获取,定义一个单例,实现上述功能
object UserRepository{fun getUserById(userId: String) :LiveData<User>{val userLiveData = MutableLiveData<User>()userLiveData.value = User(\"张三$userId\",15)return userLiveData}}
在ViewModel中定个方法去实现获取数据
class MyViewModel : ViewModel() {fun getUser(userId: String): LiveData<User> {return UserRepository.getUserById(userId)}}
这个时候,我们想要观察这个对象改变从而渲染UI,应该如何做呢?
估计大部分人都会想到下面的代码
myViewModel.getUser(\"111\").observe(this){//todo UI渲染}
但是注意,之前UserRepository中的getUser方法每次返回的都是新的对象,所以每次观察的对象其实都是新的,而无法观察到
改造思路:
- 对userId进行数据监听
- userId变更,同时触发user对象的变更
class MyViewModel : ViewModel() {val userIdLiveData = MutableLiveData(\"\")//user是MutableLiveData<User>对象val user = Transformations.switchMap(userIdLiveData){UserRepository.getUserById(it)}fun getUser(userId: String){userIdLiveData.value = userId}}
Activity中的代码:
myViewModel.user.observe(this){tvContent.text = it.name}//7.设置按钮的点击监听器btnPlus.setOnClickListener {//点击操作只处罚对应的数据修改,不做更新UI操作myViewModel.getUser(\"445\")}
效果如下:
PS:如果是不传参数的,可以设置一个
MutableLiveData<Any?>
对象,并让其重新赋值即可实现更新数据,如下代码
object UserRepository{fun refresh() :LiveData<User>{val userLiveData = MutableLiveData<User>()userLiveData.value = User(\"张三\", 15)return userLiveData}}class MyViewModel : ViewModel() {val refreshLiveData = MutableLiveData<Any?>()fun refresh() {//会触发对应的数据变更通知refreshLiveData.value = refreshLiveData.value}val user = Transformations.switchMap(refreshLiveData){UserRepository.refresh()}}
LiveData和MutableLiveData两者区别
LiveData
是不可变的,
MutableLiveData
是可变的
LiveData
是
MutableLiveData
子类,其里面的
setValue
和
postValue
不是public,因此无法在外部调用,其只能注册观察者
而
MutableLiveData
重写了方法(如下图),并声明为public,所以我们才能在任意地方可以调用进行数值的修改(不过推荐还是在ViewModel中进行数据更改的操作)
代码优化
上述虽然实现了基本的使用,但是ViewModel中的封装的代码还存在不安全性,原因是我们的count变量,只要某个地方拿到了这个ViewModel的对象,就直接拿到这个count变量,从而进行修改
这样就会造成数据问题,所以我们得实现可信任源才能对数据进行修改
官方推荐的做法:
1.ViewModel对外提供不可变的可观察数据LiveData对象
2.由外部调用方法才能改变内部数据
class MyViewModel : ViewModel() {//_count是只能在ViewModel内部修改private val _count =MutableLiveData(0)//对外提供的变量,Activity中可注册观察者从而修改UIval count :LiveData<Int> get() = _count//修改数据的方法fun countPlus() {val value = count.value as Int_count.value = value+1}}
Activity代码没有做任何改变,测试可以发现,效果是一样的,只是优化了代码上的写法
参考
- Android架构之ViewModel组件_冬瓜闯世界的博客-CSDN博客
- 《第一行代码(第3版本)》示例
- Android之ViewModel的使用 – 简书
- MutableLiveData与LiveData区别:可变与不可变 – 简书