@DubboCache
提供dubbo消费者直接使用缓存的能力,当缓存不存在时,再访问远程dubbo服务。
相对于dubbo默认的缓存机制,此项目具有如下优点:
- 原生dubbo cache机制只能缓存结果到消费者jvm中,并且cache key不能选择。
- 缓存key生成灵活,和spring 声明式缓存一致,采用spring el表达式
- 可以扩展CacheKeyValidator接口,实现键缓存策略
- 可以扩展CacheValueValidator接口,实现值缓存策略
- 由于采用分布式缓存,服务提供端可以灵活控制缓存
目前仅提供redis实现,依赖spring-data-redis.
使用@DubboCache
 
在服务接口模块中依赖dubbo-cache-common
 
<dependency>
	<groupId>com.github.bohrqiu.dubbo</groupId>
	<artifactId>dubbo-cache-common</artifactId>
	<version>1.2</version>
</dependency> 
此依赖仅定义了@DubboCache注解。
在服务实现模块中依赖dubbo-cache-core
 
<dependency>
	<groupId>com.github.bohrqiu.dubbo</groupId>
	<artifactId>dubbo-cache-core</artifactId>
	<version>1.2</version>
</dependency> 
在服务接口上添加@DubboCache注解
 
public interface CacheableService {
	@DubboCache(cacheName = "test",key = "#order.playload")
	SingleValueResult<String> echo(SingleValueOrder<String> order);
} 
如上所示:cacheName=test,key为第一个参数的playload字段,缓存有效期默认5分钟。
上面的注解和@org.springframework.cache.annotation.Cacheable(value = "test", key = "#order.playload")生成的key一致。
对于dubbo服务消费者,只需要更新jar包即可,由服务提供者来觉得接口是否需要缓存,和缓存的控制。
注意: 参数名读取依赖java8编译参数-parameters,上面的例子也可以通过p0来引用第一个接口入参。
key生成
key生成策略和Cacheable一致,上面的例子中cache key由两部分组成:cacheName,spring el表达式结果,用:分隔.
如果请求参数order中playload属性值为dubbo,最终key为:test:dubbo
如果服务有多个版本或者group,需要对多个版本和group分别设置缓存,可以设置参数:
cachePrefixContainGroup=true
cachePrefixContainVersion=true
如果两个参数都设置,key由四部分组成:cacheName,group,version,spring el表达式结果,用:分隔,建议在provider端设置此配置。
控制缓存
@DubboCache提供了消费者可优先使用缓存,缓存的一致性由服务提供方负责,当服务提供方使用此注解后,所有的服务消费者都会使用此缓存。
控制缓存分为两种情况:
- 缓存一致性要求不高,可以通过DubboCache#expire设置过期时间,默认为5分钟。
- 缓存一致性要求高,服务提供方通过redisTemplate或者org.springframework.cache.annotation.CacheEvict控制缓存。
如何扩展
扩展CacheKeyValidator
 
CacheKeyValidator可以实现对特定的key、url缓存或者不缓存。默认策略为:key不为null可以缓存。
实现CacheKeyValidator
 
package com.github.bohrqiu.dubbo.cache.validator;
public class TestCacheKeyValidator implements CacheKeyValidator {
    @Override
	public boolean isValid(URL url, Invocation invocation, CacheMeta cacheMeta, Object elEvaluatedKey) {
		System.out.println("in TestCacheKeyValidator");
		return true;
	}
} 
配置扩展文件
在classpath下创建META-INF/dubbo/com.github.bohrqiu.dubbo.cache.CacheKeyValidator文件,内容为:
test=com.github.bohrqiu.dubbo.cache.validator.TestCacheValueValidator
设置服务url使自定义扩展生效
可以通过在provider配置application时指定(更多配置方式,参考dubbo相关文档).
<dubbo:application name="dubbo-cache-test">
	<dubbo:parameter key="cacheKeyValidator" value="test"/>
</dubbo:application> 
扩展CacheKeyValidator
 
扩展方式和上面的类似,更多参考dubbo扩展机制。 默认策略为:value不为null可以缓存。
 JarCasting
 JarCasting