SandID - 为地球上每粒沙子生成唯一ID的Golang插件库

概述

SandID是一个能够为地球上每粒沙子生成唯一ID的Golang库。它基于UUID版本1算法，并进行了优化以提高数据库插入效率。

主要特性

• 极其简单易用
• 固定长度
  • 16字节
  • 22个字符
  • 128位
• 超大容量
  • 最多可生成2^128个ID
• URL安全
  • 符合正则表达式^[A-Za-z0-9-_]{22}$
• 编码友好
  • 实现了多种编码接口
• SQL友好
  • 支持sandid.NullSandID
  • 实现了SQL相关接口
• 无第三方依赖

安装

要使用SandID，只需执行以下命令：

go get github.com/aofei/sandid

使用示例

下面是一个完整的SandID使用示例：

package main

import (
	"encoding/json"
	"fmt"
	"github.com/aofei/sandid"
)

func main() {
	// 生成一个新的SandID
	id := sandid.New()
	fmt.Println("Generated ID:", id)

	// 将ID转换为字符串
	idStr := id.String()
	fmt.Println("String representation:", idStr)

	// 从字符串解析回SandID
	parsedID, err := sandid.Parse(idStr)
	if err != nil {
		panic(err)
	}
	fmt.Println("Parsed ID:", parsedID)

	// JSON序列化和反序列化
	type Entity struct {
		ID sandid.SandID `json:"id"`
	}

	// 序列化为JSON
	entity := Entity{ID: id}
	jsonData, err := json.Marshal(entity)
	if err != nil {
		panic(err)
	}
	fmt.Println("JSON:", string(jsonData))

	// 从JSON反序列化
	var newEntity Entity
	err = json.Unmarshal(jsonData, &newEntity)
	if err != nil {
		panic(err)
	}
	fmt.Println("Unmarshaled ID:", newEntity.ID)

	// 比较两个ID
	anotherID := sandid.New()
	fmt.Println("Comparison with another ID:", id == anotherID)
}

数据库使用示例

SandID也支持在数据库中使用：

package main

import (
	"database/sql"
	"fmt"
	"github.com/aofei/sandid"
	_ "github.com/go-sql-driver/mysql"
)

func main() {
	db, err := sql.Open("mysql", "user:password@/dbname")
	if err != nil {
		panic(err)
	}
	defer db.Close()

	// 创建表
	_, err = db.Exec(`
		CREATE TABLE IF NOT EXISTS items (
			id CHAR(22) PRIMARY KEY,
			name VARCHAR(255)
	`)
	if err != nil {
		panic(err)
	}

	// 插入数据
	id := sandid.New()
	_, err = db.Exec("INSERT INTO items (id, name) VALUES (?, ?)", id, "test item")
	if err != nil {
		panic(err)
	}

	// 查询数据
	var itemID sandid.SandID
	var name string
	err = db.QueryRow("SELECT id, name FROM items WHERE id = ?", id).Scan(&itemID, &name)
	if err != nil {
		panic(err)
	}

	fmt.Printf("Retrieved item - ID: %s, Name: %s\n", itemID, name)
}

注意事项

1. SandID生成的ID是全局唯一的
2. 每个ID固定为22个字符长度
3. 适合用作数据库主键
4. 支持所有主流编码格式

SandID是一个简单但功能强大的库，适合需要生成大量唯一标识符的应用场景。