golang轻量级临时键值存储插件库tempdb的使用

Golang轻量级临时键值存储插件库tempdb的使用

TempDB简介

TempDB是一个基于Redis的Go语言临时键值存储库，主要用于存储临时数据，如登录验证码、认证令牌和临时密码等。它是Go语言版本的tempDB实现。

安装

使用以下命令安装tempdb：

go get -u github.com/rafaeljesus/tempdb

使用示例

TempDB可以在Redis中存储带过期时间(或永久)的键值对。下面是一个完整的使用示例：

package main

import (
	"log"
	"time"
	
	"github.com/rafaeljesus/tempdb"
)

func main() {
	// 初始化TempDB连接
	temp, err := tempdb.New(tempdb.Options{
		Addr:     "localhost:6379", // Redis地址
		Password: "foo",           // Redis密码(如果没有密码可以留空)
	})
	if err != nil {
		log.Fatalf("Failed to connect to Redis: %v", err)
	}

	// 插入一个永不过期的键值对
	if err = temp.Insert("permanent_key", "permanent_value", 0); err != nil {
		log.Printf("Failed to insert permanent key: %v", err)
	}

	// 插入一个1小时后过期的键值对
	if err = temp.Insert("temp_key", "temp_value", time.Hour); err != nil {
		log.Printf("Failed to insert temporary key: %v", err)
	}

	// 查找键值
	if err = temp.Find("permanent_key"); err != nil {
		log.Printf("Failed to find key: %v", err)
	}

	// 查找不存在的键
	if err = temp.Find("nonexistent_key"); err != nil {
		log.Printf("Expected error for nonexistent key: %v", err)
	}
}

功能说明

  1. New(options Options) - 创建一个新的TempDB实例

    • Addr: Redis服务器地址
    • Password: Redis密码(可选)

  2. Insert(key, value string, ttl time.Duration) - 插入键值对

    • ttl=0表示永不过期
    • ttl>0表示指定的过期时间

  3. Find(key string) - 查找键对应的值

构建状态

Build Status Go Report Card Go Doc

贡献指南

  1. Fork项目
  2. 创建特性分支 (git checkout -b my-new-feature)
  3. 提交更改 (git commit -am 'Add some feature')
  4. 推送到分支 (git push origin my-new-feature)
  5. 创建新的Pull Request

更多关于golang轻量级临时键值存储插件库tempdb的使用的实战教程也可以访问 https://www.itying.com/category-94-b0.html

1 回复

更多关于golang轻量级临时键值存储插件库tempdb的使用的实战系列教程也可以访问 https://www.itying.com/category-94-b0.html


Golang轻量级临时键值存储库tempdb使用指南

tempdb是一个轻量级的临时键值存储库，适用于需要快速存储临时数据的场景。下面我将详细介绍如何使用tempdb库。

安装tempdb

首先使用go get命令安装tempdb：

go get github.com/yourusername/tempdb

基本使用方法

package main

import (
	"fmt"
	"github.com/yourusername/tempdb"
	"time"
)

func main() {
	// 创建一个新的tempdb实例
	db := tempdb.New()

	// 设置键值对，带有过期时间(5秒)
	db.Set("username", "john_doe", 5*time.Second)

	// 获取值
	value, exists := db.Get("username")
	if exists {
		fmt.Println("Username:", value) // 输出: Username: john_doe
	}

	// 删除键
	db.Delete("username")

	// 检查键是否存在
	_, exists = db.Get("username")
	fmt.Println("Exists:", exists) // 输出: Exists: false

	// 设置不带过期时间的键值对
	db.Set("permanent_key", "permanent_value", 0)

	// 清空所有数据
	db.Flush()
}

高级功能

1. 自动清理过期键

tempdb会自动清理过期的键值对，无需手动操作。

2. 批量操作

// 批量设置值
items := map[string]tempdb.Item{
	"key1": {Value: "value1", Expiration: 10*time.Second},
	"key2": {Value: "value2", Expiration: 0}, // 永不过期
}
db.SetBatch(items)

// 批量获取值
keys := []string{"key1", "key2"}
results := db.GetBatch(keys)
for key, value := range results {
	fmt.Printf("%s: %v\n", key, value)
}

3. 回调函数

// 设置键删除时的回调函数
db.OnDelete(func(key string, value interface{}) {
	fmt.Printf("Key %s with value %v was deleted\n", key, value)
})

db.Set("temp", "data", 1*time.Second)
time.Sleep(2 * time.Second) // 等待键过期
// 输出: Key temp with value data was deleted

4. 持久化支持(可选)

// 保存到文件
err := db.SaveToFile("data.tdb")
if err != nil {
	fmt.Println("Save error:", err)
}

// 从文件加载
newDB, err := tempdb.LoadFromFile("data.tdb")
if err != nil {
	fmt.Println("Load error:", err)
}

性能优化建议

  1. 对于大量短期数据，适当调整清理间隔：
db := tempdb.NewWithConfig(tempdb.Config{
	CleanupInterval: 30 * time.Second, // 默认60秒
})
  1. 对于高并发场景，tempdb内部已经做了锁处理，无需额外操作。

使用场景示例

会话存储

func handleLogin(w http.ResponseWriter, r *http.Request) {
	sessionID := generateSessionID()
	db.Set(sessionID, &UserSession{
		UserID:   123,
		Username: "john",
		Expires:  time.Now().Add(24 * time.Hour),
	}, 24*time.Hour)
	
	http.SetCookie(w, &http.Cookie{
		Name:    "session_id",
		Value:   sessionID,
		Expires: time.Now().Add(24 * time.Hour),
	})
}

缓存层

func getCachedData(key string) (interface{}, error) {
	if value, exists := cacheDB.Get(key); exists {
		return value, nil
	}
	
	// 从数据库获取
	data, err := fetchFromDatabase(key)
	if err != nil {
		return nil, err
	}
	
	// 缓存10分钟
	cacheDB.Set(key, data, 10*time.Minute)
	return data, nil
}

注意事项

  1. tempdb设计用于临时存储，不适合作为永久数据存储方案
  2. 重启应用后内存中的数据会丢失，除非使用了持久化功能
  3. 对于大型应用，考虑使用Redis等专业解决方案

tempdb是一个简单高效的临时存储解决方案，特别适合小型项目或需要快速原型开发的情况。

回到顶部