命令 - Redis 哈希(Hash) - 《Redis》

实例
Redis hash 命令
C# HashEntry与Object转换

Redis hash 是一个 string 类型的 field 和 value 的映射表，hash 特别适合用于存储对象。
Redis 中每个 hash 可以存储 2 - 1 键值对（40多亿）。

实例

127.0.0.1:6379> HMSET runoobkey name “redis tutorial” description “redis basic commands for caching” likes 20 visitors 23000
OK
127.0.0.1:6379> HGETALL runoobkey
1) “name”
2) “redis tutorial”
3) “description”
4) “redis basic commands for caching”
5) “likes”
6) “20”
7) “visitors”
8) “23000”
在以上实例中，我们设置了 redis 的一些描述信息(name, description, likes, visitors) 到哈希表的 runoobkey 中。

Redis hash 命令

下表列出了 redis hash 基本的相关命令：

序号	命令及描述
1	HDEL key field1 [field2] 删除一个或多个哈希表字段
2	HEXISTS key field 查看哈希表 key 中，指定的字段是否存在。
3	HGET key field 获取存储在哈希表中指定字段的值。
4	HGETALL key 获取在哈希表中指定 key 的所有字段和值
5	HINCRBY key field increment 为哈希表 key 中的指定字段的整数值加上增量 increment 。
6	HINCRBYFLOAT key field increment 为哈希表 key 中的指定字段的浮点数值加上增量 increment 。
7	HKEYS key 获取所有哈希表中的字段
8	HLEN key 获取哈希表中字段的数量
9	HMGET key field1 [field2] 获取所有给定字段的值
10	HMSET key field1 value1 [field2 value2 ] 同时将多个 field-value (域-值)对设置到哈希表 key 中。
11	HSET key field value 将哈希表 key 中的字段 field 的值设为 value 。
12	HSETNX key field value 只有在字段 field 不存在时，设置哈希表字段的值。
13	HVALS key 获取哈希表中所有值。
14	HSCAN key cursor [MATCH pattern] [COUNT count] 迭代哈希表中的键值对。

C# HashEntry与Object转换

/// <summary>
/// Converts to hash entry list.
/// </summary>
/// <typeparam name="T"></typeparam>
/// <param name="instance">The instance.</param>
/// <returns></returns>
private IEnumerable<HashEntry> ConvertToHashEntryList<T>(T instance) where T : new()
{
    Type objType = typeof(T);
    foreach (var prop in instance.GetType().GetProperties())
    {
        var type = prop.PropertyType;
        var underlyingType = Nullable.GetUnderlyingType(type);
        var effectiveType = underlyingType ?? type;
        var val = prop.GetValue(instance);
        if (val != null)
        {
            if (effectiveType == typeof(DateTime))
            {
                var date = (DateTime)val;
                if (date.Kind == DateTimeKind.Utc)
                {
                    yield return new HashEntry(prop.Name, $"{date.Ticks}|UTC");
                }
                else
                {
                    yield return new HashEntry(prop.Name, $"{date.Ticks}|LOC");
                }
            }
            else
            {
                yield return new HashEntry(prop.Name, val.ToString());
            }
        }
    }
}
/// <summary>
/// Converts to object.
/// </summary>
/// <typeparam name="T"></typeparam>
/// <param name="hashEntries">The hash entries.</param>
/// <param name="ignoreFail">if set to <c>true</c> [ignore fail].</param>
/// <returns>T.</returns>
private T ConvertFromHashEntryList<T>(HashEntry[] hashEntries)
{
    Type objType = typeof(T);
    T instance = (T)Activator.CreateInstance(objType);
    foreach (var prop in instance.GetType().GetProperties())
    {
        var entry = hashEntries.FirstOrDefault(e => e.Name.ToString().Equals(prop.Name));
        if (entry == null || entry.Equals(new HashEntry()) || !entry.Value.HasValue)
        {
            continue;
        }
        var type = prop.PropertyType;
        var underlyingType = Nullable.GetUnderlyingType(type);
        var effectiveType = underlyingType ?? type;
        if (effectiveType == typeof(DateTime))
        {
            var value = entry.Value.ToString();
            if (string.IsNullOrEmpty(value))
            {
                continue;
            }
            DateTime date;
            long ticks;
            if (value.EndsWith("|UTC"))
            {
                value = value.TrimEnd("|UTC".ToCharArray());
                if (long.TryParse(value, out ticks))
                {
                    date = new DateTime(ticks);
                    prop.SetValue(instance, DateTime.SpecifyKind(date, DateTimeKind.Utc));
                }
            }
            else if (value.EndsWith("|LOC"))
            {
                value = value.TrimEnd("|LOC".ToCharArray());
                if (long.TryParse(value, out ticks))
                {
                    date = new DateTime(ticks);
                    prop.SetValue(instance, DateTime.SpecifyKind(date, DateTimeKind.Local));
                }
            }
            else
            {
                string dateTimeFormat = "yyyy-MM-dd HH:mm:ss";
                value = value.Replace("\"", string.Empty);
                date = DateTime.ParseExact(value, dateTimeFormat, CultureInfo.InvariantCulture);
                prop.SetValue(instance, date);
            }
        }
        else
        {
            prop.SetValue(instance, Convert.ChangeType(entry.Value, effectiveType));
        }
    }
    return instance;
}