guid
提供了更简便更高性能的全局唯一数生成功能。生成的uid
字符串仅包含数字及小写英文字符。
- 优点:性能高效、使用简便。
- 缺点:字符范围有限、长度固定
32
字节。
guid
模块的设计目的在于提供一种使用更简便、性能更高效且能满足绝大多数业务场景的唯一数生成。guid
的设计比较简单,详情可参考实现源码。
字符列表:
字符类型 字符列表
数字字符 0123456789
英文字符 abcdefghijklmnopqrstuvwxyz
使用方式:
import "github.com/gogf/gf/v2/util/guid"
接口文档:
https://pkg.go.dev/github.com/gogf/gf/v2/util/guid
基本介绍
guid
通过S
方法生成32
字节的唯一数,该方法定义如下:
func S(data ...[]byte) string
通过不带任何参数的方式使用,该方法生成的唯一数将会有以下方式构成:
MACHash(7) + PID(4) + TimestampNano(12) + Sequence(3) + RandomString(6)
其中:
MAC
表示当前机器的MAC
地址哈希值,由7
个字节构成;PID
表示当前机器的进程ID,由4
个字节构成;TimestampNano
表示当前的纳秒时间戳,由12
个字节构成;Sequence
表示当前进程并发安全的序列号,由3
个字节构成;RandomString
表示随机数,由6
个字节构成;
通过自定义任何参数的方式使用,该方法生成的唯一数将会有以下方式构成:
DataHash(7/14) + TimestampNano(12) + Sequence(3) + RandomString(3/10)
主要说明:
Data
表示自定义的参数,参数类型为[]byte
,最多支持2
个参数输入,由7
或14
个字节构成;- 需要注意的是,输入的自定义参数需要在业务上具有一定的唯一识别性,使得生成的唯一数更有价值;
- 不管每一个
[]byte
参数长度为多少,最终都将通过哈希方式生成7
个字节的哈希值。 TimestampNano
表示当前的纳秒时间戳,由12
个字节构成;Sequence
表示当前进程并发安全的序列号,由3
个字节构成;RandomString
表示随机数,由3
或者10
个字节构成,即:- 如果给定
1
个自定义参数,那么剩余的字节将会使用随机数占位,长度为10
个字节; - 如果给定
2
个自定义参数,那么剩余的字节将会使用随机数占位,长度为3
个字节;
- 如果给定
基准测试
goos: darwin
goarch: amd64
pkg: github.com/gogf/gf/v2/util/guid
cpu: Intel(R) Core(TM) i7-9750H CPU @ 2.60GHz
Benchmark_S
Benchmark_S-12 2665587 423.8 ns/op
Benchmark_S_Data_1
Benchmark_S_Data_1-12 2027568 568.2 ns/op
Benchmark_S_Data_2
Benchmark_S_Data_2-12 4352824 275.5 ns/op
PASS
示例1,基本使用
package main
import (
"fmt"
"github.com/gogf/gf/v2/util/guid"
)
func main() {
fmt.Printf("TraceId: %s", guid.S())
}
执行后,输出结果为:
TraceId: oa9sdw03dk0c35q9bdwcnz42p00trwfr
示例2,自定义参数
我们的SessionId
生成需要具有比较好的唯一性,且需要防止轻易的碰撞,因此可以使用以下方式:
func CreateSessionId(r *ghttp.Request) string {
var (
address = request.RemoteAddr
header = fmt.Sprintf("%v", request.Header)
)
return guid.S([]byte(address), []byte(header))
}
可以看到,SessionId
需要依靠自定义的两个输入参数RemoteAddr
, Header
来生成,这两个参数在业务上具有一定的唯一识别性,且通过guid.S
方法的设计构成,生成的唯一数将会非常随机且唯一,既满足了业务需要也保证了安全。