源码解读抽丝剥茧的分析ViewModel的核心原理
Posted 丶笑看退场
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了源码解读抽丝剥茧的分析ViewModel的核心原理相关的知识,希望对你有一定的参考价值。
ViewModel背景
ViewModel 类旨在以注重生命周期的方式存储和管理界面相关的数据。ViewModel类让数据可在发生屏幕旋转等配置更改后继续留存。
摘自
ViewModel
概览
详细讲,ViewModel有如下几个特点:
- 对于简单数据,Activity被销毁的时候,可以使用onSaveInstanceState()方法从onCreate中恢复其绑定数据,但不适用数量较大的数据,如用户列表或位图。而Viewmodel支持大量数据,也不需要序列化和反序列化操作。
- 视图控制器经常需要进程可能需要一些时间才能返回的异步调用。界面控制器需要管理这些调用,并确保系统在其销毁后清理这些调用以避免潜在的内存泄漏。而Viewmodel可以很好的避免内存泄漏。
- 如果要求界面控制器也负责从数据库或网络加载数据,那么会使类越发膨胀。为界面控制器分配过多的责任可能会导致单个类尝试自己处理应用的所有工作,而不是将工作委托给其他类。而Viewmodel可以有效的将视图数据逻辑和视图控制器分离开来。
可以看出来VIewmodel是以感知生命周期的形式来存储和管理视图等相关的数据。
基本使用
对Viewmodel的特点有了初步了解后,开始简单操作下。
自定义数据获取类
class TestRepository
suspend fun getNameList(): List<String>
return withContext(Dispatchers.IO)
listOf("哈哈", "呵呵")
自定义ViewModel继承ViewMode,实现自定义ViewModel。
class TestViewModel: ViewModel()
private val nameList = MutableLiveData<List<String>>()
val nameListResult: LiveData<List<String>> = nameList
private val testRepository = TestRepository()
fun getNames()
viewModelScope.launch
nameList.value = testRepository.getNameList()
创建了MutableLiveData,并通过MutableLiveDat的setVale方法来更新数据。
然后就可以在Activity中使用TestViewModel了。
class MainActivity : AppCompatActivity()
// 创建 ViewModel 方式 1
// 通过 kotlin 委托特性创建 ViewModel
// 需添加依赖 implementation 'androidx.activity:activity-ktx:1.2.3'
// viewModels() 内部也是通过 创建 ViewModel 方式 2 来创建的 ViewModel
private val mainViewModel: TestViewModel by viewModels()
override fun onCreate(savedInstanceState: Bundle?)
super.onCreate (savedInstanceState)
setContentView(R.layout.activity_main)
// 创建 ViewModel 方式 2
val mainViewModel = ViewModelProvider(this).get(TestViewModel::class.java)
mainViewModel.nameListResult.observe(this,
Log.i("MainActivity", "mainViewModel: nameListResult: $it")
)
mainViewModel.getNames()
通过ViemodelProvider配合就可以获得TestViewModel对象,并配合LiveData来观察其变化。通过日志打印我们得到了:
maiinViewModel: nameListResult: [哈哈, 呵呵]
我们再旋转下手机,发现打印出来的信息仍然存在。
maiinViewModel: nameListResult: [哈哈, 呵呵]
说明即使MainActivity被重建了,而ViewModel的实例对象依然存在,内部的LiveData也没有变,是不是很神奇!!!
Activity旋转屏幕后ViewModel可以恢复数据又是如何实现的? 现在就让我们一起来分析下它的源码。
源码分析
Viewmodel的创建
首先我们来看下Viewmodel是怎么被创建的。
从上面可以得知,创建Viewmodel的方式是:
val mainViewModel = ViewModelProvider(this).get(TestViewModel::class.java)
传入class类型,然后得到了ViewModel。看下ViewModelProcider的构造函数:
### ViewModelProvider
public ViewModelProvider(@NonNull ViewModelStoreOwner owner)
//得到了ViewModelStore
this(owner.getViewModelStore(), owner instanceof HasDefaultViewModelProviderFactory
? ((HasDefaultViewModelProviderFactory) owner).getDefaultViewModelProviderFactory()
: NewInstanceFactory.getInstance());
//缓存了ViewModerStore
public ViewModelProvider(@NonNull ViewModelStore store, @NonNull Factory factory)
mFactory = factory;
mViewModelStore = store;
这里我们看到他得到了ViewmodelStore
。可以是我们传进去的只是Activity实例,那ViewModelStoreOwner
又是什么?
//拥有 ViewModelStore 的范围。
//此接口的实现的职责是在配置更改期间保留拥有的 ViewModelStore,
//并在此范围将被销毁时调用 ViewModelStore.clear()。
public interface ViewModelStoreOwner
/**
* Returns owned @link ViewModelStore
*
* @return a @code ViewModelStore
*/
@NonNull
ViewModelStore getViewModelStore();
ViewModelStoreOwner是个接口,再来看下ComponentActivity
是不是对它进行了实现:
public class ComponentActivity extends androidx.core.app.ComponentActivity implements
LifecycleOwner,
ViewModelStoreOwner,
HasDefaultViewModelProviderFactory,
SavedStateRegistryOwner,
OnBackPressedDispatcherOwner
......
//实现了ViewModelStoreOwner, 重写了getViewModelStore方法
public ViewModelStore getViewModelStore()
if (getApplication() == null)
//里面内容下面分析
....
return mViewModelStore;
原来ComponentActivity实现了ViewModelStoreOwner接口。
回到例子中,ViewModelProvider(this).get(TestViewModel::class.java)
中的get方法又做了什么?
### ViewModelProvider
public <T extends ViewModel> T get(@NonNull Class<T> modelClass)
String canonicalName = modelClass.getCanonicalName();
if (canonicalName == null)
throw new IllegalArgumentException("Local and anonymous classes can not be ViewModels");
//拿到key, 也就是ViewmodelStore中的Map用于存ViewModel的key
return get(DEFAULT_KEY + ":" + canonicalName, modelClass);
public <T extends ViewModel> T get(@NonNull String key, @NonNull Class<T> modelClass)
//获取到ViewModel实例
ViewModel viewModel = mViewModelStore.get(key);
if (modelClass.isInstance(viewModel))
if (mFactory instanceof OnRequeryFactory)
((OnRequeryFactory) mFactory).onRequery(viewModel);
//返回缓存的ViewModel对象
return (T) viewModel;
else
if (viewModel != null)
//使用工厂模式创建 ViewModel 实例
if (mFactory instanceof KeyedFactory)
viewModel = ((KeyedFactory) (mFactory)).create(key, modelClass);
else
viewModel = (mFactory).create(modelClass);
//将创建的 ViewModel 实例放进 mViewModelStore 缓存中
mViewModelStore.put(key, viewModel);
return (T) viewModel;
先尝试从ViewModelStore获取ViewModel实例,如果没有获取到,就使用Factory创建,创建出的ViewModel最后都会存放到mViewModelStore中,我们再来看下ViewModelStore这个类做了什么:
### ViewModelStore
public class ViewModelStore
//内部由HashMap进行存储
private final HashMap<String, ViewModel> mMap = new HashMap<>();
final void put(String key, ViewModel viewModel)
ViewModel oldViewModel = mMap.put(key, viewModel);
if (oldViewModel != null)
oldViewModel.onCleared();
final ViewModel get(String key)
return mMap.get(key);
Set<String> keys()
return new HashSet<>(mMap.keySet());
//调用viewModel的clear方法,然后清除ViewModel
public final void clear()
for (ViewModel vm : mMap.values())
vm.clear();
mMap.clear();
在ViewModelStore中就做了将viewModel作为value存储到HashMap中。
看了VIewModel是怎么创建出来的,以及实例缓存到那里,再来看下ViewModelStore又是如何创建的。
ViewmodelStore的创建
再次返回到上面getViewModelStore方法里面看下:
### ComponentActiivty
public ViewModelStore getViewModelStore()
if (getApplication() == null)
throw new IllegalStateException("Your activity is not yet attached to the "
+ "Application instance. You can't request ViewModel before onCreate call.");
if (mViewModelStore == null)
//获得 NonConfigurationInstances
NonConfigurationInstances nc =
(NonConfigurationInstances) getLastNonConfigurationInstance();
if (nc != null)
// 从 NonConfigurationInstances 恢复 ViewModelStore
mViewModelStore = nc.viewModelStore;
if (mViewModelStore == null)
mViewModelStore = new ViewModelStore();
return mViewModelStore;
先从NonConfigurationInstances
中获取VIewModelStore实例,如果不存在,则会创建一个新的ViewModelSotre。这里我们知道了,创建出的ViewModelStore
会缓存到NonConfigurationInstances
中。那ViewModelStore
又是什么时候缓存进去的。
来看下getLastNonConfigurationInstance方法:
### Activity
//先前由 onRetainNonConfigurationInstance() 返回的对象
/**
* Retrieve the non-configuration instance data that was previously
* returned by @link #onRetainNonConfigurationInstance(). This will
* be available from the initial @link #onCreate and
* @link #onStart calls to the new instance, allowing you to extract
* any useful dynamic state from the previous instance.
*
* <p>Note that the data you retrieve here should <em>only</em> be used
* as an optimization for handling configuration changes. You should always
* be able to handle getting a null pointer back, and an activity must
* still be able to restore itself to its previous state (through the
* normal @link #onSaveInstanceState(Bundle) mechanism) even if this
* function returns null.
*
* <p><strong>Note:</strong> For most cases you should use the @link Fragment API
* @link Fragment#setRetainInstance(boolean) instead; this is also
* available on older platforms through the Android support libraries.
*
* @return the object previously returned by @link #onRetainNonConfigurationInstance()
*/
public Object getLastNonConfigurationInstance()
return mLastNonConfigurationInstances != null
? mLastNonConfigurationInstances.activity : null;
通过上面注释可以知道mLastNonConfigurationInstances
是由onRetainNonConfigurationInstance
返回的。
onRetainNonConfigurationInstance
又是在什么时候被调用的?最终被我们找到了:
###ActivityThread
void performDestroyActivity(ActivityClientRecord r, boolean finishing,
int configChanges, boolean getNonConfigInstance, String reason)
......
if (getNonConfigInstance)
try
r.lastNonConfigurationInstances = r.activity.retainNonConfigurationInstances();
catch (Exception e)
if (!mInstrumentation.onException(r.activity, e))
throw new RuntimeException("Unable to retain activity "
+ r.intent.getComponent().toShortString() + ": " + e.toString(), e);
......
在performDestroyActivity
方法中会被调用,可以看到onRetainNonConfigurationInstance
方法返回的Object会赋值给ActivityClientRecord
的lastNonConfigurationInstances
,这样子就保存了下来。再来看下onRetainNonConfigurationInstance
方法。
### ComponetActivity
//配置发生更改的时候调用
//保留所有适当的非配置状态
public final Object onRetainNonConfigurationInstance()
Object custom = onRetainCustomNonConfigurationInstance();
ViewModelStore viewModelStore = mViewModelStore;
if (viewModelStore == null)
//没有人调用 getViewModelStore(),所以看看我们上一个 NonConfigurationInstance 中是否存在现 //有的 ViewModelStore
NonConfigurationInstances nc =
(NonConfigurationInstances) getLastNonConfigurationInstance();
if (nc != null)
viewModelStore = nc.viewModelStore;
if (viewModelStore == null && custom == null)
return null;
//创建 NonConfigurationInstances 对象,并赋值 viewModelStore
NonConfigurationInstances nci = new NonConfigurationInstances();
nci.custom = custom;
nci.viewModelStore = viewModelStore;
return nci;
到这里我们知道了,Activity在应为配置发生更改销毁重建的时候会调用onRetainNonConfigurationInstance
将ViewModelStore实例保存到NonConfigurationInstances
中。之后再重建的时候就可以通过getLastNonConfigurationInstance
方法来获取之前缓存的ViewModelStore实例。
NonConfigurationInstances
又是什么,怎么可以在销毁重建的时候还一直保留?来看下NonConfigurationInstances
保存在哪里,先看下在哪里被赋值的。
### Activity
final void attach(Context context, ActivityThread aThread,
Instrumentation instr, IBinder token, int ident,
Application application, Intent intent, ActivityInfo info,
CharSequence title, Activity parent, String id,
NonConfigurationInstances lastNonConfigurationInstances,
Configuration config, String referrer, IVoiceInteractor voiceInteractor,
Window window, ActivityConfigCallback activityConfigCallback, IBinder assistToken,
IBinder shareableActivityToken)
......
//在attach方法中会进行赋值
mLastNonConfigurationInstances = lastNonConfigurationInstances;
......
mLastNonConfigurationInstances
是在Activity的attach方法中赋值。
### ActivityThread
private Activity performLaunchActivity(ActivityClientRecord r, Intent customIntent)
ActivityInfo aInfo = r.activityInfo;
if (r.packageInfo == null)
r.packageInfo = getPackageInfo(aInfo.applicationInfo, r.compatInfo,
Context.CONTEXT_INCLUDE_CODE);
······
//由ActivityClientRecord中获得
activity.attach(appContext, this, getInstrumentation(), r.token,
r.ident, app, r.intent, r.activityInfo, title, r.parent,
r.embeddedID, r.lastNonConfigurationInstances, config,
r.referrer, r.voiceInteractor, window, r.configCallback,
r.assistToken, r.shareableActivityToken);
......
在Activity
的performLaunchActivity
方法中,可以看到lastNonConfigurationInstances
是保存在ActivityClientRecord中
的。
又因为界面在销毁的时候调用performDestroyActivity
方法,内部又会调用Activity
的retainNonConfigurationInstances
方法将lastNonConfigurationInstances
缓存到ActivityClientRecord中,也就是存到应用本身的进程中了。
所以页面在销毁重建的时候,保存在ActivityClientRecord
中的lastNonConfigurationInstances
是不会受到影响的。
到这里我们也知道在Activity因配置更改重建后ViewModel
依然存在的原因了。
ViewModel的销毁
我们已经知道了,在ViewmodelStore
中会调用viewmodle的clear方法。
###ViewModelStore
public class ViewModelStore
......
public final void clear()
for (ViewModel vm : mMap.values())
vm.clear();
mMap.clear();
遍历缓存中viewmodel依次调用,那ViewModelStore的clear
方法又是什么时候调用的?
### ComponentActivity
public ComponentActivity()
......
getLifecycle().addObserver(new LifecycleEventObserver()
@Override
public void onStateChanged(@NonNull LifecycleOwner source,
@NonNull Lifecycle.Event event)
//activity生命周期处于destory状态
if (event == Lifecycle.Event.ON_DESTROY)
//非配置发生改变
if (!isChangingConfigurations())
getViewModelStore().clear();
);
这里我们看到调用ViewModelStore
中的clear方法被调用的条件首先要观察当前的生命周期处于DESTORY
,另外检测因为Configurations的改变而销毁的。
所以在 activity 销毁时,判断如果是非配置改变导致的销毁, getViewModelStore().clear() 才会被调用。
viewModelScope了解吗
viewModelScope
是一个 ViewModel 的 Kotlin 扩展属性。它能在ViewModel
销毁时 (onCleared() 方法调用时) 退出。那它又是什么时候关闭的?
我们还是来看下它的实现:
//CoroutineScope 绑定到这个 ViewModel。当 ViewModel 被清除时,这个范围将被取消,即调用 //ViewModel.onCleared 这个范围绑定到 Dispatchers.Main.immediate
val ViewModel.viewModelScope: CoroutineScope
get()
val scope: CoroutineScope? = this.getTag(JOB_KEY)
if (scope != null)
return scope
// 未命中缓存,则通过 setTagIfAbsent() 添加到 ViewModel 中
return setTagIfAbsent(JOB_KEY,
CloseableCoroutineScope(SupervisorJob() + Dispatchers.Main.immediate))
internal class CloseableCoroutineScope(context: CoroutineContext) : Closeable, CoroutineScope
override val coroutineContext: CoroutineContext = context
override fun close()
coroutineContext.cancel()
根据注释可以得知,Viewmoel被清除的时候,就是调用ViewModel的onClear方法时,就会取消作用域。而ViewModel的清除又是为什么会让其关闭?
再让我们看下Viewmodel的clear方法:
### ViewModel
//当不再使用此ViewModel并将其销毁时,将调用此方法。
protected 以上是关于源码解读抽丝剥茧的分析ViewModel的核心原理的主要内容,如果未能解决你的问题,请参考以下文章