Android数据存储之SharedPreferences

Nested Classes

interface

SharedPreferences.Editor

用于修改 SharedPreferences 对象中数据的接口。

interface

SharedPreferences.OnSharedPreferenceChangeListener

当共享数据被修改时该接口中的回调方法被调用

Public Methods

abstract boolean

contains(String key)

检查 preferences 是否包含一个 preference

参数

    key    要检查的 preference 的名称

返回

    如果存在这个 preference 就返回true，否则返回false。

abstract SharedPreferences.Editor

edit()

为 preferences 创建一个新的 Editor，通过它你可以对 preferences 中的数据进行修改并且原子地将修改后的数据提交到 SharedPreferences  中。

注意： 必须调用 commit() 将在 Editor 中修改的数据提交到 SharedPreferences 中。

返回

返回一个新的 SharedPreferences.Editor 接口的实例，允许你修改该 SharedPreferences  对象中的值。

abstract Map<String, ?>

getAll()

得到 preferences 中的所有值。

注意：你绝不能修改通过该方法返回的任何数据。否则将不能保证与你所存储数据的一致性。

返回

    返回一个表示该 preferences 中键-值对的map集合。

抛出

NullPointerException

abstract boolean

getBoolean(String key, boolean defValue)

返回 preferences 中的一个 布尔型数据。

参数

key       要得到的 preference  的名称

defValue     如果该preference  不存在则返回这个默认值

返回

如果存在则返回 preference 的值。如果该name对应的 preference  不是布尔型，则抛出ClassCastException 异常。

抛出

ClassCastException

abstract float

getFloat(String key, float defValue)

参考上一个方法

abstract int

getInt(String key, int defValue)

参考上一个方法

abstract long

getLong(String key, long defValue)

参考上一个方法

abstract String

getString(String key, String defValue)

参考上一个方法

abstract Set<String>

getStringSet(String key, Set<String> defValues)

参考上一个方法

abstract void

registerOnSharedPreferenceChangeListener(SharedPreferences.OnSharedPreferenceChangeListener listener)

注册监听器。当 SharedPreferences 中的值发生改变的时候该监听器中的回调方法被调用

参数

    listener    要注册的监听器

abstract void

unregisterOnSharedPreferenceChangeListener(SharedPreferences.OnSharedPreferenceChangeListener listener)

解注册之前注册的监听器

参数

    listener    要解注册的监听器