之前说要写个 Go 语言版本的 Redis 操作 API 和性能测试的系列,没想到鸽了这么久才写了一半。实在实力不济,不仅需要多充充电,更需要结合实践,劳逸结合。首先来一个前文回顾:
- Go语言Redis API基本功能实践
2022-06-23
- Redis API——List功能实践与性能测试【Go版】
2022-08-15
按照惯例,我们先介绍常用的 API及其封装,然后写个简单的测试用例,然后再进行性能测试。PS:由于不可描述的原因,本机的磁盘 IO 性能变差,测出的性能参考性较差。
常用 API
由于 set 本身是无序的,所以 set 操作的 API 也是比较简单的。
SAdd
这个 API 功能是向 set 中添加元素,返回的也是新增的,也就是说如果新增的元素有重复的,那么返回值是不会计算这个重复的key。
代码语言:javascript复制// SAdd
// @Description: 添加集合元素
// @receiver r
// @param key
// @param members
// @return int64
//
func (r RedisBase) SAdd(key string, members ...interface{}) int64 {
result, err := r.pool.SAdd(key, members...).Result()
if err != nil {
log.Printf("sadd key:%s,members:%s failn", key, ftool.ToString(members))
log.Println(err)
return base.TestError
}
return result
}
SCard
SCard 功能是获取 set 中元素个数,返回值是 set 中元素个数。
代码语言:javascript复制// SCard
// @Description: 获取集合元素个数
// @receiver r
// @param key
// @return int64
//
func (r RedisBase) SCard(key string) int64 {
result, err := r.pool.SCard(key).Result()
if err != nil {
log.Printf("scard key:%s failn", key)
log.Println(err)
return base.TestError
}
return result
}
SIsMember
SIsMember API 功能是判断元素是否存在在当前的 set 中。
代码语言:javascript复制// SIsMember
// @Description: 判断元素是否在集合中
// @receiver r
// @param key
// @param member
// @return bool
//
func (r RedisBase) SIsMember(key string, member interface{}) bool {
result, err := r.pool.SIsMember(key, member).Result()
if err != nil {
log.Printf("sismember key:%s,member:%s failn", key, ftool.ToString(member))
log.Println(err)
return false
}
return result
}
SMembers
SMembers API 功能是获取 set 中所有元素。
代码语言:javascript复制// SMembers
// @Description: 获取集合中所有的元素
// @receiver r
// @param key
// @return []string
//
func (r RedisBase) SMembers(key string) []string {
result, err := r.pool.SMembers(key).Result()
if err != nil {
log.Printf("smember key:%s failn", key)
log.Println(err)
return nil
}
return result
}
SRem
SRem API 功能是删除集合中的元素,同样的返回值也提示删除成功的个数,如果这个元素并不在 set 中,那么返回值不包含这个计数。
代码语言:javascript复制// SRem
// @Description: 删除集合元素
// @receiver r
// @param key
// @param members
//
func (r RedisBase) SRem(key string, members ...interface{}) int64 {
result, err := r.pool.SRem(key, members...).Result()
if err != nil {
log.Printf("srem key:%s members:%s failn", key, ftool.ToString(members))
log.Println(err)
return base.TestError
}
return result
}
SPop & SPopN
SPop API 是随机获取 set 中的一个元素,并且会删除改元素。SPopN API 是随机获取 N 个元素,并且删除该元素,如果 N 的值大于当前元素个数,那么有多少返回多少。
代码语言:javascript复制// SPop
// @Description: 随机返回集合中的元素,并且删除返回的元素
// @receiver r
// @param key
// @return string
//
func (r RedisBase) SPop(key string) string {
result, err := r.pool.SPop(key).Result()
if err != nil {
log.Printf("spop key:%s failn", key)
log.Println(err)
return base.Empty
}
return result
}
API 演示用例
这篇文章把用例写到一起了,毕竟都是简单的 API,单独写有点占篇幅。
代码语言:javascript复制
func TestSet(t *testing.T) {
var pool = redis.NewRdisPool("127.0.0.1:6379", base.Empty, 1)
var key = "funset"
add := pool.SAdd(key, ftool.RandomStr(10), ftool.RandomStr(3), "FunTester")
log.Println(add)
log.Printf("FunTester 是否存在 %t", pool.SIsMember(key, "FunTester"))
log.Println(pool.SCard(key))
members := pool.SMembers(key)
for _, s := range members {
log.Println(s)
if ftool.RandomInt(2) == 1 && s != "FunTester" {
pool.SRem(key, s)
}
}
log.Println(pool.SRem(key, "FunTester", "000000000"))
log.Println(pool.SPop(key))
log.Println(len(pool.SPopN(key, 1000)))
}
性能测试
用例思路:添加一些随机的字符串到 set 中,然后根据成功次数随机从 set 中删除。
代码语言:javascript复制func TestSetPer(t *testing.T) {
var pool = redis.NewRdisPool("127.0.0.1:6379", base.Empty, 1)
var key = "funsetper"
execute.ExecuteRoutineTime(func() {
add := int(pool.SAdd(key, ftool.RandomStr(10), ftool.RandomStr(3)))
for i := 0; i < add; i {
pool.SPop(key)
}
}, 20, 5)
}
控制台输出:
代码语言:javascript复制=== RUN TestSetPer
2022/09/18 22:31:09 Redis 连接成功
2022/09/18 22:31:09 确认连接成功!
2022/09/18 22:31:29 总耗时: 19.999000
2022/09/18 22:31:29 请求总数: 330634
2022/09/18 22:31:29 QPS: 16532.526626
--- PASS: TestSetPer (20.00s)
PASS