go_dreamfactory/lego/sys/redis/cluster/hash.go
2022-06-13 13:58:17 +08:00

129 lines
4.2 KiB
Go

package cluster
import (
"github.com/go-redis/redis/v8"
)
/*
Redis Hdel 命令用于删除哈希表 key 中的一个或多个指定字段,不存在的字段将被忽略
*/
func (this *Redis) HDel(key string, fields ...string) (err error) {
err = this.client.HDel(this.getContext(), key, fields...).Err()
return
}
/*
Redis Hexists 命令用于查看哈希表的指定字段是否存在
*/
func (this *Redis) HExists(key string, field string) (result bool, err error) {
this.client.HExists(this.getContext(), key, field)
return
}
/*
Redis Hget 命令用于返回哈希表中指定字段的值
*/
func (this *Redis) HGet(key string, field string, v interface{}) (err error) {
err = this.client.HGet(this.getContext(), key, field).Scan(v)
return
}
/*
Redis Hgetall 命令用于返回哈希表中,所有的字段和值。
在返回值里,紧跟每个字段名(field name)之后是字段的值(value),所以返回值的长度是哈希表大小的两倍
*/
func (this *Redis) HGetAll(key string, v interface{}) (err error) {
err = this.client.HGetAll(this.getContext(), key).Scan(v)
return
}
/*
Redis Hincrby 命令用于为哈希表中的字段值加上指定增量值。
增量也可以为负数,相当于对指定字段进行减法操作。
如果哈希表的 key 不存在,一个新的哈希表被创建并执行 HINCRBY 命令。
如果指定的字段不存在,那么在执行命令前,字段的值被初始化为 0 。
对一个储存字符串值的字段执行 HINCRBY 命令将造成一个错误。
本操作的值被限制在 64 位(bit)有符号数字表示之内
*/
func (this *Redis) HIncrBy(key string, field string, value int64) (err error) {
err = this.client.HIncrBy(this.getContext(), key, field, value).Err()
return
}
/*
Redis Hincrbyfloat 命令用于为哈希表中的字段值加上指定浮点数增量值。
如果指定的字段不存在,那么在执行命令前,字段的值被初始化为 0
*/
func (this *Redis) HIncrByFloat(key string, field string, value float64) (err error) {
err = this.client.HIncrByFloat(this.getContext(), key, field, value).Err()
return
}
/*
Redis Hkeys 命令用于获取哈希表中的所有域(field)
*/
func (this *Redis) Hkeys(key string) (result []string, err error) {
var cmd *redis.StringSliceCmd
cmd = this.client.HKeys(this.getContext(), key)
result = cmd.Val()
err = cmd.Err()
return
}
/*
Redis Hlen 命令用于获取哈希表中字段的数量
*/
func (this *Redis) Hlen(key string) (result int64, err error) {
var cmd *redis.IntCmd
cmd = this.client.HLen(this.getContext(), key)
result = cmd.Val()
err = cmd.Err()
return
}
/*
Redis Hmget 命令用于返回哈希表中,一个或多个给定字段的值。
如果指定的字段不存在于哈希表,那么返回一个 nil 值
*/
func (this *Redis) HMGet(key string, fields ...string) *redis.SliceCmd {
return this.client.HMGet(this.getContext(), key, fields...)
}
/*
Redis Hmset 命令用于同时将多个 field-value (字段-值)对设置到哈希表中。
此命令会覆盖哈希表中已存在的字段。
如果哈希表不存在,会创建一个空哈希表,并执行 HMSET 操作
*/
func (this *Redis) HMSet(key string, value map[string]interface{}) (err error) {
agrs := make([]interface{}, 0)
agrs = append(agrs, "HMSET")
agrs = append(agrs, key)
for k, v := range value {
result, _ := this.Encode(v)
agrs = append(agrs, k, result)
}
err = this.client.Do(this.getContext(), agrs...).Err()
return
}
/*
Redis Hset 命令用于为哈希表中的字段赋值
如果哈希表不存在,一个新的哈希表被创建并进行 HSET 操作
如果字段已经存在于哈希表中,旧值将被覆盖
*/
func (this *Redis) HSet(key string, field string, value interface{}) (err error) {
err = this.client.HSet(this.getContext(), key, field, value).Err()
return
}
/*
Redis Hsetnx 命令用于为哈希表中不存在的的字段赋值
如果哈希表不存在,一个新的哈希表被创建并进行 HSET 操作
如果字段已经存在于哈希表中,操作无效
如果 key 不存在,一个新哈希表被创建并执行 HSETNX 命令
*/
func (this *Redis) HSetNX(key string, field string, value interface{}) (err error) {
err = this.client.HSetNX(this.getContext(), key, field, value).Err()
return
}