Spring-boot 中使用 AOP 和 Redis搭建缓存框架

这里提到的缓存是通用的缓存,如表格获取时优先查询redis,如果有,则读取 redis 中的数据,如果没有,读取数据库,并将返回结果存入 redis 中,然后新增/修改/删除等操作时,需要将对应的缓存数据清空,以保证每次获取都是最新的数据。当然,有其他需求的时候,也可以直接通过 redisTemplate来对 redis 进行增删改查,这个做法跟 MySQL 等关系型数据库是差不多的,关于 redis 操作的部分因为不是这篇文章的重点,所以这里就不赘述了。

这里的实现思路有两种,第一种是完全通过 spring AOP面向切面编程,给 select 做一层切面,给 save/update/delete 做一层切面,来完成上面说的功能。第二种是Spring的 cache 库(其实还是面向切面的技术),辅以 spring AOP,可以大大简化切面编程部分代码。

首先是要导入相关 jar 包,我现在项目都是 spring-boot 的,所以jar 包带有 spring-boot 前缀的,如果不是 spring-boot 的,直接找对应 spring 版本就可以了,都是比较通用的 jar 包,也不难找。

<!-- redis —>
<dependency>   
<groupId>org.springframework.boot</groupId>   
<artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
<!-- cache 缓存 —>
<dependency>   
<groupId>org.springframework.boot</groupId>   
<artifactId>spring-boot-starter-cache</artifactId>
</dependency>

首先是cache 和 redis 的配置,我这里将两个配置写在了一个类中

@Configuration
@EnableCaching
@PropertySource(value = "classpath:/application.properties")
public class CacheConfig extends CachingConfigurerSupport {


    /**
     *
     * @return
     */
    @Bean
    public CacheManager cacheManager(RedisTemplate redisTemplate) {
        RedisCacheManager manager = new RedisCacheManager(redisTemplate);
        //设置统一的过期时间
        manager.setDefaultExpiration(120l);
        //可在 map 中给不同的 key 设置对应的过期时间
//        manager.setExpires(new HashMap<String, Long>());
        return manager;
    }

    @Value("${spring.redis.host}")
    String hostName;

    @Value("${spring.redis.password}")
    String password;

    @Value("${spring.redis.port}")
    Integer port;

    @Value("${spring.redis.timeout}")
    Integer timeout;

    @Bean
    JedisConnectionFactory jedisConnectionFactory() {
        JedisConnectionFactory jedisConnectionFactory = new JedisConnectionFactory();
        jedisConnectionFactory.setHostName(hostName);
        jedisConnectionFactory.setPort(port);
        jedisConnectionFactory.setPassword(password);
        jedisConnectionFactory.setDatabase(0);
        jedisConnectionFactory.setTimeout(timeout);
        return jedisConnectionFactory;
    }
}

这个类有几个地方要注意的,首先是类的注解,@configuration 是 spring-boot 将类装配成 bean 的注解,@EnableCaching 是声明开启缓存功能的注解,@PropertySource 是引用配置文件的注解

配置类里面有两个 bean,cacheManager是给 cache 库配置缓存的实际位置,因为 spring-cache 可以搭配的缓存很多,也就有很多cacheManager 可以使用,我们这里用的是 redis,所以用的是 RedisCacheManager。

这里可以给缓存上过期时间,但是这里要注意一下这个过期时间指的是通过 cache类库添加进 Redis 缓存的过期时间,也就是@Cacheable 和@CachePut 这两个注解。如果单独使用 RedisTemplate 添加缓存,是要另外设置过期时间的。另外一个bean是 Redis 的配置方法。
然后简单介绍一下 cache 库,这个库是 Spring的缓存库,使用起来也是非常简单,通过几个使用在类或方法上面的注解即可达成目的

@Cacheable   //通过方法的查找是优先查找缓存,如果找到,方法不会执行,当找不到时会去找数据库,并将返回结果放入缓存
@CachePut     //通过方法的返回值会放入缓存中,无论缓存中是否有值,方法一定会被执行
@CacheEvict   //清除缓存中的一个或多个条目
@Cacheing      //这是一个分组的注解,能够同时应用多个其他的缓存注解

这里只是简单介绍一下这几个注解的含义,这些内容在其他文章中也都有比较详实的说明,这里也不过多的介绍了。

着重要说的是@Cacheable 注解,这个注解是可以达到查找时优先查找缓存,当缓存中没有才去访问数据库功能的,这个功能实际是通过 AOP 来完成的,所以我们也可以自己写相关代码,不过既然有现成的,那直接调用是极好的。

@Cacheable 注解有几个属性,对缓存有着较大的影响(这些属性其实这几个注解都有,但是上面几个注解有缺陷,下面会讲)。

@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@Documented
public @interface Cacheable {

    String key() default "";

    String keyGenerator() default "";

    String condition() default "";

    String unless() default "";

}

这里只截取了 Cacheable 注解中部分属性,其他属性具体功效可以看源码,介绍的也都比较详实。因为 redis 是键值对数据库,存储模型都是 key-value 格式的,所以要存入缓存,得要有对应的 key。key 有两种生成方式,第一种是直接指定,这种方式一般用于某些定制化的缓存当中,通用返回接口的缓存得要用第二种方式,也就是通过键生成器来生成缓存的 key。condition 和 unless 的区别是,condition 是条件成立时,存入缓存;unless 是排除值不成立的,存入缓存。这两者看起来是一个意思,但是在逻辑上来说还是有细微差别的,一个是阻止存入缓存(unless),但是还是会在缓存中查找;另外一个是先判断 condition 的条件(condition),如果不成立,则不会查找缓存,也不会存入缓存。以上的 key,condition,unless 都是使用的 SpEL 表达式,后面会在实例中有一些简单的介绍,详细的说明也可通过其他文章学习。

在这些属性中,key 的生成格外重要,要能够通用,不必为每个需要用缓存的方法都手动生成 key,又要保证唯一性,因为不止是方法名会影响 key 值,每次调用时参数的不一致 都应该是不同的 key。这里keyGenerator很好的帮我们完成了这样的工作。

可以使用Spring默认的SimpleKeyGenerator来生成 key,但是这个 key 是不会将函数名组合在 key 中,也是有缺陷,所以我们需要自定义一个 keyGenerator。

@Override
public Object generate(Object target, Method method, Object... params) {
        Logger log = Logger.getLogger("Keygenerate");
        StringBuilder key = new StringBuilder();
        key.append(method.getDeclaringClass().getName()).append(".").append(method.getName()).append(":");  //先将类的全限定名和方法名拼装在 key 中
        if (params.length == 0) {
            return key.append(NO_PARAM_KEY).toString();
        }
        for (Object param : params) {   //通过遍历参数,将参数也拼装在 key 中,保证每次获取key 的唯一性
            if (param == null) {
                key.append(NULL_PARAM_KEY);
            } else if (ClassUtils.isPrimitiveArray(param.getClass())) {
                int length = Array.getLength(param);
                for (int i = 0; i < length; i++) {
                    key.append(Array.get(param, i));
                    key.append(',');
                }
            } else if (ClassUtils.isPrimitiveOrWrapper(param.getClass()) || param instanceof String) {
                key.append(param);
            } else {
                key.append(param.hashCode());   //如果是map 或 model 类型
            }
            key.append('-');
        }
        return key.toString();
    }

我是将实现了 KeyGenerator 的类放在了 Spring 的上下文中,这样子只要是使用了@Cacheable 注解的方法都可以根据规则来生成唯一的 key 了。
当然实际项目中还是有可能是会需要针对特定的方法来生成 key 的,下面给一个实例来说明:

@Cacheable(unless = "#result == '{\"data\":[],\"total_count\":0}'",key = "'keyGenerator' + '.' + #methodName + ':' + #id")

这是一个带有 unless 和 key 的注解,实现的功能是查询,当没有值时不存入缓存。
到此我们已经可以通过注解将获取到的值存入缓存,并直接通过缓存将值获取出来,不用额外的调用数据库了,接下来的工作是当 save/update/delete 等操作时,将相关数据从缓存中清除,以保证获取数据的准确性。

cache 库的注解中是有可以实现这个功能的,@CacheEvict。但是当我们通过 KeyGenerator 来自定义生成 key 时,@CacheEvict 便无法获取对应的 Key,则无法正确清除相关缓存。举个栗子,有用户表和订单表,用户表有一次查询,在缓存中生成这次查询的缓存,订单表也有一次查询,在缓存中生成这次查询的缓存。这时新增一条订单,需要清空订单相关的全部缓存,否则会出现获取数据不一致的情况。但是如果通过@CacheEvict 来做,是无法知道目前 Redis 中关于订单缓存的 Key 的,当然可以全部清空,这样会把用户表的缓存也清空掉,这必然是不好的。

那为了实现相关操作只清空相关的所有缓存,这里采取 AOP 的方式,对 save/update/delete 切面,当有这些操作的时候,就清空对应的缓存。

这里有两种做法,第一种直接将切点设置成save/update/delete,在每次进入方法前删除缓存,但是这种做法一个是得严格限制方法名,另外一个是如果有一些其他方法想要删除缓存,就得要增加切点。所以这里用第二种方法,自定义注解,然后通过检查方法是否带有该注解,来判断是不是需要清空缓存。

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface ClearRedis {
}

首先是自定义的缓存,然后在需要用到删除的方法上面使用该缓存即可

@ClearRedis
public String save(User user){...}

这样准备工作就算完成了,接下来是AOP 相关的代码

@Component
@Aspect
public class AspectJConfig {
    @Pointcut("execution(* com.Demo.*.*(..))")
    private void clearCache(){}
    //save 方法前,清空相关 key的缓存
    @Before("clearCache()")
    public void beforeSave(JoinPoint joinPoint) throws Throwable {
        String targetName = joinPoint.getTarget().getClass().getName();
        Class targetClass = Class.forName(targetName);
        Method[] methods = targetClass.getMethods();
        String methodName = joinPoint.getSignature().getName();
        boolean isClearRedisPresent = false;
        for (Method method : methods)
        {
            if (method.getName().equals(methodName))
            {
                if (method.isAnnotationPresent(ClearRedis.class))
                {
                    isClearRedisPresent = true;
                    break;
                }
            }
        }
        if (isClearRedisPresent)
        {
            //获取切点作用的方法
            Signature signature = joinPoint.getSignature();
            MethodSignature methodSignature = (MethodSignature) signature;
            //获取有作用方法前缀的 key,遍历以删除该切点作用方法关联的缓存,因为 save 有刷新数据库
            Set<String> keys = stringRedisTemplate.keys(methodSignature.getDeclaringTypeName() + "*");
            stringRedisTemplate.delete(keys);
            keys = stringRedisTemplate.keys(methodSignature.getDeclaringTypeName() + "*");            
        }
    }
}

由于是通过增加注解的方式,所以切点的范围可以定位到 service 层的所有方法上。逻辑上来说在save/delete/update 前,后删除缓存都是可以的,所以是用@Before 还是@After 或者@Around 都是可以的。

方法体内分为两个部分,第一个部分是判断该切点方法有没有使用@ClearRedis 注解,第二部分是当使用了注解,则清空对应的缓存。这两步都是利用了 JAVA 的反射机制,通过 joinPoint 来找到对应的调用类和调用方法以及调用方法的参数,这样我们就可以根据类+方法名+参数列表来组装对应的 key,这个跟上面在 KeyGenerator 中生成 key 的逻辑是一一对应的。最后是利用的 Redis 的模糊查询的逻辑可删除对应前缀的 Key,也就是我们可以不管参数是多少,是用哪个方法调用的,直接删除指定类获取到的所有缓存。

到此为止所有的部分就介绍完毕了,通过这样的配置,可以简单的在获取方法上增加@Cacheable 注解生成缓存,同时在方法上增加@ClearRedis 来清空类对应的缓存,保证了读的效率,也同时保证的读的准确性。

最后有两点存疑
1.我之前试过用@CacheEvict,想来生成指定的 Key,并通过前缀删除,但是好像做不到,因为前缀删除这个功能是 Redis 的,不是 cache 的。不过我觉得既然 cache 提供这样一个注解,应该不至于做不到这个需求,所以还得再继续看一下。

2.第二个就是如果将切点设置成 service 层所有的方法,会不会对效率有所影响,这个也要在实际的运行环境中检测才行。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 160,999评论 4 368
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 68,102评论 1 302
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 110,709评论 0 250
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,439评论 0 217
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,846评论 3 294
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,881评论 1 224
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 32,062评论 2 317
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,783评论 0 205
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,517评论 1 248
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,762评论 2 253
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,241评论 1 264
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,568评论 3 260
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,236评论 3 241
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,145评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,941评论 0 201
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,965评论 2 283
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,802评论 2 275

推荐阅读更多精彩内容