MMKV學習（三）Android使用

MMKV
MMKV 原理
MMKV for Android 多進程設計與實現

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

Android 指南

安裝引入
推薦使用 Maven：

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

使用指南
MMKV 的使用非常簡單，所有變更立馬生效，無需調用 sync、apply。

配置 MMKV 根目錄
在 App 啓動時初始化 MMKV，設定 MMKV 的根目錄（files/mmkv/），例如在 Application 裏：

public void onCreate() {
    super.onCreate();

    String rootDir = MMKV.initialize(this);
    System.out.println("mmkv root: " + rootDir);
}

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

import com.tencent.mmkv.MMKV;
...
MMKV kv = MMKV.defaultMMKV();

kv.encode("bool", true);
System.out.println("bool: " + kv.decodeBool("bool"));

kv.encode("int", Integer.MIN_VALUE);
System.out.println("int: " + kv.decodeInt("int"));

kv.encode("long", Long.MAX_VALUE);
System.out.println("long: " + kv.decodeLong("long"));

kv.encode("float", -3.14f);
System.out.println("float: " + kv.decodeFloat("float"));

kv.encode("double", Double.MIN_VALUE);
System.out.println("double: " + kv.decodeDouble("double"));

kv.encode("string", "Hello from mmkv");
System.out.println("string: " + kv.decodeString("string"));

byte[] bytes = {'m', 'm', 'k', 'v'};
kv.encode("bytes", bytes);
System.out.println("bytes: " + new String(kv.decodeBytes("bytes")));

可以看到，MMKV 在使用上還是比較簡單的。

刪除 & 查詢：

MMKV kv = MMKV.defaultMMKV();

kv.removeValueForKey("bool");
System.out.println("bool: " + kv.decodeBool("bool"));
    
kv.removeValuesForKeys(new String[]{"int", "long"});
System.out.println("allKeys: " + Arrays.toString(kv.allKeys()));

boolean hasBool = kv.containsKey("bool");

如果不同業務需要區別存儲，也可以單獨創建自己的實例：

MMKV* mmkv = MMKV.mmkvWithID("MyID");
mmkv.encode("bool", true);

如果業務需要多進程訪問，那麼在初始化的時候加上標誌位
MMKV.MULTI_PROCESS_MODE：

MMKV* mmkv = MMKV.mmkvWithID("InterProcessKV", MMKV.MULTI_PROCESS_MODE);
mmkv.encode("bool", true);

支持的數據類型
支持以下 Java 語言基礎類型：

boolean、int、long、float、double、byte[]

支持以下 Java 類和容器：

String、Set<String>

任何實現了Parcelable的類型
SharedPreferences 遷移
MMKV 提供了 importFromSharedPreferences() 函數，可以比較方便地遷移數據過來。

MMKV 還額外實現了一遍 SharedPreferences、SharedPreferences.Editor 這兩個 interface，在遷移的時候只需兩三行代碼即可，其他 CRUD 操作代碼都不用改。

private void testImportSharedPreferences() {
    //SharedPreferences preferences = getSharedPreferences("myData", MODE_PRIVATE);
    MMKV preferences = MMKV.mmkvWithID("myData");
    // 遷移舊數據
    {
        SharedPreferences old_man = getSharedPreferences("myData", MODE_PRIVATE);
        preferences.importFromSharedPreferences(old_man);
        old_man.edit().clear().commit();
    }
    // 跟以前用法一樣
    SharedPreferences.Editor editor = preferences.edit();
    editor.putBoolean("bool", true);
    editor.putInt("int", Integer.MIN_VALUE);
    editor.putLong("long", Long.MAX_VALUE);
    editor.putFloat("float", -3.14f);
    editor.putString("string", "hello, imported");
    HashSet<String> set = new HashSet<String>();
    set.add("W"); set.add("e"); set.add("C"); set.add("h"); set.add("a"); set.add("t");
    editor.putStringSet("string-set", set);
    // 無需調用 commit()
    //editor.commit();
}