SavedStateHandle

public final class SavedStateHandle
extends Object

java.lang.Object
   ↳ androidx.lifecycle.SavedStateHandle

A handle to saved state passed down to ViewModel. You should use SavedStateViewModelFactory if you want to receive this object in ViewModel's constructor.

This is a key-value map that will let you write and retrieve objects to and from the saved state. These values will persist after the process is killed by the system and remain available via the same object.

You can read a value from it via get(String) or observe it via LiveData returned by getLiveData(String).

You can write a value to it via set(String, Object) or setting a value to MutableLiveData returned by getLiveData(String).

Summary

Public constructors

SavedStateHandle(Map<String, Object> initialState)

Creates a handle with the given initial arguments.

SavedStateHandle()

Creates a handle with the empty state.

Public methods

void clearSavedStateProvider(String key)

Clear any SavedStateRegistry.SavedStateProvider that was previously set via setSavedStateProvider(String, SavedStateProvider).

boolean contains(String key)
<T> T get(String key)

Returns a value associated with the given key.

<T> MutableLiveData<T> getLiveData(String key)

Returns a LiveData that access data associated with the given key.

<T> MutableLiveData<T> getLiveData(String key, T initialValue)

Returns a LiveData that access data associated with the given key.

Set<String> keys()

Returns all keys contained in this SavedStateHandle

Returned set contains all keys: keys used to get LiveData-s, to set SavedStateProviders and keys used in regular set(String, Object).

<T> T remove(String key)

Removes a value associated with the given key.

<T> void set(String key, T value)

Associate the given value with the key.

void setSavedStateProvider(String key, SavedStateRegistry.SavedStateProvider provider)

Set a SavedStateRegistry.SavedStateProvider that will have its state saved into this SavedStateHandle.

Inherited methods

Public constructors

SavedStateHandle

public SavedStateHandle (Map<String, Object> initialState)

Creates a handle with the given initial arguments.

Parameters
initialState Map

SavedStateHandle

public SavedStateHandle ()

Creates a handle with the empty state.

Public methods

clearSavedStateProvider

public void clearSavedStateProvider (String key)

Clear any SavedStateRegistry.SavedStateProvider that was previously set via setSavedStateProvider(String, SavedStateProvider). Note: calling this method within SavedStateRegistry.SavedStateProvider.saveState() is supported, but will only affect future state saving operations.

Parameters
key String: a key previously used with setSavedStateProvider(String, SavedStateRegistry.SavedStateProvider)

contains

public boolean contains (String key)

Parameters
key String

Returns
boolean true if there is value associated with the given key.

get

public T get (String key)

Returns a value associated with the given key.

Parameters
key String

Returns
T

getLiveData

public MutableLiveData<T> getLiveData (String key)

Returns a LiveData that access data associated with the given key.

Parameters
key String

Returns
MutableLiveData<T>

getLiveData

public MutableLiveData<T> getLiveData (String key, 
                T initialValue)

Returns a LiveData that access data associated with the given key. 

LiveData<String> liveData = savedStateHandle.get(KEY, "defaultValue");
LiveData can have null as a valid value. If the initialValue is null and the data does not already exist in the SavedStateHandle, the value of the returned LiveData will be set to null and observers will be notified. You can call getLiveData(String) if you want to avoid dispatching null to observers. 
String defaultValue = ...; // nullable
     LiveData<String> liveData;
     if (defaultValue != null) {
         liveData = savedStateHandle.getLiveData(KEY, defaultValue);
     } else {
         liveData = savedStateHandle.getLiveData(KEY);
     }

Parameters
key String: The identifier for the value
initialValue T: If no value exists with the given key, a new one is created with the given initialValue. Note that passing null will create a LiveData with null value.

Returns
MutableLiveDa