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 指南

    安装引入

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

      

     

    快速上手

    MMKV 的使用非常简单,所有变更立马生效,无需调用 syncapply。 在 App 启动时初始化 MMKV,设定 MMKV 的根目录(files/mmkv/),例如在 Application 里:

    1
    2
    3
    4
    5
    6
    7
    public void onCreate() {
        super.onCreate();
     
        String rootDir = MMKV.initialize(this);
        System.out.println("mmkv root: " + rootDir);
        //……
    }

      

    MMKV 提供一个全局的实例,可以直接使用:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    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>
posted @   bg_不够  阅读(1490)  评论(0编辑  收藏  举报
编辑推荐:
· 一个奇形怪状的面试题:Bean中的CHM要不要加volatile?
· [.NET]调用本地 Deepseek 模型
· 一个费力不讨好的项目,让我损失了近一半的绩效!
· .NET Core 托管堆内存泄露/CPU异常的常见思路
· PostgreSQL 和 SQL Server 在统计信息维护中的关键差异
阅读排行:
· DeepSeek “源神”启动!「GitHub 热点速览」
· 微软正式发布.NET 10 Preview 1:开启下一代开发框架新篇章
· 我与微信审核的“相爱相杀”看个人小程序副业
· C# 集成 DeepSeek 模型实现 AI 私有化(本地部署与 API 调用教程)
· spring官宣接入deepseek,真的太香了~
点击右上角即可分享
微信分享提示