Android ObjectBox数据库使用与集成指南

今天分享一套Android另一个数据库ObjectBox。ObjectBox 是一款专为移动端和物联网（IoT）设备设计的高性能 NoSQL 数据库，专注于极致的速度和轻量级资源占用。它由 GreenRobot 团队开发（同团队开发了 GreenDAO 和 EventBus），适用于 Android、iOS、Linux、Windows 等平台，尤其适合需要高效本地数据存储的场景。

ObjectBox其核心特点

• 非常高的性能
  • 基于原生 C 核心库，读写速度远超 SQLite 和其他 ORM 框架。
  • 支持 零拷贝序列化，减少内存分配，提升数据处理效率。
• 简单易用
  • 无 SQL 语法：通过链式 API 或 Kotlin/Java 方法直接操作对象，避免 SQL 注入风险。
  • 自动生成代码：通过注解生成数据模型和查询类（如 User_），减少手写代码。
• 经量级
  • 核心库体积小（约 1MB），适合移动端和嵌入式设备。
  • 低内存和 CPU 占用，延长设备续航时间。
• 实时数据同步（ObjectBox sync）
  • 提供端到端数据同步功能，支持离线优先的分布式应用（需商业授权），在一般项目应用中这项是用不到的，使用社区版即可。

ObjectBox与 SQLite 和 Realm 的对比

特性	ObjectBox	SQLite	Realm
性能	⚡️ 最快	中等	快
API 易用性	✅ 链式调用，无 SQL	❌ 需写 SQL	✅ 对象化操作
跨平台支持	Android, iOS, 桌面	通用	Android, iOS
同步功能	✅ (商业版)	❌	✅ (商业版)
开源协议	Apache 2.0	公有领域	Apache 2.0

Android集成ObjectBox

本人觉得直接接官网API仍有点麻烦，因此单独封装了SDK以便后面统一使用；

• 官方文档：https://docs.objectbox.io/
• GitHub 仓库：https://github.com/objectbox/objectbox-java

首先需要在libs.versions.toml添加包引用地址（gradle新版本才会有，老项目直接在dependencies配置即可）

objectboxGradlePlugin = "4.1.0"

objectbox-gradle-plugin = {
    module = "io.objectbox:objectbox-gradle-plugin", version.ref = "objectboxGradlePlugin" }

在项目根目录的build.gradle配置插件的classpath

buildscript {
   
    repositories {
   
        mavenCentral()
    }
    dependencies {
   
        classpath(libs.objectbox.gradle.plugin)
    }
}

然后在项目模块的build.gradle配置以下属性（配置完后记得需要同步），当然在这之前需要配置objectbox sdk引用，这一步完成之后包的objectbox就算集成好了；

storageObjectbox = "1.0.0"

eyinfo-storage-objectbox = {
    module = "io.github.eyinfo:storage-objectbox", version.ref = "storageObjectbox" }

plugins {
   
    alias(libs.plugins.android.application)
}

//导入插件
apply plugin: 'io.objectbox'

android {
   
    //常规配置项
}

dependencies {
   
    //引用objectbox sdk
    api libs.eyinfo.storage.objectbox
}

创建ObjectBox实体对象

• 对象必须要设置@Entity注解
• @Id注解：如果assignable=true表示主键值需要手动传入；如果assignable=false表示主键值为内部自增行为，无需外部传入；

@Entity
public class UserOB {
   

    @Id(assignable = true)
    private Long id;

    private int age;

    private String name;

    //生成getter、setter属性
}

这一步配置完后同步工程才能生成MyObjectBox对象，如果未自动生成MyObjectBox可能会导致后续无法使用ObjectBox数据库；

创建ObjectBox操作管理类OBManager

这里继承ObjectBoxAbstractManager实现与配置对应超类方法即可，方便使用整个模块中配置一次即可；

public class OBManager extends ObjectBoxAbstractManager {
   

    private static volatile OBManager instance;

    public static OBManager getInstance() {
   
        if (instance == null) {
   
            synchronized (OBManager.class) {
   
                if (instance == null) {
   
                    instance = new OBManager();
                }
            }
        }
        return instance