Restoring complex objects at restart of an activity

In an android app an activity is created and then destroyed, for example when the user open another activity or when the user presses the back button, later the user opens again the same activity that is is recreated using the data saved before the earlier destruction of the activity.
The data are saved in an object Bundle in the onSaveInstanceState method and restored in the onRestoreInstanceState method (see Recreating an Activity).
The Bundle class provides several setter and getter methods to save and restore data such as getInt and setInt for the integers and similar methods for other types of primitives, strings and one dimensional array.
In this post I write some examples to save and restore more complex objects such as the following CustomObject:

The activity that saves and retrieves objects of this type is:

The methods onSaveInstanceState and onRestoreInstanceState are divided into sections where the object CustomObject or an array of one or more dimensions of this object is saved and then restored.
All sections except the last one use one of the following interfaces:

• Serializable: “maker interface” with no methods to implement, available in Java
• Parcelable: an interface, available in Android SDK

Between the two techniques Parcelable is the most efficient, in the net you find a lot of documentation about, as here.

1. 1. section 1: here I use the methods putParcelable and getParcelable for the classes extending the Parcelable interface; in this example the class CustomParcelableObject extends CustomObject and implements Parcelable
      
      Java

      package eu.lucazanini.restoreobject.customobject; import android.os.Parcel; import android.os.Parcelable; public class CustomParcelableObject extends CustomObject implements Parcelable { public static final Parcelable.Creator<CustomParcelableObject> CREATOR = new Parcelable.Creator<CustomParcelableObject>() { @Override public CustomParcelableObject createFromParcel(Parcel in) { return new CustomParcelableObject(in); } @Override public CustomParcelableObject[] newArray(int size) { return new CustomParcelableObject[size]; } }; public CustomParcelableObject(String name) { super(name); } private CustomParcelableObject(Parcel in) { name = in.readString(); } @Override public int describeContents() { return 0; } @Override public void writeToParcel(Parcel dest, int flags) { dest.writeString(name); } }

      1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38

      package eu.lucazanini.restoreobject.customobject;   import android.os.Parcel; import android.os.Parcelable;   public class CustomParcelableObject extends CustomObject implements Parcelable {       public static final Parcelable.Creator<CustomParcelableObject> CREATOR = new Parcelable.Creator<CustomParcelableObject>() { @Override public CustomParcelableObject createFromParcel(Parcel in) {     return new CustomParcelableObject(in); }   @Override public CustomParcelableObject[] newArray(int size) {     return new CustomParcelableObject[size]; }     };       public CustomParcelableObject(String name) { super(name);     }       private CustomParcelableObject(Parcel in) { name = in.readString();     }       @Override     public int describeContents() { return 0;     }       @Override     public void writeToParcel(Parcel dest, int flags) { dest.writeString(name);     }   }

   2. section 2: here I use the methods putSerializable and getSerializable for the classes extending the Serializable interface; in this example the class CustomSerializableObject extends CustomObject and implements Serializable
      
      Java

      package eu.lucazanini.restoreobject.customobject; import java.io.IOException; import java.io.ObjectInputStream; import java.io.ObjectOutputStream; import java.io.Serializable; public class CustomSerializableObject extends CustomObject implements Serializable { private static final long serialVersionUID = -1669600905661049718L; public CustomSerializableObject(String name) { super(name); } private void readObject(ObjectInputStream inputStream) throws ClassNotFoundException, IOException { inputStream.defaultReadObject(); } private void writeObject(ObjectOutputStream outputStream) throws IOException { outputStream.defaultWriteObject(); } }

      1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27

      package eu.lucazanini.restoreobject.customobject;   import java.io.IOException; import java.io.ObjectInputStream; import java.io.ObjectOutputStream; import java.io.Serializable;   public class CustomSerializableObject extends CustomObject implements Serializable {       private static final long serialVersionUID = -1669600905661049718L;       public CustomSerializableObject(String name) { super(name);     }       private void readObject(ObjectInputStream inputStream)     throws ClassNotFoundException, IOException { inputStream.defaultReadObject();     }       private void writeObject(ObjectOutputStream outputStream)     throws IOException { outputStream.defaultWriteObject();     }   }

   3. section 3: here the restored object is an one dimensional array of objects CustomParcelableObject extending Parcelable using the methods putParcelableArray and getParcelableArray
   4. section 4: here the restored object is an one dimensional array of objects CustomSerializableObject extending Serializable using the methods putSerializable and getSerializable; remember that arrays are objects that always extend the Serializable interface
   5. section 5: here the restored object is an array of two dimensional objects (CustomParcelableObject[][] array), field of a wrapper class that extends Parcelable:
      
      package eu.lucazanini.restoreobject.customobject; import android.os.Parcel; import android.os.Parcelable; public class CustomParcelableObjectWrapper implements Parcelable { public static final Parcelable.Creator<CustomParcelableObjectWrapper> CREATOR = new Parcelable.Creator<CustomParcelableObjectWrapper>() { @Override public CustomParcelableObjectWrapper createFromParcel(Parcel in) { return new CustomParcelableObjectWrapper(in); } @Override public CustomParcelableObjectWrapper[] newArray(int size) { return new CustomParcelableObjectWrapper[size]; } }; private CustomParcelableObject[][] array; public CustomParcelableObjectWrapper(String name) { array = new CustomParcelableObject[3][3]; for (int i = 0; i < 3; i++) { for (int j = 0; j < 3; j++) { array[i][j] = new CustomParcelableObject(name + " at " + i + ", " + j); } } } private CustomParcelableObjectWrapper(Parcel in) { array = (CustomParcelableObject[][]) in .readArray(CustomParcelableObjectWrapper.class.getClassLoader()); } @Override public int describeContents() { return 0; } public CustomParcelableObject getCustomParcelableObject(int i, int j) { return array[i][j]; } public void setCustomParcelableObject(int i, int j, String name) { array[i][j].setName(name); } @Override public void writeToParcel(Parcel dest, int flags) { dest.writeArray(array); } }

      1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55

      package eu.lucazanini.restoreobject.customobject;   import android.os.Parcel; import android.os.Parcelable;   public class CustomParcelableObjectWrapper implements Parcelable {       public static final Parcelable.Creator<CustomParcelableObjectWrapper> CREATOR = new Parcelable.Creator<CustomParcelableObjectWrapper>() { @Override public CustomParcelableObjectWrapper createFromParcel(Parcel in) {     return new CustomParcelableObjectWrapper(in); }   @Override public CustomParcelableObjectWrapper[] newArray(int size) {     return new CustomParcelableObjectWrapper[size]; }     };       private CustomParcelableObject[][] array;       public CustomParcelableObjectWrapper(String name) { array = new CustomParcelableObject[3][3]; for (int i = 0; i < 3; i++) {     for (int j = 0; j < 3; j++) { array[i][j] = new CustomParcelableObject(name + " at " + i + ", " + j);     } }     }       private CustomParcelableObjectWrapper(Parcel in) { array = (CustomParcelableObject[][]) in .readArray(CustomParcelableObjectWrapper.class.getClassLoader());     }       @Override     public int describeContents() { return 0;     }       public CustomParcelableObject getCustomParcelableObject(int i, int j) { return array[i][j];     }       public void setCustomParcelableObject(int i, int j, String name) { array[i][j].setName(name);     }       @Override     public void writeToParcel(Parcel dest, int flags) { dest.writeArray(array);     }   }

   6. section 6: here the restored object is a two dimensional array of CustomSerializableObject
   7. section 7: here the CustomObject is not saved and then restored as in the above sections but it is preserved in the class MyApplication that extends Application:
      
      package eu.lucazanini.restoreobject; import eu.lucazanini.restoreobject.customobject.CustomObject; import android.app.Application; public class MyApplication extends Application { public final static String OBJECT_IN_APPLICATION = "application object"; public final static String TAG = MyApplication.class.getName(); private CustomObject[][] customObject2DArray; public CustomObject[][] getCustomObjectArray() { return customObject2DArray; } public String getObjectDescription(String prefix) { StringBuilder sb = new StringBuilder(); for (int i = 0; i < 3; i++) { for (int j = 0; j < 3; j++) { sb.append(prefix + customObject2DArray[i][j].getName()); sb.append("\n"); } } return sb.toString(); } public void setCustomObjectArray() { customObject2DArray = new CustomObject[3][3]; for (int i = 0; i < 3; i++) { for (int j = 0; j < 3; j++) { customObject2DArray[i][j] = new CustomObject( OBJECT_IN_APPLICATION + " at " + i + ", " + j); } } } }

      1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39

      package eu.lucazanini.restoreobject;   import eu.lucazanini.restoreobject.customobject.CustomObject; import android.app.Application;   public class MyApplication extends Application {       public final static String OBJECT_IN_APPLICATION = "application object";     public final static String TAG = MyApplication.class.getName();       private CustomObject[][] customObject2DArray;       public CustomObject[][] getCustomObjectArray() { return customObject2DArray;     }       public String getObjectDescription(String prefix) { StringBuilder sb = new StringBuilder(); for (int i = 0; i < 3; i++) {     for (int j = 0; j < 3; j++) { sb.append(prefix + customObject2DArray[i][j].getName()); sb.append("\n");     } } return sb.toString();     }       public void setCustomObjectArray() { customObject2DArray = new CustomObject[3][3];   for (int i = 0; i < 3; i++) {     for (int j = 0; j < 3; j++) { customObject2DArray[i][j] = new CustomObject( OBJECT_IN_APPLICATION + " at " + i + ", " + j);     } }     }   }

      
      this method can be used when the screen rotates and the activity is destroyed but not the Application object specified in the AndroidManifest.xml
      
      <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="eu.lucazanini.restoreobject" android:versionCode="1" android:versionName="1.0" > <uses-sdk android:minSdkVersion="8" android:targetSdkVersion="21" /> <application android:allowBackup="true" android:icon="@drawable/ic_launcher" android:label="@string/app_name" android:theme="@style/AppTheme" android:name="eu.lucazanini.restoreobject.MyApplication" > <activity android:name="MainActivity" > <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> </application> </manifest>

      1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25

      <manifest xmlns:android="http://schemas.android.com/apk/res/android"     package="eu.lucazanini.restoreobject"     android:versionCode="1"     android:versionName="1.0" >       <uses-sdk         android:minSdkVersion="8"         android:targetSdkVersion="21" />       <application         android:allowBackup="true"         android:icon="@drawable/ic_launcher"         android:label="@string/app_name"         android:theme="@style/AppTheme"         android:name="eu.lucazanini.restoreobject.MyApplication" >         <activity android:name="MainActivity" >             <intent-filter>                 <action android:name="android.intent.action.MAIN" />                   <category android:name="android.intent.category.LAUNCHER" />             </intent-filter>         </activity>     </application>   </manifest>

      
      as you can see in Google developers the Application class can be used in order to “maintain global application state” but in the net you can find some issues as here.

You can download the app here, to test you need rotate the device or emulator (Ctrl F11) for example.