objectbox-go: 高性能嵌入式NoSQL对象数据库插件库

objectbox-go 是一个高性能的嵌入式 NoSQL 对象数据库，专为 Go 语言设计。它提供了对象持久化、实时数据同步和高效查询等功能，非常适合嵌入式系统和本地存储场景。

主要特性

• 高性能：基于 C++ 核心，提供接近原生速度的操作
• 零配置：开箱即用，无需服务器设置
• 对象关系映射：自动将 Go 结构体映射到数据库
• 实时查询：支持数据变化的实时通知
• 跨平台：支持 Windows、Linux、macOS 等平台

安装

首先安装 objectbox-go 和 objectbox-generator：

go get -u github.com/objectbox/objectbox-go
go get -u github.com/objectbox/objectbox-go/cmd/objectbox-gogen

基本使用示例

1. 定义数据模型

//go:generate go run github.com/objectbox/objectbox-go/cmd/objectbox-gogen

type Task struct {
	Id           uint64
	Text         string
	DateCreated  time.Time
	DateFinished time.Time
}

运行 go generate 生成绑定代码：

go generate ./...

2. 初始化数据库

package main

import (
	"fmt"
	"log"
	"time"

	"github.com/objectbox/objectbox-go/objectbox"
)

func main() {
	// 创建 ObjectBox 实例
	ob, err := objectbox.NewBuilder().Model(ObjectBoxModel()).Build()
	if err != nil {
		log.Fatal(err)
	}
	defer ob.Close()

	// 获取 Task 的 Box (类似于表)
	box := BoxForTask(ob)

	// 创建并保存新任务
	task := &Task{
		Text:        "Learn ObjectBox",
		DateCreated: time.Now(),
	}
	id, err := box.Put(task)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("Task saved with ID: %d\n", id)

	// 查询所有任务
	tasks, err := box.GetAll()
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println("All tasks:")
	for _, t := range tasks {
		fmt.Printf("- %s (ID: %d)\n", t.Text, t.Id)
	}
}

高级功能示例

1. 条件查询

// 查询未完成的任务
query := box.Query(
	Task_.DateFinished.Equals(0),
)
tasks, err := query.Find()
if err != nil {
	log.Fatal(err)
}

2. 实时数据观察

// 创建观察者
subscription := box.Subscribe(func() {
	tasks, _ := box.GetAll()
	fmt.Println("Tasks updated, count:", len(tasks))
})

// 取消订阅（通常在程序退出时）
defer subscription.Close()

3. 事务处理

err := ob.RunInWriteTx(func() error {
	// 在事务中执行多个操作
	_, err1 := box.Put(&Task{Text: "Task 1"})
	_, err2 := box.Put(&Task{Text: "Task 2"})
	
	if err1 != nil || err2 != nil {
		return fmt.Errorf("transaction failed")
	}
	return nil
})

性能优化技巧

1. 批量操作：使用 PutMany 替代多次 Put

   tasks := []*Task{
       {Text: "Task 1"},
       {Text: "Task 2"},
   }
   _, err := box.PutMany(tasks)
   

2. 索引优化：为频繁查询的字段添加索引

   // 在模型定义中添加注释
   type Task struct {
       Id   uint64
       Text string `objectbox:"index"`
   }
   

3. 使用查询构建器：避免每次都重新构建查询

   unfinishedQuery := box.Query(Task_.DateFinished.Equals(0))
   defer unfinishedQuery.Close()
   

与其它数据库比较

• 相比 SQLite：objectbox-go 提供更自然的对象持久化，无需手动处理 ORM
• 相比 BoltDB：objectbox-go 有更丰富的查询功能和类型支持
• 相比 Badger：objectbox-go 提供更高级的对象关系映射

适用场景

• 需要本地持久化的桌面应用
• 移动应用的后端数据存储
• 嵌入式系统和 IoT 设备
• 需要高性能读写的应用

objectbox-go 是一个强大而轻量级的解决方案，特别适合需要嵌入式数据库但又不想处理复杂 SQL 或低级别键值存储的开发场景。