雪花算法
ID 解析
从 SnowflakeID 解析时间戳、基因、节点等信息
ID 解析
SnowflakeID 提供丰富的解析方法，可以从 ID 中提取时间戳、基因、数据中心、节点等信息。
字符串解析
ParseSnowflakeID
从字符串解析 ID：
func ParseSnowflakeID(s string) (SnowflakeID, error)示例：
id, err := xSnowflake.ParseSnowflakeID("1234567890123456789")
if err != nil {
log.Error("解析失败:", err)
return
}
fmt.Println(id.Gene()) // UserMustParseSnowflakeID
解析 ID，失败则 panic：
func MustParseSnowflakeID(s string) SnowflakeID示例：
id := xSnowflake.MustParseSnowflakeID("1234567890123456789")信息提取
Timestamp
提取创建时间：
func (s SnowflakeID) Timestamp() time.Time实现：
func (s SnowflakeID) Timestamp() time.Time {
ms := (int64(s) >> timestampShift) + epoch
return time.UnixMilli(ms)
}示例：
id := xSnowflake.GenerateID()
createTime := id.Timestamp()
fmt.Println(createTime) // 2024-01-15 10:30:00.123 +0800 CSTGene
提取业务基因：
func (s SnowflakeID) Gene() Gene实现：
func (s SnowflakeID) Gene() Gene {
return Gene((int64(s) >> geneShift) & maxGene)
}示例：
id := xSnowflake.GenerateID(xSnowflake.GeneOrder)
gene := id.Gene()
fmt.Println(gene) // 16
fmt.Println(gene.String()) // "Order"
if gene == xSnowflake.GeneOrder {
fmt.Println("这是订单 ID")
}DatacenterID
提取数据中心 ID：
func (s SnowflakeID) DatacenterID() int64实现：
func (s SnowflakeID) DatacenterID() int64 {
return (int64(s) >> datacenterShift) & maxDatacenterID
}NodeID
提取节点 ID：
func (s SnowflakeID) NodeID() int64实现：
func (s SnowflakeID) NodeID() int64 {
return (int64(s) >> nodeShift) & maxNodeID
}Sequence
提取序列号：
func (s SnowflakeID) Sequence() int64实现：
func (s SnowflakeID) Sequence() int64 {
return int64(s) & maxSequence
}完整解析示例
id := xSnowflake.GenerateID(xSnowflake.GeneUser)
fmt.Println("ID:", id.String())
fmt.Println("创建时间:", id.Timestamp())
fmt.Println("基因:", id.Gene().String())
fmt.Println("数据中心:", id.DatacenterID())
fmt.Println("节点:", id.NodeID())
fmt.Println("序列号:", id.Sequence())
// 输出：
// ID: 1234567890123456789
// 创建时间: 2024-01-15 10:30:00.123 +0800 CST
// 基因: User
// 数据中心: 1
// 节点: 2
// 序列号: 0类型转换
Int64
返回 int64 值：
func (s SnowflakeID) Int64() int64示例：
id := xSnowflake.GenerateID()
num := id.Int64()
fmt.Println(num) // 1234567890123456789String
返回字符串表示：
func (s SnowflakeID) String() string示例：
id := xSnowflake.GenerateID()
str := id.String()
fmt.Println(str) // "1234567890123456789"IsZero
判断是否为零值：
func (s SnowflakeID) IsZero() bool示例：
var id xSnowflake.SnowflakeID
if id.IsZero() {
fmt.Println("ID 未初始化")
}序列化支持
JSON
序列化为字符串，避免 JavaScript 精度丢失：
func (s SnowflakeID) MarshalJSON() ([]byte, error)
func (s *SnowflakeID) UnmarshalJSON(data []byte) error示例：
type User struct {
ID xSnowflake.SnowflakeID `json:"id"`
Name string `json:"name"`
}
user := User{
ID: xSnowflake.GenerateID(xSnowflake.GeneUser),
Name: "张三",
}
// JSON 序列化
data, _ := json.Marshal(user)
// {"id":"1234567890123456789","name":"张三"}
// JSON 反序列化（支持字符串和数字格式）
json.Unmarshal([]byte(`{"id":"1234567890123456789"}`), &user)
json.Unmarshal([]byte(`{"id":1234567890123456789}`), &user)GORM
支持数据库读写：
func (s SnowflakeID) Value() (driver.Value, error)
func (s *SnowflakeID) Scan(value interface{}) error示例：
type User struct {
ID xSnowflake.SnowflakeID `gorm:"type:bigint;primaryKey"`
Username string `gorm:"type:varchar(64)"`
}
// 写入数据库
db.Create(&User{
ID: xSnowflake.GenerateID(xSnowflake.GeneUser),
Username: "zhangsan",
})
// 从数据库读取
var user User
db.First(&user, "id = ?", "1234567890123456789")Redis
支持二进制存储：
func (s SnowflakeID) MarshalBinary() ([]byte, error)
func (s *SnowflakeID) UnmarshalBinary(data []byte) error示例：
id := xSnowflake.GenerateID()
// 存储到 Redis
rdb.Set(ctx, "user:id", id, time.Hour)
// 从 Redis 读取
var readID xSnowflake.SnowflakeID
rdb.Get(ctx, "user:id").Scan(&readID)实际应用
根据 ID 判断数据类型
func HandleData(id xSnowflake.SnowflakeID) {
switch id.Gene() {
case xSnowflake.GeneUser:
handleUser(id)
case xSnowflake.GeneOrder:
handleOrder(id)
case xSnowflake.GenePayment:
handlePayment(id)
default:
handleDefault(id)
}
}根据 ID 判断创建时间
func IsExpired(id xSnowflake.SnowflakeID, duration time.Duration) bool {
createTime := id.Timestamp()
return time.Since(createTime) > duration
}
// 使用
if IsExpired(tokenID, 24*time.Hour) {
fmt.Println("Token 已过期")
}根据 ID 定位节点
func GetNodeInfo(id xSnowflake.SnowflakeID) string {
return fmt.Sprintf("数据中心 %d，节点 %d",
id.DatacenterID(), id.NodeID())
}