当前位置:   article > 正文

Android基础-SharedPreferences详解_android sharedpreferences

android sharedpreferences

本文章针对 Android 7.0 源码进行分析

SharedPreferences是 Android 中比较常用的存储方法,它可以用来存储一些比较小的键值对集合,并最终会在手机的/data/data/package_name/shared_prefs/目录下生成一个 xml 文件存储数据。它的使用非常简单,是一个 Android 开发者的基本技能,在这里不加以阐述了。

SharedPreferences带给我们非常简单易用的数据存储读写功能的同时,不知大家有没有好奇过它底层是怎样实现的呢?

通过ContextImpl.getSharedPreferences方法能够获取SharedPreferences对象, 通过getXxx/putXxx方法能够进行读写操作,通过commit方法同步写磁盘,通过apply方法异步写磁盘。其中涉及到如下几个问题:

  • 获取SharedPreferences对象过程中,系统做了什么?
  • getXxx方法做了什么?
  • putXxx方法做了什么?
  • commit/apply方法如何实现同步/异步写磁盘?

下面,我们来一一解答这些疑惑。

疑问1:获取SharedPreferences对象,系统做了什么?

获取SharedPreferences对象

我们直接看ContextImpl.getSharedPreferences的源码:

  1. @Override
  2. public SharedPreferences getSharedPreferences(String name, int mode) {
  3. // At least one application in the world actually passes in a null
  4. // name. This happened to work because when we generated the file name
  5. // we would stringify it to "null.xml". Nice.
  6. if (mPackageInfo.getApplicationInfo().targetSdkVersion <
  7. Build.VERSION_CODES.KITKAT) {
  8. if (name == null) {
  9. name = "null";
  10. }
  11. }
  12. File file;
  13. synchronized (ContextImpl.class) {
  14. if (mSharedPrefsPaths == null) {
  15. mSharedPrefsPaths = new ArrayMap<>();
  16. }
  17. file = mSharedPrefsPaths.get(name);
  18. if (file == null) {
  19. // 创建一个对应路径 /data/data/packageName/name 的 File 对象
  20. file = getSharedPreferencesPath(name);
  21. mSharedPrefsPaths.put(name, file);
  22. }
  23. }
  24. // 这里调用了 getSharedPreferences(File file, int mode) 方法
  25. return getSharedPreferences(file, mode);
  26. }
  1. @Override
  2. public SharedPreferences getSharedPreferences(File file, int mode) {
  3. SharedPreferencesImpl sp;
  4. // 这里使用了 synchronized 关键字,确保了 SharedPreferences 对象的构造是线程安全的
  5. synchronized (ContextImpl.class) {
  6. // 获取SharedPreferences 对象的缓存,并复制给 cache
  7. final ArrayMap<File, SharedPreferencesImpl> cache = getSharedPreferencesCacheLocked();
  8. // 以参数 file 作为 key,获取缓存对象
  9. sp = cache.get(file);
  10. if (sp == null) { // 如果缓存中不存在 SharedPreferences 对象
  11. checkMode(mode);
  12. if (getApplicationInfo().targetSdkVersion >= android.os.Build.VERSION_CODES.O) {
  13. if (isCredentialProtectedStorage()
  14. && !getSystemService(UserManager.class)
  15. .isUserUnlockingOrUnlocked(UserHandle.myUserId())) {
  16. throw new IllegalStateException("SharedPreferences in credential encrypted "
  17. + "storage are not available until after user is unlocked");
  18. }
  19. }
  20. // 构造一个 SharedPreferencesImpl 对象
  21. sp = new SharedPreferencesImpl(file, mode);
  22. // 放入缓存 cache 中,方便下次直接从缓存中获取
  23. cache.put(file, sp);
  24. // 返回新构造的 SharedPreferencesImpl 对象
  25. return sp;
  26. }
  27. }
  28. // 这里涉及到多进程的逻辑
  29. if ((mode & Context.MODE_MULTI_PROCESS) != 0 ||
  30. getApplicationInfo().targetSdkVersion < android.os.Build.VERSION_CODES.HONEYCOMB) {
  31. // If somebody else (some other process) changed the prefs
  32. // file behind our back, we reload it. This has been the
  33. // historical (if undocumented) behavior.
  34. // 如果由其他进程修改了这个 SharedPreferences 文件,我们将会重新加载它
  35. sp.startReloadIfChangedUnexpectedly();
  36. }
  37. // 程序走到这里,说明命中了缓存,SharedPreferences 已经创建,直接返回
  38. return sp;
  39. }

这段源码的流程还是清晰易懂的,注释已经说得很明白,这里我们总结一下这个方法的要点:

  • 缓存未命中, 才构造SharedPreferences对象,也就是说,多次调用getSharedPreferences方法并不会对性能造成多大影响,因为又缓存机制
  • SharedPreferences对象的创建过程是线程安全的,因为使用了synchronize关键字
  • 如果命中了缓存,并且参数mode使用了Context.MODE_MULTI_PROCESS,那么将会调用sp.startReloadIfChangedUnexpectedly()方法,在startReloadIfChangedUnexpectedly方法中,会判断是否由其他进程修改过这个文件,如果有,会重新从磁盘中读取文件加载数据

接着,我们重点关注注释中的sp = new SharedPreferencesImpl(file, mode);//构造一个SharedPreferencesImpl对象这句代码。

构造SharedPreferencesImpl

  1. // SharedPreferencesImpl.java
  2. // 构造方法
  3. SharedPreferencesImpl(File file, int mode) {
  4. mFile = file;
  5. // 创建灾备文件,命名为prefsFile.getPath() + ".bak"
  6. mBackupFile = makeBackupFile(file);
  7. mMode = mode;
  8. // mLoaded代表是否已经加载完数据
  9. mLoaded = false;
  10. // 解析 xml 文件得到的键值对就存放在mMap中
  11. mMap = null;
  12. // 顾名思义,这个方法用于加载 mFile 这个磁盘上的 xml 文件
  13. startLoadFromDisk();
  14. }
  15. // 创建灾备文件,用于当用户写入失败的时候恢复数据
  16. private static File makeBackupFile(File prefsFile) {
  17. return new File(prefsFile.getPath() + ".bak");
  18. }

我们对SharedPreferencesImpl这个类的构造方法做一个总结:

  • 将传进来的参数file以及mode分别保存在mFile以及mMode
  • 创建一个.bak备份文件,当用户写入失败的时候会根据这个备份文件进行恢复工作
  • 将存放键值对的mMap初始化为null
  • 调用startLoadFromDisk()方法加载数据

上面四个要点中,最重要的就是最后一步,调用startLoadFromDisk()方法加载数据:

  1. // SharedPreferencesImpl.java
  2. private void startLoadFromDisk() {
  3. synchronized (this) {
  4. mLoaded = false;
  5. }
  6. //注意:这里我们可以看出,SharedPreferences 是通过开启一个线程来异步加载数据的
  7. new Thread("SharedPreferencesImpl-load") {
  8. public void run() {
  9. // 这个方法才是真正负责从磁盘上读取 xml 文件数据
  10. loadFromDisk();
  11. }
  12. }.start();
  13. }
  14. private void loadFromDisk() {
  15. synchronized (SharedPreferencesImpl.this) {
  16. // 如果正在加载数据,直接返回
  17. if (mLoaded) {
  18. return;
  19. }
  20. // 如果备份文件存在,删除原文件,把备份文件重命名为原文件的名字
  21. // 我们称这种行为叫做回滚
  22. if (mBackupFile.exists()) {
  23. mFile.delete();
  24. mBackupFile.renameTo(mFile);
  25. }
  26. }
  27. // Debugging
  28. if (mFile.exists() && !mFile.canRead()) {
  29. Log.w(TAG, "Attempt to read preferences file " + mFile + " without permission");
  30. }
  31. Map map = null;
  32. StructStat stat = null;
  33. try {
  34. // 获取文件信息,包括文件修改时间,文件大小等
  35. stat = Os.stat(mFile.getPath());
  36. if (mFile.canRead()) {
  37. BufferedInputStream str = null;
  38. try {
  39. // 读取数据并且将数据解析为jia
  40. str = new BufferedInputStream(
  41. new FileInputStream(mFile), *);
  42. map = XmlUtils.readMapXml(str);
  43. } catch (XmlPullParserException | IOException e) {
  44. Log.w(TAG, "getSharedPreferences", e);
  45. } finally {
  46. IoUtils.closeQuietly(str);
  47. }
  48. }
  49. } catch (ErrnoException e) {
  50. /* ignore */
  51. }
  52. synchronized (SharedPreferencesImpl.this) {
  53. // 加载数据成功,设置 mLoaded 为 true
  54. mLoaded = true;
  55. if (map != null) {
  56. // 将解析得到的键值对数据赋值给 mMap
  57. mMap = map;
  58. // 将文件的修改时间戳保存到 mStatTimestamp 中
  59. mStatTimestamp = stat.st_mtime;
  60. // 将文件的大小保存到 mStatSize 中
  61. mStatSize = stat.st_size;
  62. } else {
  63. mMap = new HashMap<>();
  64. }
  65. // 通知唤醒所有等待的线程
  66. notifyAll();
  67. }
  68. }

上面的源码中,我们对startLoadFromDisk()方法进行了分析,有分析我们可以得到以下几点总结:

  • 如果有备份文件,直接使用备份文件进行回滚
  • 第一次调用getSharedPreferences方法的时候,会从磁盘中加载数据,而数据的加载时通过开启一个子线程调用loadFromDisk方法进行异步读取的
  • 将解析得到的键值对数据保存在mMap
  • 将文件的修改时间戳以及大小分别保存在mStatTimestamp以及mStatSize中(保存这两个值有什么用呢?我们在分析getSharedPreferences方法时说过,如果有其他进程修改了文件,并且modeMODE_MULTI_PROCESS,将会判断重新加载文件。如何判断文件是否被其他进程修改过,没错,根据文件修改时间以及文件大小即可知道)
  • 调用notifyAll()方法通知唤醒其他等待线程,数据已经加载完毕

好了,至此,我们就解决了第一个疑问:调用ContextImpl.getSharedPreferences方法获取一个SharedPreferences对象的过程,系统做了什么工作?

下面给出一个时序流程图:

疑问2:getXxx做了什么?

我们以getString来分析这个问题:

  1. @Nullable
  2. public String getString(String key, @Nullable String defValue) {
  3. // synchronize 关键字用于保证 getString 方法是线程安全的
  4. synchronized (this) {
  5. // 方法 awaitLoadedLocked() 用于确保加载完数据并保存到 mMap 中才进行数据读取
  6. awaitLoadedLocked();
  7. // 根据 key 从 mMap中获取 value
  8. String v = (String)mMap.get(key);
  9. // 如果 value 不为 null,返回 value,如果为 null,返回默认值
  10. return v != null ? v : defValue;
  11. }
  12. }
  13. private void awaitLoadedLocked() {
  14. if (!mLoaded) {
  15. // Raise an explicit StrictMode onReadFromDisk for this
  16. // thread, since the real read will be in a different
  17. // thread and otherwise ignored by StrictMode.
  18. BlockGuard.getThreadPolicy().onReadFromDisk();
  19. }
  20. // 前面我们说过,mLoaded 代表数据是否已经加载完毕
  21. while (!mLoaded) {
  22. try {
  23. // 等待数据加载完成之后才返回继续执行代码
  24. wait();
  25. } catch (InterruptedException unused) {
  26. }
  27. }
  28. }

getString方法代码很简单,其他的例如getIntgetFloat方法也是一样的原理,我们直接对这个疑问进行总结:

  • getXxx方法是线程安全的,因为使用了synchronize关键字
  • getXxx方法是直接操作内存的,直接从内存中的mMap中根据传入的key读取value
  • getXxx方法有可能会卡在awaitLoadedLocked方法,从而导致线程阻塞等待(什么时候会出现这种阻塞现象呢?前面我们分析过,第一次调用getSharedPreferences方法时,会创建一个线程去异步加载数据,那么假如在调用完getSharedPreferences方法之后立即调用getXxx方法,此时的mLoaded很有可能为false,这就会导致awaiteLoadedLocked方法阻塞等待,直到loadFromDisk方法加载完数据并且调用notifyAll来唤醒所有等待线程

疑问3:putXxx方法做了什么?

说到写操作方法,首先想到的是通过sharedPreferences.edit()方法返回的SharedPreferences.Editor,所有我们对SharedPreferences写操作都是基于这个Editor类的。在 Android 系统中,Editor是一个接口类,它的具体实现类是EditorImpl

  1. public final class EditorImpl implements Editor {
  2. // putXxx/remove/clear等写操作方法都不是直接操作 mMap 的,而是将所有
  3. // 的写操作先记录在 mModified 中,等到 commit/apply 方法被调用,才会将
  4. // 所有写操作同步到 内存中的 mMap 以及磁盘中
  5. private final Map<String, Object> mModified = Maps.newHashMap();
  6. //
  7. private boolean mClear = false;
  8. public Editor putString(String key, @Nullable String value) {
  9. synchronized (this) {
  10. mModified.put(key, value);
  11. return this;
  12. }
  13. }
  14. public Editor putStringSet(String key, @Nullable Set<String> values) {
  15. synchronized (this) {
  16. mModified.put(key, (values == null) ? null : new HashSet<String>(values));
  17. return this;
  18. }
  19. }
  20. public Editor putInt(String key, int value) {
  21. synchronized (this) {
  22. mModified.put(key, value);
  23. return this;
  24. }
  25. }
  26. public Editor putLong(String key, long value) {
  27. synchronized (this) {
  28. mModified.put(key, value);
  29. return this;
  30. }
  31. }
  32. public Editor putFloat(String key, float value) {
  33. synchronized (this) {
  34. mModified.put(key, value);
  35. return this;
  36. }
  37. }
  38. public Editor putBoolean(String key, boolean value) {
  39. synchronized (this) {
  40. mModified.put(key, value);
  41. return this;
  42. }
  43. }
  44. public Editor remove(String key) {
  45. synchronized (this) {
  46. mModified.put(key, this);
  47. return this;
  48. }
  49. }
  50. ......
  51. 其他方法
  52. ......
  53. }

EditorImpl类的源码我们可以得出以下总结:

  • SharedPreferences的写操作是线程安全的,因为使用了synchronize关键字
  • 对键值对数据的增删记录保存在mModified中,而并不是直接对SharedPreferences.mMap进行操作(mModified会在commit/apply方法中起到同步内存SharedPreferences.mMap以及磁盘数据的作用)

疑问4:commit()/apply()方法如何实现同步/异步写磁盘?

commit()方法分析

先分析commit()方法,直接上源码:

  1. public boolean commit() {
  2. // 前面我们分析 putXxx 的时候说过,写操作的记录是存放在 mModified 中的
  3. // 在这里,commitToMemory() 方法就负责将 mModified 保存的写记录同步到内存中的 mMap 中
  4. // 并且返回一个 MemoryCommitResult 对象
  5. MemoryCommitResult mcr = commitToMemory();
  6. // enqueueDiskWrite 方法负责将数据落地到磁盘上
  7. SharedPreferencesImpl.this.enqueueDiskWrite( mcr, null /* sync write on this thread okay */);
  8. try {
  9. // 同步等待数据落地磁盘工作完成才返回
  10. mcr.writtenToDiskLatch.await();
  11. } catch (InterruptedException e) {
  12. return false;
  13. }
  14. // 通知观察者
  15. notifyListeners(mcr);
  16. return mcr.writeToDiskResult;
  17. }

commit()方法的主体结构很清晰简单:

  • 首先将写操作记录同步到内存的SharedPreferences.mMap中(将mModified同步到mMap
  • 然后调用enqueueDiskWrite方法将数据写入到磁盘上
  • 同步等待写磁盘操作完成(这就是为什么commit()方法会同步阻塞等待的原因)
  • 通知监听者(可以通过registerOnSharedPreferenceChangeListener方法注册监听)
  • 最后返回执行结果:true or false

看完了commit(),我们接着来看一下它调用的commitToMemory()方法:

  1. private MemoryCommitResult commitToMemory() {
  2. MemoryCommitResult mcr = new MemoryCommitResult();
  3. synchronized (SharedPreferencesImpl.this) {
  4. // We optimistically don't make a deep copy until
  5. // a memory commit comes in when we're already
  6. // writing to disk.
  7. if (mDiskWritesInFlight > 0) {
  8. // We can't modify our mMap as a currently
  9. // in-flight write owns it. Clone it before
  10. // modifying it.
  11. // noinspection unchecked
  12. mMap = new HashMap<String, Object>(mMap);
  13. }
  14. // 将 mMap 赋值给 mcr.mapToWriteToDisk,mcr.mapToWriteToDisk 指向的就是最终写入磁盘的数据
  15. mcr.mapToWriteToDisk = mMap;
  16. // mDiskWritesInFlight 代表的是“此时需要将数据写入磁盘,但还未处理或未处理完成的次数”
  17. // 将 mDiskWritesInFlight 自增1(这里是唯一会增加 mDiskWritesInFlight 的地方)
  18. mDiskWritesInFlight++;
  19. boolean hasListeners = mListeners.size() > 0;
  20. if (hasListeners) {
  21. mcr.keysModified = new ArrayList<String>();
  22. mcr.listeners =
  23. new HashSet<OnSharedPreferenceChangeListener>(mListeners.keySet());
  24. }
  25. synchronized (this) {
  26. // 只有调用clear()方法,mClear才为 true
  27. if (mClear) {
  28. if (!mMap.isEmpty()) {
  29. mcr.changesMade = true;
  30. // 当 mClear 为 true,清空 mMap
  31. mMap.clear();
  32. }
  33. mClear = false;
  34. }
  35. // 遍历 mModified
  36. for (Map.Entry<String, Object> e : mModified.entrySet()) {
  37. String k = e.getKey(); // 获取 key
  38. Object v = e.getValue(); // 获取 value
  39. // 当 value 的值是 "this" 或者 null,将对应 key 的键值对数据从 mMap 中移除
  40. if (v == this || v == null) {
  41. if (!mMap.containsKey(k)) {
  42. continue;
  43. }
  44. mMap.remove(k);
  45. } else { // 否则,更新或者添加键值对数据
  46. if (mMap.containsKey(k)) {
  47. Object existingValue = mMap.get(k);
  48. if (existingValue != null && existingValue.equals(v)) {
  49. continue;
  50. }
  51. }
  52. mMap.put(k, v);
  53. }
  54. mcr.changesMade = true;
  55. if (hasListeners) {
  56. mcr.keysModified.add(k);
  57. }
  58. }
  59. // 将 mModified 同步到 mMap 之后,清空 mModified 历史记录
  60. mModified.clear();
  61. }
  62. }
  63. return mcr;
  64. }

 

总的来说,commitToMemory()方法主要做了这几件事:

  • mDiskWritesInFlight自增1(mDiskWritesInFlight代表“此时需要将数据写入磁盘,但还未处理或未处理完成的次数”,提示,整个SharedPreferences的源码中,唯独在commitToMemory()方法中“有且仅有”一处代码会对mDiskWritesInFlight进行增加,其他地方都是减)
  • mcr.mapToWriteToDisk指向mMapmcr.mapToWriteToDisk就是最终需要写入磁盘的数据
  • 判断mClear的值,如果是true,清空mMap(调用clear()方法,会设置mCleartrue
  • 同步mModified数据到mMap中,然后清空mModified
  • 最后返回一个MemoryCommitResult对象,这个对象的mapToWriteToDisk参数指向了最终需要写入磁盘的mMap

需要注意的是,在commitToMemory()方法中,当mCleartrue,会清空mMap,但不会清空mModified,所以依然会遍历mModified,将其中保存的写记录同步到mMap中,所以下面这种写法是错误的:

  1. sharedPreferences.edit()
  2. .putString("key1", "value1") // key1 不会被 clear 掉,commit 之后依旧会被写入磁盘中
  3. .clear()
  4. .commit();

分析完commitToMemory()方法,我们再回到commit()方法中,对它调用的enqueueDiskWrite方法进行分析:

  1. private void enqueueDiskWrite(final MemoryCommitResult mcr, final Runnable postWriteRunnable) {
  2. // 创建一个 Runnable 对象,该对象负责写磁盘操作
  3. final Runnable writeToDiskRunnable = new Runnable() {
  4. public void run() {
  5. synchronized (mWritingToDiskLock) {
  6. // 顾名思义了,这就是最终通过文件操作将数据写入磁盘的方法了
  7. writeToFile(mcr);
  8. }
  9. synchronized (SharedPreferencesImpl.this) {
  10. // 写入磁盘后,将 mDiskWritesInFlight 自减1,代表写磁盘的需求减少一个
  11. mDiskWritesInFlight--;
  12. }
  13. if (postWriteRunnable != null) {
  14. // 执行 postWriteRunnable(提示,在 apply 中,postWriteRunnable 才不为 null)
  15. postWriteRunnable.run();
  16. }
  17. }
  18. };
  19. // 如果传进的参数 postWriteRunnable 为 null,那么 isFromSyncCommit 为 true
  20. // 温馨提示:从上面的 commit() 方法源码中,可以看出调用 commit() 方法传入的 postWriteRunnable 为 null
  21. final boolean isFromSyncCommit = (postWriteRunnable == null);
  22. // Typical #commit() path with fewer allocations, doing a write on the current thread.
  23. if (isFromSyncCommit) {
  24. boolean wasEmpty = false;
  25. synchronized (SharedPreferencesImpl.this) {
  26. // 如果此时只有一个 commit 请求(注意,是 commit 请求,而不是 apply )未处理,那么 wasEmpty 为 true
  27. wasEmpty = mDiskWritesInFlight == 1;
  28. }
  29. if (wasEmpty) {
  30. // 当只有一个 commit 请求未处理,那么无需开启线程进行处理,直接在本线程执行 writeToDiskRunnable 即可
  31. writeToDiskRunnable.run();
  32. return;
  33. }
  34. }
  35. // 将 writeToDiskRunnable 方法线程池中执行
  36. // 程序执行到这里,有两种可能:
  37. // 1. 调用的是 commit() 方法,并且当前只有一个 commit 请求未处理
  38. // 2. 调用的是 apply() 方法
  39. QueuedWork.singleThreadExecutor().execute(writeToDiskRunnable);
  40. }

上面的注释已经说得很明白了,在这里就不总结了,接着来分析下writeToFile这个方法:

  1. private void writeToFile(MemoryCommitResult mcr) {
  2. // Rename the current file so it may be used as a backup during the next read
  3. if (mFile.exists()) {
  4. if (!mcr.changesMade) {
  5. // If the file already exists, but no changes were
  6. // made to the underlying map, it's wasteful to
  7. // re-write the file. Return as if we wrote it
  8. // out.
  9. mcr.setDiskWriteResult(true);
  10. return;
  11. }
  12. if (!mBackupFile.exists()) {
  13. if (!mFile.renameTo(mBackupFile)) {
  14. Log.e(TAG, "Couldn't rename file " + mFile
  15. + " to backup file " + mBackupFile);
  16. mcr.setDiskWriteResult(false);
  17. return;
  18. }
  19. } else {
  20. mFile.delete();
  21. }
  22. }
  23. // Attempt to write the file, delete the backup and return true as atomically as
  24. // possible. If any exception occurs, delete the new file; next time we will restore
  25. // from the backup.
  26. try {
  27. FileOutputStream str = createFileOutputStream(mFile);
  28. if (str == null) {
  29. mcr.setDiskWriteResult(false);
  30. return;
  31. }
  32. XmlUtils.writeMapXml(mcr.mapToWriteToDisk, str);
  33. FileUtils.sync(str);
  34. str.close();
  35. ContextImpl.setFilePermissionsFromMode(mFile.getPath(), mMode, 0);
  36. try {
  37. final StructStat stat = Libcore.os.stat(mFile.getPath());
  38. synchronized (this) {
  39. mStatTimestamp = stat.st_mtime;
  40. mStatSize = stat.st_size;
  41. }
  42. } catch (ErrnoException e) {
  43. // Do nothing
  44. }
  45. // Writing was successful, delete the backup file if there is one.
  46. mBackupFile.delete();
  47. mcr.setDiskWriteResult(true);
  48. return;
  49. } catch (XmlPullParserException e) {
  50. Log.w(TAG, "writeToFile: Got exception:", e);
  51. } catch (IOException e) {
  52. Log.w(TAG, "writeToFile: Got exception:", e);
  53. }
  54. // Clean up an unsuccessfully written file
  55. if (mFile.exists()) {
  56. if (!mFile.delete()) {
  57. Log.e(TAG, "Couldn't clean up partially-written file " + mFile);
  58. }
  59. }
  60. mcr.setDiskWriteResult(false);
  61. }

writeToFile这个方法大致分为三个过程:

  • 先把已存在的老的 SP 文件重命名(加“.bak”后缀),然后删除老的 SP 文件,这相当于做了备份(灾备)
  • mFile中一次性写入所有键值对数据,即mcr.mapToWriteToDisk(这就是commitToMemory所说的保存了所有键值对数据的字段) 一次性写入到磁盘。 如果写入成功则删除备份(灾备)文件,同时记录了这次同步的时间
  • 如果往磁盘写入数据失败,则删除这个半成品的 SP 文件

通过上面的分析,我们对commit()方法的整个调用链以及它干了什么都有了认知,下面给出一个图方便记忆理解:

 

apply()方法分析

分析完commit()方法,再去分析apply()方法就轻松多了:

  1. public void apply() {
  2. // 将 mModified 保存的写记录同步到内存中的 mMap 中,并且返回一个 MemoryCommitResult 对象
  3. final MemoryCommitResult mcr = commitToMemory();
  4. final Runnable awaitCommit = new Runnable() {
  5. public void run() {
  6. try {
  7. mcr.writtenToDiskLatch.await();
  8. } catch (InterruptedException ignored) {
  9. }
  10. }
  11. };
  12. QueuedWork.add(awaitCommit);
  13. Runnable postWriteRunnable = new Runnable() {
  14. public void run() {
  15. awaitCommit.run();
  16. QueuedWork.remove(awaitCommit);
  17. }
  18. };
  19. // 将数据落地到磁盘上,注意,传入的 postWriteRunnable 参数不为 null,所以在
  20. // enqueueDiskWrite 方法中会开启子线程异步将数据写入到磁盘中
  21. SharedPreferencesImpl.this.enqueueDiskWrite(mcr, postWriteRunnable);
  22. // Okay to notify the listeners before it's hit disk
  23. // because the listeners should always get the same
  24. // SharedPreferences instance back, which has the
  25. // changes reflected in memory.
  26. notifyListeners(mcr);
  27. }

总结一下apply()方法:

  • commitToMemory()方法将mModified中记录的写操作同步回写到内存 SharedPreferences.mMap 中。此时, 任何的getXxx方法都可以获取到最新数据了
  • 通过enqueueDiskWrite方法调用writeToFile将方法将所有数据异步写入到磁盘中

下面也给出一个apply()时序流程图帮助记忆理解:

commit与apply区别:

  • commit() 是直接同步地提交到硬件磁盘,因此,多个并发的采用 commit() 做提交的时候,它们会等待正在处理的 commit() 保存到磁盘后再进行操作,从而降低了效率。而 apply() 只是原子的提交到内容,后面再调用 apply() 的函数进行异步操作。
  • 翻源码可以发现 apply() 返回值为 void,而 commit() 返回一个 boolean 值代表是否提交成功。
  • apply() 方法不会有任何失败的提示。

那到底使用 commit() 还是 apply()?

大多数情况下,我们都是在同一个进程中,这时候的 SharedPrefrence 都是单实例,一般不会出现并发冲突,如果对提交的结果不关心的话,我们非常建议用 apply() ,当然需要确保操作成功且有后续操作的话,还是需要用 commit() 的。

SharedPreferences总结

  • SharedPreferences是线程安全的,它的内部实现使用了大量synchronized关键字
  • SharedPreferences不是进程安全的
  • 第一次调用getSharedPreferences会加载磁盘 xml 文件(这个加载过程是异步的,通过new Thread来执行,所以并不会在构造SharedPreferences的时候阻塞线程,但是会阻塞getXxx/putXxx/remove/clear等调用),但后续调用getSharedPreferences会从内存缓存中获取。 如果第一次调用getSharedPreferences时还没从磁盘加载完毕就马上调用 getXxx/putXxx, 那么getXxx/putXxx操作会阻塞,直到从磁盘加载数据完成后才返回
  • 所有的getXxx都是从内存中取的数据,数据来源于SharedPreferences.mMap
  • apply同步回写(commitToMemory())内存SharedPreferences.mMap,然后把异步回写磁盘的任务放到一个单线程的线程池队列中等待调度。apply不需要等待写入磁盘完成,而是马上返回
  • commit同步回写(commitToMemory())内存SharedPreferences.mMap,然后如果mDiskWritesInFlight(此时需要将数据写入磁盘,但还未处理或未处理完成的次数)的值等于1,那么直接在调用commit的线程执行回写磁盘的操作,否则把异步回写磁盘的任务放到一个单线程的线程池队列中等待调度。commit会阻塞调用线程,知道写入磁盘完成才返回
  • MODE_MULTI_PROCESS是在每次getSharedPreferences时检查磁盘上配置文件上次修改时间和文件大小,一旦所有修改则会重新从磁盘加载文件,所以并不能保证多进程数据的实时同步
  • 从 Android N 开始,,不支持MODE_WORLD_READABLE & MODE_WORLD_WRITEABLE。一旦指定, 直接抛异常

 

使用注意事项

  • 不要使用SharedPreferences作为多进程通信手段。由于没有使用跨进程的锁,就算使用MODE_MULTI_PROCESSSharedPreferences在跨进程频繁读写有可能导致数据全部丢失。根据线上统计,SP 大约会有万分之一的损坏率

  • 每个 SP 文件不能过大。SharedPreference的文件存储性能与文件大小相关,我们不要将毫无关联的配置项保存在同一个文件中,同时考虑将频繁修改的条目单独隔离出来

  • 还是每个 SP 文件不能过大。在第一个getSharedPreferences时,会先加载 SP 文件进内存,过大的 SP 文件会导致阻塞,甚至会导致 ANR

  • 依旧是每个 SP 文件不能过大。每次apply或者commit,都会把全部的数据一次性写入磁盘, 所以 SP 文件不应该过大, 影响整体性能

本文转载自:面试高频题:一眼看穿 SharedPreferences - 掘金 (juejin.cn) 

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/代码创作者/article/detail/60731
推荐阅读
相关标签
  

闽ICP备14008679号