前言：
SharedPreferences很早就用过，但也只限于会用，隔了一段时间再用发现有点生疏，还是要去网上找用法，对其运行原理和不同方法间的区别也知之甚少，决定写一篇文章来总结一下，加深下印象和理解。
概述：
SharedPreferences是Android提供的几种常用的数据存储解决方案之一，应用可以通过它来访问和修改一些他们所关注的数据，常被用来存储少量的、格式简单的配置信息。其本质上是以键值（key-value）对的方式把用户设置信息存储在xml文件中的一种轻量级的数据存储方法。个人更愿意把它理解为是对文件数据存储方法的一个封装，开发者可以通过这个类更简便、更高效的去完成轻量级数据的存储。下面将围绕该存储方式所涉及到的两个主要类——SharedPreferences和SharedPreferencesImpl来逐步深入学习。
正文
SharedPreferences
从SharedPreferences的源码来看，SharedPreferences其实是一个接口类，里面定义了一系列对数据访问、修改和监听数据变化的方法。在数据访问方面，开发者可以通过其提供的getXXX方法来访问其存储的数据，通过contains方法来查询是否存储了你所关注的数据。在数据修改方面，SharedPreferences内部定义了一个内部类Editor，用来对数据进行添加（putXXX）、移除（remove，clear）、提交（commit，apply）等修改操作。SharedPreferences还提供了监听数据变化的监听器（OnSharedPreferenceChangeListener），开发者可以通过registerOnSharedPreferenceChangeListener方法来注册监听器，时刻关注感兴趣数据的变化，当不再需要监听时，可以通过unregisterOnSharedPreferenceChangeListener方法来注销监听器释放相关的资源。
SharedPreferencesImpl
SharedPreferencesImpl作为SharedPreferences的实现类，其内部结构大致跟SharedPreferences类差不多。下面对其内部源码进行逐一分解。
首先，来看一下SharedPreferencesImpl的构造方法：
SharedPreferencesImpl(File file, int mode) {
mFile = file;
mBackupFile = makeBackupFile(file);
mMode = mode;
mLoaded = false;
mMap = null;
startLoadFromDisk();
}
private void loadFromDisk() {
...
str = new BufferedInputStream(
new FileInputStream(mFile), 16*1024);
map = XmlUtils.readMapXml(str);
...
}
在SharedPreferencesImpl的构造方法中一共要传递两个参数，file和mode。其中，file是SharedPreferences用来存储数据的文件，mode决定了可以对这个file文件所做的操作。SharedPreferencesImpl首先会对file文件进行一个备份和相关的一些初始化，在构造函数的最后从传递过来的xml文件中读取数据并存储到内部的HashMap以便后续的操作。这里我们能很直观的看出SharedPreferences其本质就是对xml文件的操作，是对文件数据存储的一个封装。
其次，看一下SharedPreferencesImpl是如何实现读取数据的。以getString方法为例，可以看到getXXX方法的实现都比较简单，最外层是一个同步锁，内层awaitLoadedLocked相当于一个线程锁，如果数据加载没有完成就会一直死循环等待加载完成，通过这两个锁来保证数据读取的线程安全和准确性。这两个锁都顺利执行完就会从之前加载好的HashMap里面读取出对应key的值，如果值为空则返回之前约定的缺省值。
@Nullable
public String getString(String key, @Nullable String defValue) {
synchronized (mLock) {
awaitLoadedLocked();
String v = (String)mMap.get(key);
return v != null ? v : defValue;
}
}
private void awaitLoadedLocked() {
if (!mLoaded) {
// Raise an explicit StrictMode onReadFromDisk for this
// thread, since the real read will be in a different
// thread and otherwise ignored by StrictMode.
BlockGuard.getThreadPolicy().onReadFromDisk();
}
while (!mLoaded) {
try {
mLock.wait();
} catch (InterruptedException unused) {
}
}
}
再次，看一下数据是如何修改的。与SharedPreferences代码结构类似，SharedPreferencesImpl内部也实现了一个Editor的实现类EditorImpl，用来提供相应的数据存储、修改和删除等操作。还是以putString方法为例，发现与getString相比，putString的实现更为简单，紧使用了一个同步锁来保证线程安全，如果校验没有被锁的情况下就会把数据直接写入HashMap中。
public Editor putString(String key, @Nullable String value) {
synchronized (mLock) {
mModified.put(key, value);
return this;
}
}
使用putXXX或是remove等方法操作的都是读取到HashMap中的数据，只有调用了EditorImpl中的apply或是commit方法才会真正的把值写入xml文件永久的保存。 接下来通过源码来分析一下这两个方法的区别。
public void apply() {
final long startTime = System.currentTimeMillis();
final MemoryCommitResult mcr = commitToMemory();
final Runnable awaitCommit = new Runnable() {
public void run() {
try {
mcr.writtenToDiskLatch.await();
} catch (InterruptedException ignored) {
}
if (DEBUG && mcr.wasWritten) {
Log.d(TAG, mFile.getName() + ":" + mcr.memoryStateGeneration
+ " applied after " + (System.currentTimeMillis() - startTime)
+ " ms");
}
}
};
QueuedWork.addFinisher(awaitCommit);
Runnable postWriteRunnable = new Runnable() {
public void run() {
awaitCommit.run();
QueuedWork.removeFinisher(awaitCommit);
}
};
SharedPreferencesImpl.this.enqueueDiskWrite(mcr, postWriteRunnable);
// Okay to notify the listeners before it's hit disk
// because the listeners should always get the same
// SharedPreferences instance back, which has the
// changes reflected in memory.
notifyListeners(mcr);
}
public boolean commit() {
long startTime = 0;
if (DEBUG) {
startTime = System.currentTimeMillis();
}
MemoryCommitResult mcr = commitToMemory();
SharedPreferencesImpl.this.enqueueDiskWrite(
mcr, null /* sync write on this thread okay */);
try {
mcr.writtenToDiskLatch.await();
} catch (InterruptedException e) {
return false;
} finally {
if (DEBUG) {
Log.d(TAG, mFile.getName() + ":" + mcr.memoryStateGeneration
+ " committed after " + (System.currentTimeMillis() - startTime)
+ " ms");
}
}
notifyListeners(mcr);
return mcr.writeToDiskResult;
}
从源码上看，可以明显的看出有两个不同点：
1、commit方法有返回值，而apply方法没有。
2、apply方法在执行 SharedPreferencesImpl的enqueueDiskWrite方法进行排队时多传递了一个Runnable（postWriteRunnable）参数，这个参数传与不传有什么区别呢，我们接着来看enqueueDiskWrite方法的实现。
/**
* Enqueue an already-committed-to-memory result to be written
* to disk.
*
* They will be written to disk one-at-a-time in the order
* that they're enqueued.
*
* @param postWriteRunnable if non-null, we're being called
* from apply() and this is the runnable to run after
* the write proceeds. if null (from a regular commit()),
* then we're allowed to do this disk write on the main
* thread (which in addition to reducing allocations and
* creating a background thread, this has the advantage that
* we catch them in userdebug StrictMode reports to convert
* them where possible to apply() ...)
*/
private void enqueueDiskWrite(final MemoryCommitResult mcr,
final Runnable postWriteRunnable) {
final boolean isFromSyncCommit = (postWriteRunnable == null);
final Runnable writeToDiskRunnable = new Runnable() {
public void run() {
synchronized (mWritingToDiskLock) {
writeToFile(mcr, isFromSyncCommit);
}
synchronized (mLock) {
mDiskWritesInFlight--;
}
if (postWriteRunnable != null) {
postWriteRunnable.run();
}
}
};
// Typical #commit() path with fewer allocations, doing a write on
// the current thread.
if (isFromSyncCommit) {
boolean wasEmpty = false;
synchronized (mLock) {
wasEmpty = mDiskWritesInFlight == 1;
}
if (wasEmpty) {
writeToDiskRunnable.run();
return;
}
}
QueuedWork.queue(writeToDiskRunnable, !isFromSyncCommit);
}
从enqueueDiskWrite源码可以看出，如果通过commit方法提交修改，postWriteRunnable 不为空，在执行enqueueDiskWrite方法时会直接执行writeToDiskRunnable把数据写入磁盘。而通过apply方法提交的修改请求，则会把writeToDiskRunnable加入到排队序列中顺序执行。
小结：
通过上面的分析，通过commit和apply两种方法提交数据修改有两点不同：
1、commit方法有返回值，而apply方法没有。使用commit方法能够明确的知道你的提交是否成功，而在不关心提交结果的情况下可以使用apply方法。
2、commit方法是同步的，apply方法是异步的。在多个commit方法并发执行的时候，他们会等待正在处理的commit方法保存到磁盘后再操作，降低了效率。而apply不关心提交是否成功，不必等待返回结果，他们只需要把提交写到内存然后异步的顺序执行，最后提交的磁盘。
在大多数情况下，我们对commit的成功与否并不感兴趣，而且在数据并发处理时基于上述原因使用commit要比apply效率低，所以推荐使用apply。
总结
本文通过解读Android 8.0源码分析了SharedPreferences是如何实现数据的读写操作以及两种提交修改方法的区别和优缺点。关于SharedPreferences的具体使用方法可以参考Android 浅析 SharedPreferences (一) 使用。
参考文献：
https://developer.android.google.cn/reference/android/content/SharedPreferences.html
http://androidxref.com/8.0.0_r4/xref/frameworks/base/core/java/android/content/SharedPreferences.java
http://androidxref.com/8.0.0_r4/xref/frameworks/base/core/java/android/app/SharedPreferencesImpl.java
网友评论