亲宝软件园·资讯

展开

SavedState Jetpack状态保存

Pika 人气:0

背景

在我们android开发中,如果需要actiivty/fragment等有状态的控件保存当前状态,由系统进行数据保存的恢复的时候

比如正常的暗黑模式切换/后台时低内存系统回收等等,都需要我们对当前的用户数据进行保存,不然下次重新恢复的时候,就会出现丢失数据的情况,给用户造成不太好的体验

一般都会重写onSaveInstanceState方法进行,在里面的Bundle对象进行数据的写入,然后会在onCreate阶段或者onRestoreInstanceState阶段进行数据的恢复!这套生命周期框架一直是深深嵌入在我们的开发习惯中!

但是随着项目的迭代,也随着业务的发展,我们可以发现,在页面复杂度提高的同时,在onSaveInstanceState里面需要保存的数据也是越来越多这就带来了几个问题,仅举例

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库中,有以下几个概念

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

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

看到这里,我们就对SavedState有了个初步的认识,这个时候就可以再回到demo了,首先我们的Activity是继承了ComponentActivity,而ComponentActivity其实是实现了SavedStateRegistryOwner接口的

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

 

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

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

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

原理探究

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

@MainThread
public 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<String, SavedStateProvider> mComponents =
        new SafeIterableMap<>();

可以看到,其实就是在mComponents里面放了一个SavedStateProvider对象,当前,如果我们之前存放过了,再次存放就会抛出异常,而mComponents,其实就是一个map对象。

那么我们SavedStateRegistry什么时候才触发这个存储逻辑呢?其实在performSave方法里面

@MainThread
void performSave(@NonNull Bundle outBundle) {
    Bundle components = new Bundle();
    if (mRestoredState != null) {
        components.putAll(mRestoredState);
    }
    for (Iterator<Map.Entry<String, SavedStateProvider>> it =
            mComponents.iteratorWithAdditions(); it.hasNext(); ) {
        Map.Entry<String, SavedStateProvider> 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

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

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

@CallSuper
@Override
protected 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
@Nullable
public 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")
@MainThread
void 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发起调用

@Override
protected 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状态保存的资料请关注其它相关文章!

加载全部内容

相关教程
猜你喜欢
用户评论