SharedPreferences总结

前言:

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

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,098评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,213评论 2 380
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 149,960评论 0 336
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,519评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,512评论 5 364
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,533评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,914评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,574评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,804评论 1 296
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,563评论 2 319
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,644评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,350评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,933评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,908评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,146评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,847评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,361评论 2 342

推荐阅读更多精彩内容