com.evernote.android.state

Class StateSaver

java.lang.Object

com.evernote.android.state.StateSaver

public final class StateSaver
extends Object

Entry point to save and restore objects.

Field Summary

Fields

Modifier and Type	Field and Description
static String	ANDROID_PREFIX
static String	JAVA_PREFIX
static String	SUFFIX

Method Summary

Modifier and Type	Method and Description
static <T> void	restoreInstanceState(T target, Bundle state) Restore the given target from the passed in Bundle.
static <T extends View> Parcelable	restoreInstanceState(T target, Parcelable state) Restore the sate of the given view and return the super state of the parent class.
static <T> void	saveInstanceState(T target, Bundle state) Save the given target in the passed in Bundle.
static <T extends View> Parcelable	saveInstanceState(T target, Parcelable state) Save the state of the given view and the other state inside of the returned Parcelable.
static void	setEnabledForAllActivitiesAndSupportFragments(Application application, boolean enabled) Turns automatic instance saving on or off for all activities and fragments from the support library.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

SUFFIX

public static final String SUFFIX

See Also:

Constant Field Values

ANDROID_PREFIX

public static final String ANDROID_PREFIX

See Also:

Constant Field Values

JAVA_PREFIX

public static final String JAVA_PREFIX

See Also:

Constant Field Values

Method Detail

saveInstanceState

public static <T> void saveInstanceState(T target,
                                         Bundle state)

Save the given target in the passed in Bundle.

Parameters:

target - The object containing fields annotated with State.

state - The object is saved into this bundle.

restoreInstanceState

public static <T> void restoreInstanceState(T target,
                                            Bundle state)

Restore the given target from the passed in Bundle.

Parameters:

target - The object containing fields annotated with State.

state - The object is being restored from this bundle. Nothing is restored if the argument is null.

saveInstanceState

public static <T extends View> Parcelable saveInstanceState(T target,
                                                            Parcelable state)

Save the state of the given view and the other state inside of the returned Parcelable.

Parameters:

target - The view containing fields annotated with State.

state - The super state of the parent class of the view. Usually it isn't null.

Returns:

A parcelable containing the view's state and its super state.

restoreInstanceState

public static <T extends View> Parcelable restoreInstanceState(T target,
                                                               Parcelable state)

Restore the sate of the given view and return the super state of the parent class.

Parameters:

target - The view containing fields annotated with State.

state - The parcelable containing the view's state and its super sate.

Returns:

The super state of teh parent class of the view. Usually it isn't null.

setEnabledForAllActivitiesAndSupportFragments

public static void setEnabledForAllActivitiesAndSupportFragments(Application application,
                                                                 boolean enabled)

Turns automatic instance saving on or off for all activities and fragments from the support library. This avoids manual calls of saveInstanceState(Object, Bundle) and restoreInstanceState(Object, Bundle), instead the library is doing this automatically for you. It's still necessary to annotate fields with State, though.

The best place to turn on this feature is in your Application#onCreate() method.

Parameters:

application - Your application instance.

enabled - Whether this feature should be enabled.