一款好用的spring缓存注解组件

tutu-cache 是为了解决SpringCache缓存注解不够灵活的问题而做的SpringAop项目。使用tutu-cache注解来代替@Cacheable和@CacheEvict等注解

开源地址：https://github.com/trifolium-x/tutu-cache

文档地址：tutu-cache doc

快速开始

1. 在springBoot中的使用

   • 引入jar依赖包

     
     <dependencies>
     
       <dependency>
     
           <groupId>co.tunan.tucache</groupId>
     
           <artifactId>tucache-spring-boot-starter</artifactId>
     
           <version>1.0.4.RELEASE</version>
     
       </dependency>
     
       <!-- 建议使用redis 或者直接忽略使用本地缓存 -->
     
       <dependency>
     
           <groupId>org.springframework.boot</groupId>
     
           <artifactId>spring-boot-starter-data-redis</artifactId>
     
       </dependency>
     
     </dependencies>
     
       <!-- 或者其他缓存 -->
     
     

使用tu-cache

1. 使用tu-cache对service中的方法返回的数据进行缓存

   
   @TuCache("test_service:getList")
   
   public List<String> getList(){
   
       return Arrays.asList("tu","nan");
   
   }
   
   

2. 使用tu-cache删除缓存中的数据

   
   @TuCacheClear("test_service:getList")
   
   public void delList(){
   
   }
   
   

3. @TuCache参数

   • String key() default "" 缓存的字符串格式key,支持spEl表达式(使用#{}包裹spEl表达式)，默认值为方法签名

   • long expire() default -1 缓存的过期时间，单位(秒),默认永不过期. (在1.0.4.RELEASE以上版本中建议使用 timeout)

   • boolean resetExpire() default false 每次获取数据是否重置过期时间.

   • TimeUnit timeUnit() default TimeUnit.SECONDS 缓存的时间单位.

   • String condition() default "true" 扩展的条件过滤，值为spEl表达式(直接编写表达式不需要使用#{}方式声明为spEl)

   • 样例:

     
     @TuCache(key="test_service:getList:#{#endStr}", timeout = 10, timeUnit=TimeUnit.SECONDS)
     
     public List<String> getList(String endStr){
     
         return Arrays.asList("tu","nan",endStr);
     
     }
     
     // 如果需要当前对象的的方法
     
     @TuCache(key="test_service:getList:#{#this.endStr()}", timeout = 120)
     
     public List<String> getList(){
     
         return Arrays.asList("tu","nan",endStr());
     
     }
     
     // 使用springBean, (使用安全访问符号?.，可以规避null错误，具体用法请查看spEl表达式)
     
     @TuCache(key="test_service:getList:#{@springBean.endStr()}", timeout = 120)
     
     public List<String> springBeanGetList(){
     
         return Arrays.asList("tu","nan",springBean.endStr());
     
     }
     
     // 使用condition,当name的长度>=5时进行缓存
     
     @TuCache(key="test_service:getList:#{#name}", condition="#name.length() >= 5")
     
     public List<String> springBeanGetList(String name){
     
         return Arrays.asList("tu","nan",name);
     
     }
     
     public String endStr(){
     
       return "end";
     
     }
     
     

4. @TuCacheClear参数

   • String[] key() default {} 删除的key数组，支持spEl表达式(使用#{}包裹spEl表达式)

   • String[] keys() default {} 模糊删除的缓存key数组,支持spEl表达式(使用#{}包裹spEl表达式),对应redis中deleteKeys(“test_service:”)

   • boolean async() default false 是否异步删除，无需等待删除的结果

   • String condition() default "true" 扩展的条件过滤，值为spEl表达式(直接编写表达式不需要使用#{}方式声明为spEl)

   • 样例:

     
     @TuCacheClear(key={"test_service:itemDetail:#{#id}"})
     
     public void deleteItem(Long id){
     
     }
     
     // 如果需要调用本地的方法
     
     @TuCacheClear(keys={"test_service:itemList:","test_service:itemDetail:#{#id}"}, async = true)
     
     public void deleteItem(Long id){
     
     }
     
     

   • 注意key和keys的区别

5. condition 的用法

   • condition要求spEL返回一个boolean类型的值，例如：

     • condition = “#param.startsWith(‘a’)”

     • condition = “false”

个性化设置

• tutu-cache默认提供了 RedisTuCacheService,如果用户使用的缓存是redis并配置了redisTemplate的bean则自动使用该默认缓存服务。

• 用户使用其他缓存，则需要自定义TuCacheService，实现该接口并注入到TuCacheBean中

• 在SpringBoot中在Configure类中配置相应的bean自动使用自定义的bean

• 如果用户需要每个缓存前面添加同意的keyPrefix，TuCacheBean的prefixKey参数

• springBoot中配置

  
  tucache:
  
    enabled: true
  
    cache-type: redis
  
    profiles:
  
      cache-prefix: "my_tu_key_test:"
  
      # ...