Revista-virtual2.0

SharedPreferences
public interface SharedPreferences
android.content.SharedPreferences
Interfaz para acceder y modificar los datos de preferencia devueltos por
getSharedPreferences (String, int). Para cualquier conjunto particular de
preferencias, hay una sola instancia de esta clase que todos los clientes
comparten. Las modificaciones de las preferencias deben pasar por un objeto
SharedPreferences.Editor para garantizar los valores de preferencia se
mantienen en un estado coherente y control cuando se cometen al
almacenamiento. Los objetos que se devuelven de los diversos métodos get
deben ser tratados como inmutable por la aplicación.
Las preferencias no son más que datos que una aplicación debe
guardar para personalizar la experiencia del usuario, por ejemplo
información personal, opciones de presentación, etc. En artículos
anteriores vimos ya uno de los métodos disponibles en la plataforma
Android para almacenar datos, como son las bases de datos SQLite.
Las preferencias de una aplicación se podrían almacenar por su
puesto utilizando este método, y no tendría nada de malo, pero
Android proporciona otro método alternativo diseñado
específicamente para administrar este tipo de datos: las preferencias
compartidas o shared preferences. Cada preferencia se almacenará
en forma de clave-valor, es decir, cada una de ellas estará compuesta
por un identificador único (p.e. “email”) y un valor asociado a dicho
identificador (p.e. “prueba@email.com”). Además, y a diferencia de
SQLite, los datos no se guardan en un fichero binario de base de
datos, sino en ficheros XML como veremos al final de este artículo.
La API para el manejo de estas preferencias es muy sencilla. Toda la
gestión se centraliza en la claseSharedPrefences, que representará a
una colección de preferencias. Una aplicación Android puede
gestionar varias colecciones de preferencias, que se diferenciarán
mediante un identificador único. Para obtener una referencia a una
colección determinada utilizaremos el
método getSharedPrefences() al que pasaremos el identificador de
la colección y un modo de acceso. El modo de acceso indicará qué
aplicaciones tendrán acceso a la colección de preferencias y qué
operaciones tendrán permitido realizar sobre ellas. Así, tendremos
tres posibilidades principales:

MODE_PRIVATE. Sólo nuestra aplicación tiene acceso a estas
preferencias.
MODE_WORLD_READABLE. Todas las aplicaciones pueden leer
estas preferencias, pero sólo la nuestra puede modificarlas.
MODE_WORLD_WRITABLE. Todas las aplicaciones pueden leer y
modificar estas preferencias.
Las dos últimas opciones son relativamente “peligrosas” por lo que en condiciones
normales no deberían usarse. De hecho, se han declarado como obsoletas en la API 17
(Android 4.2).
Nota: Esta clase no es compatible con el uso a través de múltiples procesos.
Clases anidadas
SharedPreferences.Editor
Interface
Interfaz utilizada para modificar los valores de un objeto SharedPreferences.
SharedPreferences.OnSharedPreferenceChangeListener
Interface
Definición de interfaz para una devolución de llamada que se invoca cuando se
cambia una preferencia compartida.
Los métodos públicos
Abstract boolean
contains(String key)
Comprueba si las preferencias contiene una preferencia.

Abstract
SharedPreferences.Edi
tor
Edit ()
Crear un nuevo editor para estas preferencias, a través del
cual se pueden hacer modificaciones a los datos de las
preferencias y atómicamente confirmar esos cambios de
nuevo a los SharedPreferences objetar.
Abstract Map
GetAll ()
Recuperar todos los valores de las preferencias.
Abstract boolean
GetBoolean (String key, boolean defValue)
Recuperar un valor booleano de las preferencias.
Abstract float
GetFloat (String key, float defValue)
Recuperar un valor flotante de las preferencias.
Abstract int.
GetInt (String key, int defValue)
Recuperar un valor int de las preferencias.
Abstract long
GetLong (String key, long defValue)
Recuperar un valor de tiempo de las preferencias.
Abstract String
GetString (String key, String defValue)
Recuperar un valor de cadena de las preferencias.
Abstract Set
getStringSet(String key, Set defValues)
Recuperar un conjunto de valores de cadena de las
preferencias.

Abstract void
RegisterOnSharedPreferenceChangeListener
(SharedPreferences.OnSharedPreferenceChangeListenerli
stener)
Registra una devolución de llamada que se invoca cuando
ocurre un cambio en la preferencia.
Abstract void
UnregisterOnSharedPreferenceChangeListener
(SharedPreferences.OnSharedPreferenceChangeListenerli
stener)
Elimina el registro de una devolución de llamada anterior.
SharedPreferences de Android
para guardar datos persistentes
¿Cuáles son SharedPreferences?
SharedPreferences son pares de valores clave de los tipos de datos primitivos que se
guardan en un archivo dentro de una estructura de archivos de aplicaciones. A
continuación, puede acceder a este archivo desde cualquier lugar dentro de la aplicación
ya sea para poner los datos en el archivo de datos o tomar fuera del archivo. No se puede
acceder al archivo desde otra aplicación así que es bastante seguro desde ese punto de
vista.
En dónde se utilice SharedPreferences?
Se podría, por ejemplo, utilizar SharedPreferences en un juego en el que se ahorraría el
nombre del usuario, puntuación más alta, y el estado del juego cuando se cierra la
sesión. A continuación, la próxima vez que inicien sesión, su puntuación y el nivel de juego
se puede recuperar desde el archivo de preferencias y que seguiría el juego desde donde
terminaron cuando se cierra la sesión.
Guarde los datos en unos archivos individuales o
múltiples SharedPreferences
Puede guardar los datos de preferencias en un único archivo o en varios archivos,
dependiendo de sus necesidades. El proceso es el mismo excepto por los
SharedPreferences objeto que se obtiene.
En el caso de un solo archivo, llame getPreferences () para obtener un objeto
SharedPreferences y para múltiples archivos, llamar getSharedPreferences () y pasarle un
nombre para el archivo como un parámetro.

getPreferences () - para las preferencias nivel de actividad. Cada actividad tendrá
su propio archivo de preferencias
getSharedPreferences () - para las preferencias de nivel de aplicación. Se puede
acceder al archivo de preferencias desde cualquier parte de la aplicación
Recuperando los datos
Una vez que tenga los SharedPreferences objeto, se puede utilizar un número de get
métodos para recuperar los valores.
Guardar los datos
Aseguramiento de los datos es bastante simple también. Sólo tiene que utilizar la clase
SharedPreferences.Editor para obtener un objeto Editor llamando edición () en las
SharedPreferences pertinentes objeto. A continuación, utilice la opción de venta
métodos para guardar los datos, finalizar el proceso llamando aplica () o commit () en el
objeto Editor.
La diferencia entre aplicar () y commit ()
aplicar()
Esto guarda los datos en la memoria inmediata y guarda los datos en el disco en un hilo
separado. Por lo tanto no hay ninguna posibilidad de bloquear el hilo principal (su
aplicación no se bloquea).
Es la técnica de elección, pero sólo ha estado disponible desde el pan de jengibre (API 9,
Android 2.3).
cometer()
Al llamar a este guardará los datos en el fichero sin embargo, el proceso se lleva a cabo en
el hilo que lo llamó, parando todo lo demás hasta que el almacenamiento se haya
completado. Se devuelve verdadero al finalizar con éxito, en caso de fallo.
Utilice commit () si necesita la confirmación del éxito de guardar los datos o si está en
desarrollo para dispositivos pre-pan de jengibre. commit () ha estado disponible desde el 1
de API
Tipo de datos que se puede ahorrar
Utilice SharedPreferences para guardar y recuperar tipos de datos primitivos en pares de
clave y valor (boolean, float, int, long, cuerdas). A partir de nido de abeja (11 API, Android
3.0) también se puede ahorrar Set conjuntos de valores de cadena.