universum.studios.android.preference

Class ListPreference<T>

java.lang.Object

universum.studios.android.preference.SharedPreference<List<T>>

universum.studios.android.preference.ListPreference<T>

Type Parameters:

T - Type of items within a list of which values should be persisted.

Deprecated.

Use CollectionPreference instead.

@Deprecated
public final class ListPreference<T>
extends SharedPreference<List<T>>

This class has been deprecated and will be removed in the next release.

A SharedPreference implementation that may be used to persist a List of values via SharedPreferences.

Author:

Martin Albedinsky

See Also:

ArrayPreference

Nested Class Summary

Nested classes/interfaces inherited from class universum.studios.android.preference.SharedPreference

SharedPreference.PreferenceChangeCallback<P>

Constructor Summary

Constructors

Constructor and Description
ListPreference(int keyResId, Class<T> componentType, List<T> defValue) Deprecated. Use ListPreference(String, Class, List) instead.
ListPreference(String key, Class<T> componentType, List<T> defValue) Deprecated. Creates a new instance of ListPreference.

Method Summary

Modifier and Type	Method and Description
static <T> List<T>	getFromPreferences(android.content.SharedPreferences preferences, String key, List<T> defValue) Deprecated. Returns a List mapped in the given shared preferences under the specified key.
protected List<T>	onGetFromPreferences(android.content.SharedPreferences preferences) Deprecated. Invoked to retrieve the actual value of this preference from the given shared preferences.
protected boolean	onPutIntoPreferences(android.content.SharedPreferences preferences) Deprecated. Invoked to persist the actual value into the given shared preferences.
static <T> boolean	putIntoPreferences(android.content.SharedPreferences preferences, String key, List<T> list, Class<T> componentType) Deprecated. Saves the given list into the given shared preferences.

Methods inherited from class universum.studios.android.preference.SharedPreference

attachKey, createOnChangeListener, getDefaultValue, getKey, getKeyRes, getValue, putIntoPreferences, retrieve, save, updateValue

Methods inherited from class java.lang.Object

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

Constructor Detail

ListPreference

public ListPreference(String key,
                      Class<T> componentType,
                      List<T> defValue)

Deprecated.

Creates a new instance of ListPreference.

Parameters:

componentType - Class of components that will be presented within a list managed by the new list preference.

See Also:

SharedPreference.SharedPreference(String, Object)

ListPreference

@Deprecated
public ListPreference(int keyResId,
                                  Class<T> componentType,
                                  List<T> defValue)

Deprecated. Use ListPreference(String, Class, List) instead.

This constructor has been deprecated and will be removed in the next release.

Creates a new instance of ListPreference.

Parameters:

componentType - Class of components that will be presented within a list managed by the new list preference.

See Also:

SharedPreference.SharedPreference(int, Object)

Method Detail

onPutIntoPreferences

protected boolean onPutIntoPreferences(android.content.SharedPreferences preferences)

Deprecated.

Description copied from class: SharedPreference

Invoked to persist the actual value into the given shared preferences.

Specified by:

onPutIntoPreferences in class SharedPreference<List<T>>

Parameters:

preferences - The instance of shared preferences into which should be the current value of this preference persisted.

Returns:

True if put has been successful, false otherwise.

See Also:

putIntoPreferences(SharedPreferences, String, List, Class)

putIntoPreferences

public static <T> boolean putIntoPreferences(android.content.SharedPreferences preferences,
                                             String key,
                                             List<T> list,
                                             Class<T> componentType)

Deprecated.

Saves the given list into the given shared preferences.

Type Parameters:

T - Type of items which are presented within the given list.

Parameters:

preferences - The instance of shared preferences into which will be the given list saved.

key - The key under which will be the saved list mapped in the shared preferences.

list - List to save into preferences.

componentType - Class of components presented within the given list.

Returns:

True if saving has succeeded, false otherwise.

onGetFromPreferences

protected List<T> onGetFromPreferences(android.content.SharedPreferences preferences)

Deprecated.

Description copied from class: SharedPreference

Invoked to retrieve the actual value of this preference from the given shared preferences.

Specified by:

onGetFromPreferences in class SharedPreference<List<T>>

Parameters:

preferences - The instance of shared preferences into which was the value of this preference before saved.

Returns:

The actual value of this preference from the given shared preferences.

See Also:

getFromPreferences(SharedPreferences, String, List)

getFromPreferences

public static <T> List<T> getFromPreferences(android.content.SharedPreferences preferences,
                                             String key,
                                             List<T> defValue)

Deprecated.

Returns a List mapped in the given shared preferences under the specified key.

Type Parameters:

T - Type of an items which should be presented within the obtained list.

Parameters:

preferences - The instance of shared preferences into which was the requested list before saved.

key - The key under which is the saved list mapped in the shared preferences.

defValue - Default list to return if there is no mapping for the specified key yet.

Returns:

An instance of the requested list or defValue if there is no mapping for the specified key.

Throws:

ClassCastException - If value stored under the specified key does not represents an array/a list.

IllegalArgumentException - If type of the requested list is not supported by the Preferences library.

IllegalStateException - If the requested list was not stored by the Preferences library.