[转]android onSaveInstanceState方法

1. onSaveInstanceState和onRestoreInstanceState基本作用
    onSaveInstanceState是用来保存UI状态的,你可以使用它保存你所想保存的东西,在Activity杀死之前,它一般在onStop或 者onPause之前触发,onRestoreInstanceState则是在onResume之前触发回复状态,至于复写这个方法后onCreate 方法是否会被调用。
1.Activity被杀死了,onCreate会被调用,且onRestoreInstanceState 在 onResume之前恢复上次保存的信息。
2.Activity没被杀死,onCreate不会被调用,但onRestoreInstanceState 仍然会被调用,在 onResume之前恢复上次保存的信息。
 
    onSaveInstanceState和onRestoreInstanceState 是一对兄弟,一个负责存储,一个负责取出.“不一定”是成对的被调用的。


http://blog.sina.com.cn/s/blog_618199e60101g1k5.html
 
      Activity的 onSaveInstanceState() 和 onRestoreInstanceState()并不是生命周期方法,它们不同于 onCreate()、onPause()等生命周期方法,它们并不一定会被触发。当应用遇到意外情况(如:内存不足、用户直接按Home键)由系统销毁 一个Activity时,onSaveInstanceState() 会被调用。但是当用户主动去销毁一个Activity时,例如在应用中按返回键,onSaveInstanceState()就不会被调用。因为在这种情 况下,用户的行为决定了不需要保存Activity的状态。通常onSaveInstanceState()只适合用于保存一些临时性的状态,而 onPause()适合用于数据的持久化保存。
      在activity被杀掉之前调用保存每个实例的状态,以保证该状态可以在onCreate(Bundle)或者onRestoreInstanceState(Bundle) (传入的Bundle参数是由onSaveInstanceState封装好的)中恢复。这个方法在一个activity被杀死前调用,当该activity在将来某个时刻回来时可以恢复其先前状态。 

  例如,如果activity B启用后位于activity A的前端,在某个时刻activity A因为系统回收资源的问题要被杀掉,A通过onSaveInstanceState将有机会保存其用户界面状态,使得将来用户返回到activity A时能通过onCreate(Bundle)或者onRestoreInstanceState(Bundle)恢复界面的状态。

  关于onSaveInstanceState (),是在函数里面保存一些View有用的数据到一个Parcelable对象并返回。在Activity的onSaveInstanceState(Bundle outState)中调用View的onSaveInstanceState (),返回Parcelable对象,

  接着用Bundle的putParcelable方法保存在Bundle  savedInstanceState中。

  当系统调用Activity的的onRestoreInstanceState(Bundle savedInstanceState)时, 同过Bundle的getParcelable方法得到Parcelable对象,然后把该Parcelable对象传给View的onRestoreInstanceState (Parcelable state)。在的View的onRestoreInstanceState中从Parcelable读取保存的数据以便View使用。

  这就是onSaveInstanceState() 和 onRestoreInstanceState() 两个函数的基本作用和用法。

 
2. onSaveInstanceState() 什么时候调用 
先看Application Fundamentals上的一段话:
 Android calls onSaveInstanceState() before the activity becomes vulnerable to being destroyed by the system, but does not bother calling it when the instance is actually being destroyed by a user action (such as pressing the BACK key)
    从这句话可以知道,当某个activity变得“容易”被系统销毁时,该activity的onSaveInstanceState就会被执行,除非该activity是被用户主动销毁的,例如当用户按BACK键的时候。
    注意上面的双引号,何为“容易”?言下之意就是该activity还没有被销毁,而仅仅是一种可能性。这种可能性有哪些?通过重写一个activity的 所有生命周期的onXXX方法,包括onSaveInstanceState和onRestoreInstanceState方法,我们可以清楚地知道当 某个activity(假定为activity A)显示在当前task的最上层时,其onSaveInstanceState方法会在什么时候被执行,有这么几种情况:
1、当用户按下HOME键时
      这是显而易见的,系统不知道你按下HOME后要运行多少其他的程序,自然也不知道activity A是否会被销毁,故系统会调用onSaveInstanceState,让用户有机会保存某些非永久性的数据。以下几种情况的分析都遵循该原则
2、长按HOME键,选择运行其他的程序时。
3、按下电源按键(关闭屏幕显示)时。
4、从activity A中启动一个新的activity时。
5、屏幕方向切换时,例如从竖屏切换到横屏时
    在屏幕切换之前,系统会销毁activity A,在屏幕切换之后系统又会自动地创建activity A,所以onSaveInstanceState一定会被执行
    总而言之,onSaveInstanceState的调用遵循一个重要原则,即当系统“未经你许可”时销毁了你的activity,则 onSaveInstanceState会被系统调用,这是系统的责任,因为它必须要提供一个机会让你保存你的数据(当然你不保存那就随便你了)。
 
3. onRestoreInstanceState()什么时候调用 
    至于onRestoreInstanceState方法,需要注意的是,onSaveInstanceState方法和onRestoreInstanceState方法“不一定”是成对的被调用的。
    onRestoreInstanceState被调用的前提是,activity A“确实”被系统销毁了,而如果仅仅是停留在有这种可能性的情况下,则该方法不会被调用,例如,当正在显示activity A的时候,用户按下HOME键回到主界面,然后用户紧接着又返回到activity A,这种情况下activity A一般不会因为内存的原因被系统销毁,故activity A的onRestoreInstanceState方法不会被执行.此处也说明以上二者,大多数情况下不成对被使用。
    另外,onRestoreInstanceState的bundle参数也会传递到onCreate方法中,你也可以选择在onCreate方法中做数据还原.
    onRestoreInstanceState()在onStart() 和 onPostCreate(Bundle)之间调用。
 
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控件的状态, 成员变量的值等,而不应该用来保存持久化数据,持久化数据应该当用户离开当前的activity时,在onPause()中保存(比如将数据保存到数据库或文件中)。说到这里,还要说一点的就是在onPause()中不适合用来保存比较费时的数据,所以这点要理解。

 

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

 
  6. 引发activity销毁和重建的其它情况

  除了系统处于内存不足的原因会摧毁activity之外, 某些系统设置的改变也会导致activity的摧毁和重建. 例如改变屏幕方向(见上例), 改变设备语言设定, 键盘弹出等。

 

  另外,当屏幕的方向发生了改变, Activity会被摧毁并且被重新创建,如果你想在Activity被摧毁前缓存一些数据,并且在Activity被重新创建后恢复缓存的数据。可以重写Activity的 onSaveInstanceState() 和 onRestoreInstanceState()方法,如下代码所示:

package com.code.test;
import android.app.Activity;
import android.content.pm.ActivityInfo;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.EditText;
import android.widget.Toast;

public class MainActivity extends Activity {
    private String message = "";
    private EditText text = null;
    private Button button = null;
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        text = (EditText) findViewById(R.id.editText1);
        button = (Button) findViewById(R.id.btnSave);        
        button.setOnClickListener(new OnClickListener(){
            @Override
            public void onClick(View v) {
                Toast.makeText(getApplicationContext(), "保存", Toast.LENGTH_SHORT).show();
            }
        });
    } 
    @Override
    public void onResume(){
        super.onResume();
        Toast.makeText(getApplicationContext(), message, Toast.LENGTH_LONG).show();
    }
 
    @Override
    public void onSaveInstanceState(Bundle savedInstanceState){
        super.onSaveInstanceState(savedInstanceState);
        savedInstanceState.putString("message", text.getText().toString());
    }
 
    @Override
    public void onRestoreInstanceState(Bundle savedInstanceState){
        super.onRestoreInstanceState(savedInstanceState);
        message = savedInstanceState.getString("message");
    }
}

    还有需要注意的是, onSaveInstanceState()方法并不是一定会被调用的, 因为有些场景是不需要保存状态数据的。比如用户按下BACK键退出activity时, 用户显然想要关闭这个activity, 此时是没有必要保存数据以供下次恢复的, 也就是onSaveInstanceState()方法不会被调用。如果调用onSaveInstanceState()方法,调用将发生在onPause()或onStop()方法之前。
    @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");
    }
 
     我们可以用旋转屏幕来测试我们的程序保存状态的能力。因为一般旋转时,activity会被重新执行onCreate() onStart()等操作,程序此时能够保存状态是很重要的。可以考虑使用该方法保存数据。当然了在旋转屏幕时我们除了使用onSaveInstanceState ()外,还可以使用onRetainNonConfigurationInstance()和getLastNonConfigurationInstance()这两个方法来保存切换屏幕的状态。与onSaveInstanceState () 不同的是,onRetainNonConfigurationInstance()和getLastNonConfigurationInstance() 方法主要用于屏幕之间的旋转操作时保存数据。
    @Override
    public Object onRetainNonConfigurationInstance() {
        //
 TODO Auto-generated method stub
        
// 在这里设置需要保存的内容,在切换时不是bundle了,我们可以直接通过object来代替。

        return super.onRetainNonConfigurationInstance();
    }
 

 

   在恢复屏幕时可以不使用onRestoreInstanceState(),而使用getLastNonConfigurationInstance()来代替。我们可以直接在oncreate()方法中获取上次保存的对象。 如下代码所示:
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        // TODO Auto-generated method stub

        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        
        // 获取上次切换屏幕保存的对象

        Object obj = getLastNonConfigurationInstance(); 
    }
 
7、onRetainNonConfigurationInstance()(旧版本中有) or setRetainInstance()
    对于我们的程序而言,或多或少的都需要进行Activity之间的跳转操作,其中有一些是为了获得系统中的资源或是一些必要信息,而一般是通过启动 Activity(常用startActivity()和startActivityForResult()函数)来进行操作。在这个跳转的期间,我们当 前的Activity暂时失去了焦点,处于不可操作状态,可在此之前先通过onSaveInstanceState()方法来保存一些暂时时的数据。当回 到先前的Activity时,先前的Activity重新获取了焦点,系统就是触发onRestoreInstanceState()方法,可获取失去焦 点前的一些数据。onRetainNonConfigurationInstance()方法也具有类似的功能来处理这样的数据操作。先前说过,onRetainNonConfigurationInstance()方法主要是用于屏幕的旋转操作。

 

  说到这里了,可能有的人就要问了,既然onSaveInstanceState()和onRetainNonConfigurationInstance() 都可以实现保存数据的功能,如果是两个同时使用时,执行顺序是哪个在先,哪个在后呢?根据Android官方网站上介绍,如果两个方法同时出现 时,onSaveInstanceState()方法执行在先,而onRetainNonConfigurationInstance()方法执行在后。它们的执行顺序都在onStop()和onDestroy()之间,关于这点需要我们大家注意。

 

  之前在其它网站上看到有的朋友说:" onSaveInstanceState()和onRetainNonConfigurationInstance()既然都可以实现保存数据的功能,而且onSaveInstanceState()相比onRetainNonConfigurationInstance()方法可以实现更多情况下的数据保存功能,那么onRetainNonConfigurationInstance()岂不是多余的吗?"。关于这点,从设计的角度看,onRetainNonConfigurationInstance()并不是多余的函数。一般情况下,如果我们要保存的数据不太大,而且适合放在Bundle中,那么使用onSaveInstanceState()是比较合适的;如果要保存的数据不适合放在Bundle中(比如:一个socket)或是数据比较大(比如:一个Bitmap),那么这个时间我们就应该使用onRetainNonConfigurationInstance(),而且我们使用onRetainNonConfigurationInstance()可以保存任何类型的对象,像AsyncTask和SQLiteDatabse,我们都可以进行保存。这些类型的数据可能会被一个新的Activity实例所重新使用。所以onSaveInstanceState()和onRetainNonConfigurationInstance()在我们的程序中扮演的是不同的角色,需要在不同的时机下调用,用来处理不同类型的数据。

  

  例如下面代码所示要保存一个复杂的数据:

     public class DataHolder {
        int a;
        Bitmap b;
        String s;
    }
    @Override
    public Object onRetainNonConfigurationInstance() {
        //
 TODO Auto-generated method stub
        DataHolder dh = new DataHolder();
        dh.a = a;
        dh.b = b;
        dh.s = s;
        return dh;
    }
 
    不过呢,onRetainNonConfigurationInstance()在新版本的SDK中是一个过时的方法,我们可以用 setRetainInstance(boolean)来代替onRetainNonConfigurationInstance(),在旧的平台中我们仍然可以使用onRetainNonConfigurationInstance()。如果是部分朋友不知道如何使用setRetainInstance(boolean)来保存自定义的对象数据,可以使用onRetainCustomNonConfigurationInstance()来代表onRetainNonConfigurationInstance(),同时使用getLastCustomNonConfigurationInstance()代替getLastNonConfigurationInstance() 。

 

  下面是一个使用onRetainNonConfigurationInstance() 和 getLastNonConfigurationInstance()来实现屏幕旋转时异步下载更新进度条并保存数据的效果,代码如下所示:

package com.rotation.demo; 
import android.app.Activity;
import android.os.AsyncTask;
import android.os.Bundle;
import android.os.SystemClock;
import android.util.Log;
import android.view.View;
import android.widget.ProgressBar;

public class RotationAsyncActivity extends Activity {    

    private ProgressBar progressBar=null;// 进度条    
    private RotationAsyncTask asyncTask=null;   // 异步任务类 
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        progressBar=(ProgressBar)findViewById(R.id.progress);

        asyncTask=(RotationAsyncTask)getLastNonConfigurationInstance();// 获取对象        
        if (asyncTask==null) {
            asyncTask=new RotationAsyncTask(this);
            asyncTask.execute();
        }else {
            asyncTask.attach(this);
            updateProgress(asyncTask.getProgress());        
            if (asyncTask.getProgress()>=100) {
                markAsDone();
            }
        }
    }    
    
    @Override
    public Object onRetainNonConfigurationInstance() {
        asyncTask.detach();        
        return asyncTask;
    }      
    private void updateProgress(int progress) {
        progressBar.setProgress(progress);
    }      
    private void markAsDone() {
        findViewById(R.id.completed).setVisibility(View.VISIBLE);
    }     
    // 异步任务类

    private static class RotationAsyncTask extends AsyncTask<Void, Void, Void> {
        private RotationAsyncActivity activity=null;
        private int progress=0;        
        
        public RotationAsyncTask() {
            // TODO Auto-generated constructor stub

        }        
        
        public RotationAsyncTask(RotationAsyncActivity activity) {
            attach(activity);
        }        
        @Override
        protected Void doInBackground(Void... unused) {
            for (int i=0;i<20;i++) {
                SystemClock.sleep(500);
                publishProgress();
            }          
            return null;
        }        
        @Override
        protected void onProgressUpdate(Void... unused) {
            if (activity==null) {
                Log.w("RotationAsyncActivity", "onProgressUpdate()");
            }else {
                progress += 5;
                activity.updateProgress(progress);
            }
        }        
        @Override
        protected void onPostExecute(Void unused) {
            if (activity==null) {
                Log.w("RotationAsyncActivity", "onPostExecute()");
            }else {
                activity.markAsDone();
            }
        }
        
        protected void detach() {
            activity = null;
        }        
        protected void attach(RotationAsyncActivity activity) {
            this.activity = activity;
        }        
        protected int getProgress() {
            return progress;
        }
    }
}

我们在运行示例时就会发现,无论怎样旋转屏幕都不会影响进度条的更新与下载,需要解释下的是这里我并没有设置下载功能,有兴趣或需要的朋友自己添加即可。实现效果图如下所示:
android <wbr>onSaveInstanceState方法

    以上就是在Android中关于InstanceState保存数据和恢复数据的过程,在这里我想再重复一 遍:onSaveInstanceState()和onRestoreInstanceState()机制来保存数据时,它仅在非用户显式的指令杀死应用 程序时保存和恢复数据。我们可以使用它在我们的程序中来保存数据,可以作为保存数据的一种方式,但在使用过程中需要注意其使用原理和方法。

 

  Android使用InstanceState保存和恢复数据示例下载: /Files/hanyonglu/AndroidFile/MyTestCode.rar

 

  Android实现屏幕旋转异步下载效果示例下载:/Files/hanyonglu/AndroidFile/MyRotationAsync.rar

 

  转载地址:http://www.cnblogs.com/hanyonglu/archive/2012/03/28/2420515.html  

posted on 2013-03-05 21:50  meizixiong  阅读(366)  评论(0编辑  收藏  举报