MMKV使用筆記

MMKV——基於 mmap 的高性能通用 key-value 組件

 

　　　　　　MMKV 是基於 mmap 內存映射的 key-value 組件，底層序列化/反序列化使用 protobuf 實現，性能高，穩定性強。從 2015 年中至今在微信上使用，其性能和穩定性經過了時間的驗證。近期也已移植到 Android / macOS / Win32 / POSIX 平台，一並開源。

　　　　　　文檔以及地址：https://github.com/Tencent/MMKV/blob/master/README_CN.md

　　　　MMKV 原理

• 內存准備
  通過 mmap 內存映射文件，提供一段可供隨時寫入的內存塊，App 只管往里面寫數據，由操作系統負責將內存回寫到文件，不必擔心 crash 導致數據丟失。
• 數據組織
  數據序列化方面我們選用 protobuf 協議，pb 在性能和空間占用上都有不錯的表現。
• 寫入優化
  考慮到主要使用場景是頻繁地進行寫入更新，我們需要有增量更新的能力。我們考慮將增量 kv 對象序列化后，append 到內存末尾。
• 空間增長
  使用 append 實現增量更新帶來了一個新的問題，就是不斷 append 的話，文件大小會增長得不可控。我們需要在性能和空間上做個折中。

  Android 指南

  安裝引入

  dependencies {
      implementation 'com.tencent:mmkv-static:1.2.9'
      // replace "1.2.9" with any available version
  }
  

  　　

   

  快速上手

  MMKV 的使用非常簡單，所有變更立馬生效，無需調用 sync、apply。 在 App 啟動時初始化 MMKV，設定 MMKV 的根目錄（files/mmkv/），例如在 Application 里：

  public void onCreate() {
      super.onCreate();
  
      String rootDir = MMKV.initialize(this);
      System.out.println("mmkv root: " + rootDir);
      //……
  }
  

  　　

  MMKV 提供一個全局的實例，可以直接使用：

  import com.tencent.mmkv.MMKV;
  //……
  
  MMKV kv = MMKV.defaultMMKV();
  
  kv.encode("bool", true);
  boolean bValue = kv.decodeBool("bool");
  
  kv.encode("int", Integer.MIN_VALUE);
  int iValue = kv.decodeInt("int");
  
  kv.encode("string", "Hello from mmkv");
  String str = kv.decodeString("string");

  支持的數據類型
  boolean、int、long、float、double、byte[]
  
  支持以下 Java 類和容器
  String、Set<String>