• Redis设置Key/value的规则定义和注意事项(附工具类)


    对于redis的存储key/value键值对,经过多次踩坑之后,我们总结了一套规则;这篇文章主要讲解定义key/value键值对时的定义规则和注意事项。


    前面一篇文章讲了如何定义Redis的客户端和Dubbo集成存储器;当我们真正开始开发的时候,就会突然发现,有点不知道如何去定义Redis的Key和Value值格式,不要着急,马上我们就可以明白如何去定义和使用,下面我们开始讲解如何定义。

    Spring+Dubbo集成Redis的两种解决方案

    1、redis value 值格式

    在Java常规开发中,我们需要有面向对象的思想,相对于对象来说,比较常用且能快速转换的格式就是 JSON 了;比较常用的Java处理JSON数据有三个比较流行的类库FastJSONGsonJackson,他们的优劣点这里我就不一一介绍了,本文用阿里的FastJSON

    上面提到了JSON,这是因为在Redis的存储中,我们使用它来存储value值,为什么要这样做呢?主要是因为json格式有如下几种好处:

    · 1.标准,主流数据交换格式
    · 2.简单,结构清晰,相对于XML来说更加的轻量级,易于解析
    · 3.语言无关,任何语言都能轻松搞它
    · 4.类型安全,值是有类型的,比如整数、字符串、布尔等
    

    下面我们来看看如何使用json来存储value,代码如下:

    
    /**
     * 在redis数据库中插入 key和value 并且设置过期时间
     *
     * @param key k
     * @param value v
     * @param exp   过期时间 s
     * @return boolean
     */
    @Override
    public boolean set(String key, V value, int exp) {
        Jedis jedis = null;
        // 将 value 转换成 json 对象
        // String jKey = JSON.toJSONString(key);
        String jValue = JSON.toJSONString(value);
        // 操作是否成功
        boolean isSucess = true;
        if (StringUtils.isEmpty(key)) {
            LOG.info("key is empty");
            return false;
        }
        try {
            // 获取客户端对象
            jedis = redisCache.getResource();
            // 执行插入
            jedis.setex(key, exp, jValue);
        } catch (Exception e) {
            LOG.info("client can't connect server");
            isSucess = false;
            if (null != jedis) {
                // 释放jedis对象
                redisCache.brokenResource(jedis);
            }
            return false;
        } finally {
            if (isSucess) {
                // 返还连接池
                redisCache.returnResource(jedis);
            }
        }
        return true;
    }
    

    代码中redis value在存储前我们对其做了一次转换,将对象V转换为json对象后存储;下面我们来看看在redis中value值的格式:

    zhangsan

    上面我们可以看到在redis可视化工具rdm(Redis Desktop Manager)中,key键对应的value用json非常清晰的显示出来了,非常方便我们查阅redis中存储的数据。

    不知道大家注意到没有,上面的代码中有一行我是注释掉了,代码如下:

    // String jKey = JSON.toJSONString(key);
    

    这一行的意思是将key键也json化,不是说json非常友好吗?那为什么要注释这一行呢?下面为大家解释为何要这样做。

    首先,使用json格式的数据都会变成一个josn格式的String字符串,比如 "zhangsan" ,当这个字符串作为key存储时,默认会带有json的特性,那就是双引号 "" 也会带入到redis的key设置中,所以在rdm中我们看到的key值都会默认带上 "" ,这样着实不是非常的美观,特别是对于我们的复杂业务而言,后面会给大家讲如何在rdm中使用key值规则定义业务线文件夹。

    json zhangsan

    2、redis key 键格式

    上面讲了简单的key存储,如 zhangsan 的存储,此时普通的需求可以满足;然而在实际业务中,往往key键的存储会非常的复杂,比如我们现在有一个需求:

    需求:根据基础数据系统中的数据字典类型查询对应的字典集合
    

    这时,我们需要关注的业务就变得复杂了,就不能使用常规的key键存储方式,上面的需求大致可以拆分为:

    1.系统:基础数据系统
    2.模块:数据字典
    3.方法:根据数据字典类型查询
    4.参数:字典类型
    

    为什么要这样拆分呢?为了可读性;也为了抽象出key存储规则;因为业务复杂情况下,我们定义的key键太多时就不便于管理,也不便于查找,以 系统-模块-方法-参数 这样的规则定义,我们可以很清晰的了解redis key存储的值是做了什么事情,而且rdm中也可以以此来分组,后面会讲到。

    下面贴上根据此规则定义抽象出的redis工具类:

    package com.yclimb.mdm.redis;
    
    /**
     * Redis 工具类
     *
     * @author yclimb
     * @date 2018/4/19
     */
    public class RedisUtils {
    
        /**
         * 主数据系统标识
         */
        public static final String KEY_PREFIX = "mdm";
        /**
         * 分割字符,默认[:],使用:可用于rdm分组查看
         */
        private static final String KEY_SPLIT_CHAR = ":";
    
        /**
         * redis的key键规则定义
         * @param module 模块名称
         * @param func 方法名称
         * @param args 参数..
         * @return key
         */
        public static String keyBuilder(String module, String func, String... args) {
            return keyBuilder(null, module, func, args);
        }
    
        /**
         * redis的key键规则定义
         * @param module 模块名称
         * @param func 方法名称
         * @param objStr 对象.toString()
         * @return key
         */
        public static String keyBuilder(String module, String func, String objStr) {
            return keyBuilder(null, module, func, new String[]{objStr});
        }
    
        /**
         * redis的key键规则定义
         * @param prefix 项目前缀
         * @param module 模块名称
         * @param func 方法名称
         * @param objStr 对象.toString()
         * @return key
         */
        public static String keyBuilder(String prefix, String module, String func, String objStr) {
            return keyBuilder(prefix, module, func, new String[]{objStr});
        }
    
        /**
         * redis的key键规则定义
         * @param prefix 项目前缀
         * @param module 模块名称
         * @param func 方法名称
         * @param args 参数..
         * @return key
         */
        public static String keyBuilder(String prefix, String module, String func, String... args) {
            // 项目前缀
            if (prefix == null) {
                prefix = KEY_PREFIX;
            }
            StringBuilder key = new StringBuilder(prefix);
            // KEY_SPLIT_CHAR 为分割字符
            key.append(KEY_SPLIT_CHAR).append(module).append(KEY_SPLIT_CHAR).append(func);
            for (String arg : args) {
                key.append(KEY_SPLIT_CHAR).append(arg);
            }
            return key.toString();
        }
    
        /**
         * redis的key键规则定义
         * @param redisEnum 枚举对象
         * @param objStr 对象.toString()
         * @return key
         */
        public static String keyBuilder(RedisEnum redisEnum, String objStr) {
            return keyBuilder(redisEnum.getKeyPrefix(), redisEnum.getModule(), redisEnum.getFunc(), objStr);
        }
    
    }
    
    

    上面代码中有此文字描述 分割字符,默认[:],使用:可用于rdm分组查看 ;redis key默认使用冒号分割,好处在于可以在rdm中以文件夹的形式分组查看,如图:

    冒号分组

    3、使用枚举类来定义规则

    上面的工具类中的有如下代码,使用了枚举的形式来赋值:

    /**
     * redis的key键规则定义
     * @param redisEnum 枚举对象
     * @param objStr 对象.toString()
     * @return key
     */
    public static String keyBuilder(RedisEnum redisEnum, String objStr) {
        return keyBuilder(redisEnum.getKeyPrefix(), redisEnum.getModule(), redisEnum.getFunc(), objStr);
    }
    

    下面是枚举类代码:

    package com.yclimb.mdm.redis;
    
    /**
     * Redis 枚举类
     *
     * @author yclimb
     * @date 2018/4/19
     */
    public enum RedisEnum {
    
        /**
         * 数据字典Service - 根据字典类型查询字典数据
         */
        MDM_MSTDATADICTIONARYSERVICE_QUERYLISTBYENTITYREDIS(
                RedisUtils.KEY_PREFIX, "MstDataDictionaryService", "queryListByEntityRedis", "数据字典Redis缓存");
    
        /**
         * 系统标识
         */
        private String keyPrefix;
        /**
         * 模块名称
         */
        private String module;
        /**
         * 方法名称
         */
        private String func;
        /**
         * 描述
         */
        private String remark;
    
        RedisEnum(String keyPrefix, String module, String func, String remark) {
            this.keyPrefix = keyPrefix;
            this.module = module;
            this.func = func;
            this.remark = remark;
        }
    
        getter and setter....
    }
    
    

    使用上面的枚举类,可以根据模块和方法定义需要的枚举类型,便于管理和维护,使用起来也非常方便,使用代码如下:

    
    @Override
    public List<MstDataDictionary> queryListByEntityRedis(MstDataDictionary mstDataDictionary) {
    	// redis key 获取
    	String redisKey = RedisUtils.keyBuilder(RedisEnum.MDM_MSTDATADICTIONARYSERVICE_QUERYLISTBYENTITYREDIS, (null == mstDataDictionary ? "" : mstDataDictionary.toString()));
    	// 查询redis缓存
    	List<MstDataDictionary> mstDataDictionaryList = (List<MstDataDictionary>) redisCacheService.get(redisKey);
    	// 如果没有缓存则查询数据库后赋值
    	if (mstDataDictionaryList == null || mstDataDictionaryList.size() <= 0) {
    		mstDataDictionaryList = mstDataDictionaryMapper.queryListByEntity(mstDataDictionary);
    		redisCacheService.set(redisKey, mstDataDictionaryList);
    	}
    	return mstDataDictionaryList;
    }
    

    OK,到这里就差不多讲完了,根据上面所说的分模块方式,自定义redis的key键名称,value值格式使用json来存储;

    对于key键的规则定义也可以使用 Constants 常量类来实现,具体规则看个人爱好和需求。

    结语

    具体的定义规则工具类代码都在上面了,也是源码。

    到此本文就结束了,关注公众号查看更多推送!!!


    关注我的公众号


  • 相关阅读:
    数字类型内置方法
    流程控制之while循环
    流程控制之if判断
    基本运算符
    格式化输出的三种方式
    Python与用户交互
    解压缩
    布尔值(bool)
    django基础 -- 8.cookie 和 session
    为博客园文章添加目录的方法
  • 原文地址:https://www.cnblogs.com/yclimb/p/9933995.html
Copyright © 2020-2023  润新知