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