Activity-onSaveInstanceState()、onRestoreInstanceState() 分析

onSaveInstanceState和onRestoreInstanceState

 

一、概述

         本文转述并验证了这对长期具有神秘色彩的方法onSaveInstanceState和onRestoreInstanceState。

 

二、要点

        1.此二者有什么作用？

        2.onSaveInstanceState调用时机

        3.onRestoreInstanceState调用时机

4. onSaveInstanceState()方法的默认实现

        5.是否需要覆写onSaveInstanceState()方法

6. 引发activity摧毁和重建的其他情形

        7.使用小例

 

三、正文

         1.此二者有什么作用？

在activity被杀掉之前调用保存每个实例的状态,以保证该状态可以在onCreate(Bundle)或者onRestoreInstanceState(Bundle) (传入的Bundle参数是由onSaveInstanceState封装好的)中恢复。这个方法在一个activity被杀死前调用，当该activity在将来某个时刻回来时可以恢复其先前状态。例如，如果activity B启用后位于activity A的前端，在某个时刻activity A因为系统回收资源的问题要被杀掉，A通过onSaveInstanceState将有机会保存其用户界面状态，使得将来用户返回到activity A时能通过onCreate(Bundle)或者onRestoreInstanceState(Bundle)恢复界面的状态。[译自DOC]

         上述被杀死前如何理解？见下二小节。

 

         2.onSaveInstanceState调用时机

先看Application Fundamentals上的一段话： 

  Android calls onSaveInstanceState() before the activitybecomes vulnerable to being destroyed by the system, but does not bothercalling it when the instance is actually being destroyed by a user action (suchas pressing the BACK key) 

从这句话可以知道，当某个activity变得“容易”被系统销毁时，该activity的onSaveInstanceState就会被执行，除非该activity是被用户主动销毁的，例如当用户按BACK键的时候。

注意上面的双引号，何为“容易”？言下之意就是该activity还没有被销毁，而仅仅是一种可能性。这种可能性有哪些？通过重写一个activity的所有生命周期的onXXX方法，包括onSaveInstanceState和onRestoreInstanceState方法，我们可以清楚地知道当某个activity（假定为activity A）显示在当前task的最上层时，其onSaveInstanceState方法会在什么时候被执行，有这么几种情况：

A、当用户按下HOME键时。[已验证OK]

这是显而易见的，系统不知道你按下HOME后要运行多少其他的程序，自然也不知道activity A是否会被销毁，故系统会调用onSaveInstanceState，让用户有机会保存某些非永久性的数据。以下几种情况的分析都遵循该原则 

B、长按HOME键，选择运行其他的程序时。[已验证OK]

C、按下电源按键（关闭屏幕显示）时。[已验证OK]

D、从activity A中启动一个新的activity时。[已验证OK]

E、屏幕方向切换时，例如从竖屏切换到横屏时。[已验证OK]

在屏幕切换之前，系统会销毁activity A，在屏幕切换之后系统又会自动地创建activity A，所以onSaveInstanceState一定会被执行，且也一定会执行onRestoreInstanceState。

 

总而言之，onSaveInstanceState的调用遵循一个重要原则，即当系统存在“未经你许可”时销毁了你的activity的可能时，则onSaveInstanceState会被系统调用，这是系统的责任，因为它必须要提供一个机会让你保存你的数据（当然你不保存那就随便你了）。如果调用，调用将发生在onPause()或onStop()方法之前。（虽然测试时发现多数在onPause()前）

 

         3.onRestoreInstanceState调用时机

onRestoreInstanceState被调用的前提是，activity A“确实”被系统销毁了，而如果仅仅是停留在有这种可能性的情况下，则该方法不会被调用，例如，当正在显示activity A的时候，用户按下HOME键回到主界面，然后用户紧接着又返回到activity A，这种情况下activity A一般不会因为内存的原因被系统销毁，故activity A的onRestoreInstanceState方法不会被执行

此也说明上二者，大多数情况下不成对被使用。

 

4.onSaveInstanceState()方法的默认实现

如果开发者没有覆写onSaveInstanceState()方法, 此方法的默认实现会自动保存activity中的某些状态数据, 比如activity中各种UI控件的状态. android应用框架中定义的几乎所有UI控件都恰当的实现了onSaveInstanceState()方法,因此当activity被摧毁和重建时, 这些UI控件会自动保存和恢复状态数据. 比如EditText控件会自动保存和恢复输入的数据,而CheckBox控件会自动保存和恢复选中状态.开发者只需要为这些控件指定一个唯一的ID(通过设置android:id属性即可), 剩余的事情就可以自动完成了.如果没有为控件指定ID, 则这个控件就不会进行自动的数据保存和恢复操作.

由上所述, 如果开发者需要覆写onSaveInstanceState()方法, 一般会在第一行代码中调用该方法的默认实现:super.onSaveInstanceState(outState).

 

5.是否需要覆写onSaveInstanceState()方法

既然该方法的默认实现可以自动的保存UI控件的状态数据, 那什么时候需要覆写该方法呢?

如果需要保存额外的数据时, 就需要覆写onSaveInstanceState()方法。onSaveInstanceState()方法只适合保存瞬态数据, 比如UI控件的状态, 成员变量的值等。 (见下例)。

由于onSaveInstanceState()方法方法不一定会被调用, 因此不适合在该方法中保存持久化数据, 例如向数据库中插入记录等. 保存持久化数据的操作应该放在onPause()中。若是永久性值，则在onPause()中保存；若大量，则另开线程吧，别阻塞UI线程。

 

6.引发activity摧毁和重建的其它情形

除了系统处于内存不足的原因会摧毁activity之外, 某些系统设置的改变也会导致activity的摧毁和重建. 例如改变屏幕方向(见上例), 改变设备语言设定, 键盘弹出[这个还得看布局吧，没测出]等.

 

         7.使用实例

1.      publicclass MainActivity extends Activity {  
2.           public static final int SECOND_ACTIVITY =0;  
3.           private String temp;  
4.         
5.           @Override  
6.           public void onCreate(BundlesavedInstanceState) {  
7.              super.onCreate(savedInstanceState);  
8.               // 从savedInstanceState中恢复数据, 如果没有数据需要恢复savedInstanceState为null  
9.               if (savedInstanceState != null) {  
10.                temp =savedInstanceState.getString("temp");  
11.                System.out.println("onCreate:temp = " + temp);  
12.            }  
13.        }  
14.      
15.        public void onResume() {  
16.            super.onResume();  
17.            temp = "xing";  
18.            System.out.println("onResume:temp = " + temp);  
19.            // 切换屏幕方向会导致activity的摧毁和重建  
20.            if (getRequestedOrientation() ==ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED) {  
21.               setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE);  
22.                System.out.println("屏幕切换");  
23.            }  
24.        }  
25.          
26.        // 将数据保存到outState对象中, 该对象会在重建activity时传递给onCreate方法  
27.        @Override  
28.        protected void onSaveInstanceState(BundleoutState) {  
29.           super.onSaveInstanceState(outState);  
30.            outState.putString("temp",temp);  
31.        }  
32.   }

需要注意的是, onSaveInstanceState()方法并不是一定会被调用的, 因为有些场景是不需要保存状态数据的. 比如用户按下BACK键退出activity时, 用户显然想要关闭这个activity, 此时是没有必要保存数据以供下次恢复的, 也就是onSaveInstanceState()方法不会被调用. 如果调用onSaveInstanceState()方法,调用将发生在onPause()或onStop()方法之前.

 

至于这两个函数的使用，给出示范代码（留意自定义代码在调用super的前或后）：

@Override
public void onSaveInstanceState(BundlesavedInstanceState) {
        savedInstanceState.putBoolean("MyBoolean", true);
        savedInstanceState.putDouble("myDouble", 1.9); 
        // etc.
        super.onSaveInstanceState(savedInstanceState);
}

@Override
public void onRestoreInstanceState(BundlesavedInstanceState) {
        super.onRestoreInstanceState(savedInstanceState);
        boolean myBoolean =savedInstanceState.getBoolean("MyBoolean");
        double myDouble =savedInstanceState.getDouble("myDouble");

}

 

四、小结

         总算了却一大心事。