Redis学习笔记之五：散列类型

    Redis的散列类型可以看做Java中的Map结构，后文简称Map，同时Redis中操纵Map的指令均已H开头。一个散列类型可以存储2的32次方-1个字段，即内部Key-Value的对数。

    可以将Map当做Java中的HashMap，这样便于快速理解。既然将其看做Map，那Redis的这个Map肯定与Java中的Map有相似之处，如下图：

    可以看到Key对应的Value是一个Map，而Map内部又有Key-Value键值对。内部的Key也是不能重复的，Value的值也是会被覆盖的。

    

    1、设值/取值(put/get)

    使用HSET与HGET获取Map的值，当然，与String类型一样，Map也能一次性获取多个或者设置多个值(HMSET/HMGET)。但设置多个值时，Key-Value一定要成对出现。否则当前指令会执行失败，原Map不会有任何改变。

    可以看到取出来的值是String类型的。同时Key的值没有重复，且Value的值会被覆盖,如果获取的Key对应Map的key不存在，则会返回nil。

    还有一点值得注意的是HSET，如果是插入新的Key-Value返回的是1，如果是修改旧的Value，返回是0.

    2、获取Map内部的Key-Value对数(Map的size())。

    使用HLEN指令可以获取指定的Map的Key-Value对数。同时，这个指令与STRLEN和LLEN指令一致，会在Key不存在时返回0.

    3、获取Map的所有Key或者所有Value

    指令HKEYS获取指定Map的所有Key，与Java中Map的KeySet一致。

    指令KVALS获取指定Map的所有Value，在Java的Map中，对应values()，但有所不同。

    示例如下：

    4、获取Map的所有Key-Value。

    可以使用指令HGETALL获取Map的所有Key-Value，与之对应的方法是Java中Map的entrySet方法。演示如下

    单行为Key，双行为Value，获取不存在的Redis的Key，返回empty list，可以从提示信息看到，这个指令是将Map遍历然后转换成List类型呈现。

    5、判断Map中的Key是否存在(containsKey)

    指令用于HEXISTS用于判断Map中对应的Key是否存在。演示如下

    我的Redis中是没有Key1这个键存在的，可以看到使用HEXISTS返回0表示Map中没有这个键，但也有可能是这个Map根本不存在。

    6、删除Map中的Key(remove)

    使用HDEL指令删除Map中的Key，格式HDEL map field。演示如下：

    这个指令是可以跟多个field的，可以从图看到，一次性删除了name和color属性。

    

    7、当不存在时设置

    指令HSETNX用于在Map的Key不存在时执行HSET操作，如果存在，则不作任何操作。这个指令可以看做HSET NOT EXISTS的缩写。

    演示如下：

    可以看到当Map的Key存在时，这条指令并没有对Value其进行覆盖。在Java中与之相对应的方法是putIfAbsent。与之对应的Java代码如下：

default V putIfAbsent(K key, V value) {    V v = get(key);    if (v == null) {        v = put(key, value);    }    return v;}

    但有区别，上述代码是分成了两步操作 1) 判断Key是否存在 2) 不存在进行put操作。而HSETNX是一个原子操作指令。

    

    8、HINCRBY指令

    看到这个指令会想起String类型的INCR、DECR等指令。的确，这个指令与INCRBY指令操作完全一致，并且都会在对应的Key不存在时执行SET操作。演示如下：

    上图中的Key1并不存在，可以看到HINCRBY指令在Map以及Map的Key都不存在的情况下，会先创建Map，然后HSET操作。这个指令只对Value为字符串类型的整数有效，如下图：

Redis的Java操作

   测试代码如下，略长。

package org.yamikaze.redis.test;import org.junit.After;import org.junit.Before;import org.junit.Test;import redis.clients.jedis.Jedis;import java.util.HashMap;import java.util.List;import java.util.Map;import java.util.Set;import static org.junit.Assert.*;/** * 使用Java代码连接测试Redis的Map类型 * @author yamikaze */public class MapTest {    private Jedis client;    private static final String KEY = "mapKey";    private String key1 = "key1";    private String value1 = "value1";    private String key2 = "key2";    private String value2 = "value2";    private Map<String, String> map;    @Before    public void setUp() {        client = MyJedisFactory.defaultJedis();        map = new HashMap<String, String>(4);        map.put(key1, value1);        map.put(key2, value2);    }    /**     * 测试普通的HSET与HGET     */    @Test    public void testMapPutAndGet() {        Long result = client.hset(KEY, key1, value1);        assertTrue(result.equals(1L));        String value = client.hget(KEY, key1);        assertEquals(value1, value);    }    /**     * 测试HMSET与HMSET     */    @Test    public void testMapMPutAndMGet() {        String result = client.hmset(KEY, map);        assertTrue("OK".equals(result));        List<String> list = client.hmget(KEY, key1, key2);        assertNotNull(list);        assertTrue(list.size() == 2);    }    /**     * 测试HLEN     */    @Test    public void testMapHLen() {        String result = client.hmset(KEY, map);        assertTrue("OK".equals(result));        Long size = client.hlen(KEY);        assertEquals(size.intValue(), map.size());    }    /**     * 测试HKEYS     */    @Test    public void testMapHKeys() {        String result = client.hmset(KEY, map);        assertTrue("OK".equals(result));        Set<String> redisKeys = client.hkeys(KEY);        Set<String> keys = map.keySet();        assertEquals(redisKeys.size(), keys.size());        /**         * 两个Set的元素都应该一致.         * 不能使用将下面的代码中Keys与RedisKeys互换位置。         * 因为HashMap返回的Set是内部KeySet,不支持add操作。         * 你可以认为HashMap返回的Set是一个可读副本         */        for(String key : keys ) {            assertFalse(redisKeys.add(key));        }    }    /**     * 测试HEXISTS     */    @Test    public void testMapHExists() {        String result = client.hmset(KEY, map);        assertTrue("OK".equals(result));        assertTrue(client.hexists(KEY, key1));        assertTrue(client.hexists(KEY, key2));        assertFalse(client.hexists(KEY, "abc"));    }    /**     * 测试HDEL     */    @Test    public void testMapHDel() {        String result = client.hmset(KEY, map);        assertTrue("OK".equals(result));        Long delResult = client.hdel(KEY, key1, key2);        assertTrue(delResult.intValue() == map.size());        assertTrue(client.hlen(KEY).intValue() == 0);    }    /**     * 测试HSETNX     */    @Test    public void testMapHSetNX() {        String result = client.hmset(KEY, map);        assertTrue("OK".equals(result));        Long result1 = client.hsetnx(KEY, key1, "123");        String value = client.hget(KEY, key1);        assertEquals(value1, value);        assertTrue(result1 == 0);        Long result2 = client.hsetnx(KEY, "abc", value2);        assertTrue(result2 == 1);        String value3 = client.hget(KEY, "abc");        assertEquals(value3, value2);    }    /**     * 测试HGETALL     */    @Test    public void testMapGetAll() {        String result = client.hmset(KEY, map);        assertTrue("OK".equals(result));        Map<String, String> redisMap = client.hgetAll(KEY);        assertNotNull(redisMap);        assertEquals(redisMap.size(), map.size());        Set<Map.Entry<String, String>> entrySet = map.entrySet();        for(Map.Entry<String, String> entry : entrySet) {            String key = entry.getKey();            String val = entry.getValue();            String redisValue = redisMap.get(key);            assertTrue(redisMap.containsKey(key));            assertEquals(val, redisValue);        }    }    /**     * 测试HINCRBY     */    @Test    public void testMapHIncrBy() {        String result = client.hmset(KEY, map);        assertTrue("OK".equals(result));        Long result1 = client.hincrBy(KEY, "abc", 2);        assertEquals(result1.intValue(), 2);    }    /**     * HVALS指令略     */    @After    public void tearDown() {        if(client != null) {            client.del(KEY);        }    }}

总结：

   Redis的Map类型可以将其当做是Java中的Map，但又有所不同，可以将对象序列化成字符串进行存储。既然转换为字符串，就与对象原本的类型无关了。所以与Java中的Map第一个区别是Java的Map的Value只能为一种类型，而Redis的Map的Value可以多种类型(字符串形式)。第二个区别是遍历Redis中Map的Key，Value或者Key-Value会被转换为List或Set进行操作，HKEYS是转为Set，HVAL是转为List，HGETALL是转为List。为什么HKEYS是Set，而HVAL是List，是因为Map的特性使然，这一点与Java的Map保持了一致，分别对应keySet(),values(),entrySet()方法。但这三个方法又与Redis的指令有所区别，这儿不在详细讲解区别。第三个区别Redis提供了一些Java中Map没有的操作，例如HINCRBY指令。同时Java Map也有一些操作Redis没有，例如clear(), getOrDefault().

参考资料

    《Redis入门指南》