前言

Linus Benedict Torvalds : RTFSC – Read The Fucking Source Code

概括

The SharedPreferences class provides a general framework that allows you to save and retrieve persistent key-value pairs of primitive data types. You can use SharedPreferences to save any primitive data: booleans, floats, ints, longs, and strings. This data will persist across user sessions (even if your application is killed).
翻译:
SharedPreferences类提供了一个通用的框架,允许你保存和检索原始数据类型的持久的键-值对。你可以使用SharedPreferences保存任何原始数据:布尔型,整型,漂浮,渴望,和字符串。此数据将持续整个用户周期(即使您的应用程序被杀害)。

使用

去使用SharedPreference有两个方法:

  • getSharedPreferences() - 使用这个函数如果你需要多个preferences文件需在第一个参数指定的名称来区分。
  • getPreferences() - 如果你只需要一个preferences文件,请使用此函数。因为这将是您的活动的唯一首选文件,您不需要提供名称。

写入SharedPreference

SharedPreferences preference = null;preference = context.getSharedPreferences("text", 0);SharedPreferences.Editor editor = preference.edit();editor.putBoolean("silentMode", false);editor.commit();

写入SharedPreferecen非常简单,首先是获取一个preference的实例对象,通过这个实例对象拿到Editor的引用,然后就可以传入想要传入的值,最后,再调用commit来完成。

获取SharedPreference

SharedPreferences preference = null;preference = context.getSharedPreferences("text", 0);boolean silent =  preference.getBoolean("silentMode", false);

获取SharedPreferecen也很容易,同样首先获取一个preference的实例对象,之后便可通过key直接获取想要获取的值了。

主要类

SharedPreferences

Interface for accessing and modifying preference data returned by getSharedPreferences(String, int). For any particular set of preferences, there is a single instance of this class that all clients share. Modifications to the preferences must go through an SharedPreferences.Editor object to ensure the preference values remain in a consistent state and control when they are committed to storage. Objects that are returned from the various get methods must be treated as immutable by the application.
翻译:
这是个接口类,给予从getSharedPreferences(String, int)函数访问和修改preference数据的功能。每个独立的preferences,这里都有一个唯一的接口类给所有客户端使用。修改preferences数据必须通过SharedPreferences接口。Editor对象保证preference值保持一致的状态和控制他们提交到存储里。从各种各样的get方法返回的对象必须由应用程序被视为不可变的。

注意:现在还不支持多进程安全,以后会添加。

内部类

Editor

Interface used for modifying values in a SharedPreferences object. All changes you make in an editor are batched, and not copied back to the original SharedPreferences until you call commit() or apply()
翻译:接口类用来在SharedPreferences对象里修改参数。所有的你做的修改都是批处理,并且不会复制回原来的SharedPreferences对象直到你调用commit() 或 apply()函数。

OnSharedPreferenceChangeListener

Interface definition for a callback to be invoked when a shared preference is changed.
翻译:接口类用来作为一个回调在一个preference被修改是调用。

内部主要方法:

SharedPreferences.edit()

创建一个新的Editor类型给这个preferences,通过这个你可以修改preferences的数据和自动提交这些修改到这个SharedPreferences对象。

注意:需要调用commit()在你每次通过Editor对SharedPreferences进行修改后。

SharedPreferences.Editor.commit()

提交你对于preferences的修改给SharedPreferences的对象。这会自动执行所要求的修改或者替换所有存在的SharedPreferences。

注意:如果同时提交,最后的提交动作会被执行。

SharedPreferences.Editor.apply()

功能跟commit() 函数一样。

这两个方法的区别在于:

  1. apply没有返回值而commit返回boolean表明修改是否提交成功。
  2. apply是将修改数据原子提交到内存, 而后异步真正提交到硬件磁盘, 而commit是同步的提交到硬件磁盘,因此,在多个并发的提交commit的时候,他们会等待正在处理的commit保存到磁盘后在操作,从而降低了效率。而apply只是原子的提交到内容,后面有调用apply的函数的将会直接覆盖前面的内存数据,这样从一定程度上提高了很多效率。
  3. apply方法不会提示任何失败的提示。 由于在一个进程中,sharedPreference是单实例,一般不会出现并发冲突,如果对提交的结果不关心的话,建议使用apply,当然需要确保提交成功且有后续操作的话,还是需要用commit的。

更多相关文章

  1. ”Android(安卓)Application Framework FAQ“关于Android框架的
  2. Notification 最简单的使用
  3. android 按钮点击事件
  4. Android之ListView优化
  5. android 查看手机运行的进程列表
  6. android修改默认桌面
  7. android INSTALL_FAILED_OLDER_SDK
  8. Android(安卓)到底什么是Dialog?
  9. android pull解析XML文件

随机推荐

  1. 牛人文章学习
  2. Androidstudio 导入mode 报错:"Manifest m
  3. Android判断当前App是在前台还是在后台
  4. Android开源项目推荐之【图片选择器】
  5. Android 轻松实现语音识别的完整代码[转]
  6. 为Android应用程序读取/dev下设备而提权(
  7. Android中解析XML_DOM_SAX_PULL
  8. Android(安卓)开源框架
  9. android error: Apostrophe not preceded
  10. Android 关机流程分析-----(2)JNI和kernel