Paper：Android上的高速NoSQL存储解决方案

Paper：Android上的高速NoSQL存储解决方案

Paper Paper is a fast NoSQL-like storage for Java/Kotlin objects on Android with automatic schema migration support. 项目地址: https://gitcode.com/gh_mirrors/pap/Paper

项目介绍

Paper 是一个专为 Java 和 Kotlin 对象设计的Android平台上的轻量级、高性能存储库，它提供了自动模式迁移的支持。这意味着开发者可以在无需复杂数据迁移操作的情况下自由地对数据模型进行增删字段。此库基于Kryo序列化实现，优化了小数据集在移动设备上的存取速度，并且利用闪存上随机访问的效率。

项目快速启动

添加依赖

首先，在你的项目build.gradle文件中加入Paper的Maven Central依赖：

dependencies {
    implementation 'io.github.pilgr:paperdb:2.7.2'
}

初始化Paper

确保在你的应用程序的Application类的onCreate()方法中初始化Paper：

import io.github.pilgr.paperdb.Paper

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        Paper.init(this)
    }
}

写入数据

接下来，你可以轻松保存任何对象到Paper：

val contacts: List<Person> = ... // 获取你的联系人列表
Paper.book().write("contacts", contacts)

读取数据

读取数据同样简单：

val loadedContacts: List<Person> = Paper.book().read("contacts")
// 如果没有找到对应key的数据，默认提供空集合或自定义默认值
val safeContacts: List<Person> = Paper.book().read("contacts", arrayListOf())

删除数据

删除特定键对应的存储数据：

Paper.book().delete("contacts")

应用案例和最佳实践

• 配置迁移: 在升级应用版本时，即使数据结构有所变化，Paper会自动处理新增字段的默认值填充和移除字段的忽略。
• 多用户数据隔离: 通过创建不同的Book来管理不同用户的独立数据，如Paper.book("userProfile_$userId").

典型生态项目

虽然具体的生态项目直接引用较少，但Paper广泛适用于那些要求快速存取本地数据的Android应用。例如，AppDialer应用就采用了Paper作为其内部库来减少启动时间并实现了简单的无痛式NoSQL数据库层。其他项目虽未公开详细集成情况，但在提升本地数据管理效率方面，Paper可被类似Busmap这样的旅行导航应用采纳，用于存储站点、路线、时间表等数据。

---

这个简介旨在快速引导开发者了解和接入Paper库，实现在Android项目中的高效本地存储解决方案。深入探索更多高级功能和定制选项，建议直接参考GitHub仓库中的完整文档和示例代码。

Paper Paper is a fast NoSQL-like storage for Java/Kotlin objects on Android with automatic schema migration support. 项目地址: https://gitcode.com/gh_mirrors/pap/Paper