ace-cache
基于spring boot上的注解缓存,自带轻量级缓存管理页面。
@Cache比spring cache更轻量的缓存,支持单个缓存设置过期时间,可以根据前缀移除缓存。
采用fastjson序列化与反序列化,以json串存于缓存之中。
ace-cache可以快速用于日常的spring boot应用之中。
使用手册
Maven依赖
<dependency>
<groupId>com.github.wxiaoqi</groupId>
<artifactId>ace-cache</artifactId>
<version>1.0.0</version>
</dependency>
缓存配置
1、配置redis数据源,application.yml文件
# 1.0.0版本推荐使用spring redis配置
spring:
redis:
database: 0
host: localhost
timeout: 2000
sysName: ace #默认key前缀
enable: true #是否启用ace-cache
userkey: #用户会话的标志,存放于cookie或request header
lettuce:
pool:
max-active: 300
min-idle: 100
max-wait: 1000
# 不建议使用配置,此配置在0.0.2以下版本使用
redis:
pool:
maxActive: 300
maxIdle: 100
maxWait: 1000
host: 127.0.0.1
port: 6379
password:
timeout: 2000
# 服务或应用名
sysName: ace
enable: true
database: 0
缓存开启
2、开启AOP扫描
@EnableAceCache
缓存使用
3、在Service上进行@Cache注解或@CacheClear注解
注解说明
配置缓存:@Cache
注解参数 | 类型 | 说明 |
---|---|---|
key | 字符串 | 缓存表达式,动态运算出key |
expires | 整形 | 缓存时长,单位:分钟 |
desc | 描述 | 缓存说明 |
scope | 枚举 | 缓存作用范围,会话级还是应用级 |
parser | Class<? extends ICacheResultParser> | 缓存返回结果自定义处理类 |
generator | Class<? extends IKeyGenerator> | 缓存键值自定义生成类 |
result | Class[] | 缓存返回结果自定义类型,默认取第一位 |
清除缓存:@CacheClear
注解参数 | 类型 | 说明 |
---|---|---|
pre | 字符串 | 清除某些前缀key缓存 |
key | 字符串 | 清除某个key缓存 |
keys | 字符串数组 | 清除某些前缀key缓存 |
generator | Class<? extends IKeyGenerator> | 缓存键值自定义生成类 |
全局分布式锁:@CacheGlobalLock
注解参数 | 类型 | 说明 |
---|---|---|
key | 字符串 | 分布式做key表达式 |
retry | 整形 | 重试加锁间隔时间,单位ms |
waitLock | 布尔型 | 是否一直等待全局锁? 默认为否,获取不到锁则不执行程序。 |
generator | Class<? extends IKeyGenerator> | 缓存键值自定义生成类 |
默认key动态表达式说明
表达式举例 | 说明 | 举例 |
---|---|---|
@Cache(key="user:{1}") public User getUserByAccount(String account) |
{1}表示获取第一个参数值 {2}表示获取第二个参数值 ……依此类推 |
若:account = ace,则:key = user:ace |
@CacheClear(pre="user{1.account}") User saveOrUpdate(User user) |
{1}表示获取第一个参数值 {1.xx}表示获取第一个参数中的xxx属性 |
若:account=ace,则:key = user:ace |
轻量管理端
访问地址:http://localhost:8080/cache
管理端批量或前缀清除ace-cache注册的缓存,同时也可以快速预览缓存的数据内容,也可以对缓存的失效时间进行延长。
Demo
1、在src/main/test中展开的相关示例代码
CacheTest是核心启动类
service包是缓存调用例子,包含自定义表达式和结果解析、注解的使用
2017年5月22日
初次与大家见面,请多多指教!
2017年5月23日 兼容spring mvc模式
配置文文件
application.properties
redis.pool.maxActive = 300
redis.pool.maxIdle = 100
redis.pool.maxWait = 1000
redis.host = 127.0.0.1
redis.port = 6379
redis.password =
redis.timeout = 2000
redis.database = 0
redis.sysName = ace
redis.enable = true
applicationContext.xml
<!-- beans 头部-->
xmlns:aop="http://www.springframework.org/schema/aop"
xmlns:context="http://www.springframework.org/schema/context"
xsi:schemaLocation="
http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.1.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-3.0.xsd"
<!-- 开启AOP配置 -->
<aop:aspectj-autoproxy></aop:aspectj-autoproxy>
<context:component-scan base-package="com.ace.cache"/>
<context:annotation-config/>
maven依赖
<properties>
<!-- spring -->
<spring.version>4.1.3.RELEASE</spring.version>
<properties>
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-core</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-beans</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context-support</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-aspects</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.aspectj</groupId>
<artifactId>aspectjrt</artifactId>
<version>${aspectj.version}</version>
</dependency>
</dependencies>
使用方式
使用方式与spring boot的方式一样,在方法上直接注解即可。