使用Hare轻量级JSON数据库管理库

Hare是一个轻量级的Go语言JSON文本文件数据库管理库，它提供了简单易用的API来操作基于JSON文件的数据库。下面我将详细介绍Hare的使用方法。

安装Hare

首先使用go get安装Hare：

go get github.com/jameycribbs/hare

基本使用方法

1. 初始化数据库

package main

import (
	"fmt"
	"log"

	"github.com/jameycribbs/hare"
)

type Person struct {
	ID   int    `json:"id"`
	Name string `json:"name"`
	Age  int    `json:"age"`
}

func main() {
	// 初始化数据库
	db, err := hare.New("data", "people", &Person{})
	if err != nil {
		log.Fatal(err)
	}
	defer db.Close()
	
	// 使用数据库...
}

2. 插入数据

// 创建新记录
person := Person{
	ID:   1,
	Name: "Alice",
	Age:  30,
}

// 插入记录
err = db.Insert(person)
if err != nil {
	log.Fatal(err)
}

3. 查询数据

// 根据ID查询
var result Person
err = db.Find(1, &result)
if err != nil {
	log.Fatal(err)
}

fmt.Printf("Found: %+v\n", result)

// 查询所有记录
ids, err := db.IDs()
if err != nil {
	log.Fatal(err)
}

for _, id := range ids {
	var p Person
	err = db.Find(id, &p)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("Person %d: %+v\n", id, p)
}

4. 更新数据

// 更新记录
updatedPerson := Person{
	ID:   1,
	Name: "Alice Smith",
	Age:  31,
}

err = db.Update(updatedPerson)
if err != nil {
	log.Fatal(err)
}

5. 删除数据

// 删除记录
err = db.Delete(1)
if err != nil {
	log.Fatal(err)
}

高级功能

1. 查询所有记录

// 获取所有记录
var allPeople []Person
err = db.FindAll(&allPeople)
if err != nil {
	log.Fatal(err)
}

for _, p := range allPeople {
	fmt.Printf("Person: %+v\n", p)
}

2. 条件查询

Hare本身不提供复杂的查询功能，但可以结合Go代码实现：

// 自定义查询函数
func findAdults(db *hare.Database) ([]Person, error) {
	var all []Person
	var adults []Person
	
	err := db.FindAll(&all)
	if err != nil {
		return nil, err
	}

	for _, p := range all {
		if p.Age >= 18 {
			adults = append(adults, p)
		}
	}

	return adults, nil
}

// 使用自定义查询
adults, err := findAdults(db)
if err != nil {
	log.Fatal(err)
}

for _, a := range adults {
	fmt.Printf("Adult: %+v\n", a)
}

3. 事务处理

// 开始事务
tx, err := db.Begin()
if err != nil {
	log.Fatal(err)
}

// 在事务中操作
err = tx.Insert(Person{ID: 2, Name: "Bob", Age: 25})
if err != nil {
	tx.Rollback()
	log.Fatal(err)
}

// 提交事务
err = tx.Commit()
if err != nil {
	log.Fatal(err)
}

注意事项

1. Hare是一个简单的JSON文件数据库，不适合高并发场景
2. 每个表对应一个JSON文件，存储在指定的目录中
3. 所有操作都是同步的，没有内置的缓存机制
4. 对于大型数据集，性能可能不如专业数据库

完整示例

package main

import (
	"fmt"
	"log"

	"github.com/jameycribbs/hare"
)

type Book struct {
	ID     int    `json:"id"`
	Title  string `json:"title"`
	Author string `json:"author"`
	Year   int    `json:"year"`
}

func main() {
	// 初始化数据库
	db, err := hare.New("library", "books", &Book{})
	if err != nil {
		log.Fatal(err)
	}
	defer db.Close()

	// 插入几本书
	books := []Book{
		{ID: 1, Title: "The Go Programming Language", Author: "Alan A. A. Donovan", Year: 2015},
		{ID: 2, Title: "Clean Code", Author: "Robert C. Martin", Year: 2008},
		{ID: 3, Title: "Design Patterns", Author: "Erich Gamma", Year: 1994},
	}

	for _, book := range books {
		err = db.Insert(book)
		if err != nil {
			log.Fatal(err)
		}
	}

	// 查询所有书籍
	var allBooks []Book
	err = db.FindAll(&allBooks)
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println("All Books:")
	for _, b := range allBooks {
		fmt.Printf("- %s by %s (%d)\n", b.Title, b.Author, b.Year)
	}

	// 更新一本书
	updatedBook := Book{
		ID:     1,
		Title:  "The Go Programming Language (2nd Edition)",
		Author: "Alan A. A. Donovan and Brian W. Kernighan",
		Year:   2021,
	}

	err = db.Update(updatedBook)
	if err != nil {
		log.Fatal(err)
	}

	// 删除一本书
	err = db.Delete(3)
	if err != nil {
		log.Fatal(err)
	}

	// 再次查询所有书籍
	err = db.FindAll(&allBooks)
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println("\nUpdated Book List:")
	for _, b := range allBooks {
		fmt.Printf("- %s by %s (%d)\n", b.Title, b.Author, b.Year)
	}
}

Hare是一个非常适合小型项目、配置存储或原型开发的轻量级解决方案。对于需要更复杂功能或更高性能的场景，建议考虑SQLite或其他专业数据库。