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>