Android开发SavedState|Android开发SavedState Jetpack状态保存利器 Android开发SavedStateJetpack状态保

背景
SavedState的登场
理解SavedState

用法
SavedState组成概念
原理探究

最后

背景在我们android开发中，如果需要actiivty/fragment等有状态的控件保存当前状态，由系统进行数据保存的恢复的时候
比如正常的暗黑模式切换/后台时低内存系统回收等等，都需要我们对当前的用户数据进行保存，不然下次重新恢复的时候，就会出现丢失数据的情况，给用户造成不太好的体验
一般都会重写onSaveInstanceState方法进行，在里面的Bundle对象进行数据的写入，然后会在onCreate阶段或者onRestoreInstanceState阶段进行数据的恢复！这套生命周期框架一直是深深嵌入在我们的开发习惯中！
但是随着项目的迭代，也随着业务的发展，我们可以发现，在页面复杂度提高的同时，在onSaveInstanceState里面需要保存的数据也是越来越多这就带来了几个问题，仅举例

onSaveInstanceState存储数据复杂，可能多人迭代就存在重复存取的现象，造成代码结构问题与隐藏bug的风险
不可复用，比如activity1需要存储的数据，刚好activity2也需要存储，这个时候就只能写两份代码，以此类推
没有统一的管理层，即数据的维护可能需要团队的代码规范

SavedState的登场为了解决这些历史android的设计问题，也为了更方便广大开发者进行更好的代码结构解耦设计，所以google大哥在jetpack库中，推出了SavedState，它的定位是在Android开发中，编写可插入组件，以在进程终止时保存界面状态，并在进程重启时恢复界面状态。
虽然Savedstate推出来一段时间了，但是却一直处在“默默无闻”的状态，可能的原因有很多，比如日常开发很少接触状态保存，大部分app中真正需要保存状态的其实是很少一部分，很多app甚至是不写状态保存逻辑的，被系统回收就回收掉了，重建就是了（即使丢失了）。
还有就是学习资料比较少，现在基本找不到SavedState的相关资料（区别于我们viewmodel常用的SavesStateHandle）。
官方的demo例子也没有，所以Savedstate很长一段时间都是处于雪藏的状态。但是！为了让我们的app拥有更加好的体验，同时也提高我们的技术视野，学习Savedstate还是很有必要的，不然官方也不会白白将其加入jetpack系列。

理解SavedState
用法
深入理解之前呢，我们必须要会用不是嘛！我们下面来看一下例子
在Activity onCreate方法中执行以下代码
注意：savedStateRegistry.isRestored在onCreate之后就会变成true，
也就是说，我们必须在ComponentActivity的onCreate走完之后才能用，
原理看下边的解析

if(savedStateRegistry.isRestored){val consumeRestoredStateForKey = savedStateRegistry.consumeRestoredStateForKey("test")val test = consumeRestoredStateForKey?.getInt("test")Log.i("hello","tag test is $test")}savedStateRegistry.registerSavedStateProvider("test",DataProvider())

class DataProvider: SavedStateRegistry.SavedStateProvider {override fun saveState(): Bundle {return Bundle().apply {this.putInt("test",1)}}}

如果对上诉程序不理解，不要紧，我们会接下来讲解！运行上诉程序，在app一开始启动的时候，log输出就是null，这个时候我们退到后台（可以设置不保留活动），再次打开的时候，可以看到activity被回收重建，这个时候log输出的却是1，这里就验证了SavedState具有保存数据的能力。
在demo中savedStateRegistry其实是ComponentActivity的一个对象，我们接下里分析一下，SavedState的概念组成

SavedState组成概念
SavedState库中，有以下几个概念

SavedStateRegistryOwner	SavedStateRegistryController	SavedStateRegistry	SavedStateProvider
保存状态拥有者，用于提供声明周期的同步操作	控制器，相当于一个连接角色，用于连接SavedStateRegistryOwner与SavedStateRegistry	数据管理者，用于提供对存储数据的相关操作	数据提供者，用于提供存储的数据

我们再来看一下依赖关系，可以看到这个是单向依赖

文章图片

【Android开发SavedState|Android开发SavedState Jetpack状态保存利器】看到这里，我们就对SavedState有了个初步的认识，这个时候就可以再回到demo了，首先我们的Activity是继承了ComponentActivity，而ComponentActivity其实是实现了SavedStateRegistryOwner接口的

文章图片

所以我们的数据存储过程发起者都是由该activity的生命周期决定，而ComponentActivity里面拥有一个SavedStateRegistryController对象

文章图片

我们可以通过SavedStateRegistryController对象，获取到SavedStateRegistry

文章图片

构成已经很清楚了，我们再来解释一下上面的用法，其实分为两步：

savedStateRegistry.registerSavedStateProvider，通过savedStateRegistry的registerSavedStateProvider方法注册一个数据保存集合，第一个参数就是自定义的key，第二个参数为实现SavedStateProvider接口的类，即DataProvider
savedStateRegistry.consumeRestoredStateForKey可以获取当前的存储的数据集合，参数为我们自定义的key，如果当前存在key对应的数据，就返回具体存储的数据（发生在重组时），如果不存在就返回null（发生在首次进入的时候）。值得注意的一个点是，如果我们没有调用unregisterSavedStateProvider（删除对应key的存储数据）方法，那么除了首次进入之外，每次系统回收都会帮我们恢复在registerSavedStateProvider创建时的数据集合。

到这里，用法其实就很明确了，通过以上的分层，我们就可以把原本耦合在onSaveInstanceState的数据存储逻辑，变成了一个个SavedStateProvider，方便了后期数据的管理与复用，即像插件一样我们随时可以替换具体的逻辑而不影响业务本身。

原理探究
我们来看一下registerSavedStateProvider究竟做了些什么

@MainThreadpublic void registerSavedStateProvider(@NonNull String key,@NonNull SavedStateProvider provider) {SavedStateProvider previous = mComponents.putIfAbsent(key, provider); if (previous != null) {throw new IllegalArgumentException("SavedStateProvider with the given key is"+ " already registered"); }}

private SafeIterableMap mComponents =new SafeIterableMap<>();

可以看到，其实就是在mComponents里面放了一个SavedStateProvider对象，当前，如果我们之前存放过了，再次存放就会抛出异常，而mComponents，其实就是一个map对象。
那么我们SavedStateRegistry什么时候才触发这个存储逻辑呢？其实在performSave方法里面

@MainThreadvoid performSave(@NonNull Bundle outBundle) {Bundle components = new Bundle(); if (mRestoredState != null) {components.putAll(mRestoredState); }for (Iterator it =mComponents.iteratorWithAdditions(); it.hasNext(); ) {Map.Entry entry1 = it.next(); // 触发了SavedStateProvider的saveState方法components.putBundle(entry1.getKey(), entry1.getValue().saveState()); }outBundle.putBundle(SAVED_COMPONENTS_KEY, components); }

这里有个有趣的点，它接受一个外来的Bundle，在外来的Bundle里面，再次存了一个子Bundle，而这个子Bundle，其实就是我们上文的mComponents的数据，而对应的key是一个常量

private static final String SAVED_COMPONENTS_KEY ="androidx.lifecycle.BundlableSavedStateRegistry.key";

存放的子Bundle通过遍历的方式，触发了SavedStateProvider的saveState方法，获取到我们实际上想要保存的数据。那么是谁调用了SavedStateRegistry的performSave方法呢？当然就是 SavedStateRegistryController啦，我们说过它其实是个中间角色，大部分操作需要经过它才能调用到SavedStateRegistry

@MainThreadpublic void performSave(@NonNull Bundle outBundle) {mRegistry.performSave(outBundle); }

而SavedStateRegistryController的performSave方法，真的被调用起来，就是在ComponenntActivity中

@CallSuper@Overrideprotected void onSaveInstanceState(@NonNull Bundle outState) {Lifecycle lifecycle = getLifecycle(); if (lifecycle instanceof LifecycleRegistry) {((LifecycleRegistry) lifecycle).setCurrentState(Lifecycle.State.CREATED); }super.onSaveInstanceState(outState); 被调用 mSavedStateRegistryController.performSave(outState); mActivityResultRegistry.onSaveInstanceState(outState); }

到这里我们应该豁然开朗了，其实还是换汤不换药，都是在onSaveInstanceState里面进行的逻辑保存，只不过这一层被SavedState给封装起来了，同时加入到了androidx中，也算是官方想要重新完善onSaveInstanceState架构的体现。
看到这里了，我们也就能解释存放在SavedStateProvider的数据，其实就存放在了onSaveInstanceState的Bundle中，key为SAVED_COMPONENTS_KEY的子Bundle中。
我们再来看一下consumeRestoredStateForKey，取数据的逻辑

@MainThread@Nullablepublic Bundle consumeRestoredStateForKey(@NonNull String key) {if (!mRestored) {throw new IllegalStateException("You can consumeRestoredStateForKey "+ "only after super.onCreate of corresponding component"); }if (mRestoredState != null) {Bundle result = mRestoredState.getBundle(key); mRestoredState.remove(key); if (mRestoredState.isEmpty()) {mRestoredState = null; }return result; }return null; }

可以看到，只有mRestored为true的时候，我们才能真正进入到取数的逻辑，否则抛出异常，因为我们能够获取到数据的前提是，系统帮我们把数据进行恢复之后！而mRestored被赋值的时候，其实就在performRestore中

@SuppressWarnings("WeakerAccess")@MainThreadvoid performRestore(@NonNull Lifecycle lifecycle, @Nullable Bundle savedState) {if (mRestored) {throw new IllegalStateException("SavedStateRegistry was already restored."); }if (savedState != null) {mRestoredState = savedState.getBundle(SAVED_COMPONENTS_KEY); }.... mRestored = true; }

有了上面存数据的逻辑，我们很容易知道，performRestore的调用者，最终肯定是由实现了 SavedStateRegistryOwner接口的ComponentActivity发起调用

@Overrideprotected void onCreate(@Nullable Bundle savedInstanceState) {// Restore the Saved State first so that it is available to// OnContextAvailableListener instances//这里就是恢复数据来源 mSavedStateRegistryController.performRestore(savedInstanceState); mContextAwareHelper.dispatchOnContextAvailable(this); super.onCreate(savedInstanceState); mActivityResultRegistry.onRestoreInstanceState(savedInstanceState); ReportFragment.injectIfNeededIn(this); if (mContentLayoutId != 0) {setContentView(mContentLayoutId); }}

最后我们再给出具体的流程图，存数据和取数据的逻辑：

文章图片

最后通过SavedState，我们也能够看到jetpack官方希望改变历史android架构的决心，也想要提供更加便捷优雅的方式提供给开发者。看到这里了，也希望我们在日常开发中，可以运用到SavedState进行数据保存恢复，别让它继续雪藏啦！毕竟连依赖都不需要导入呢 ! 更多关于SavedState Jetpack状态保存的资料请关注脚本之家其它相关文章！