README.md · todayliao/Cloud-Cache

# 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注册的缓存，同时也可以快速预览缓存的数据内容，也可以对缓存的失效时间进行延长。
![输入图片说明](https://images.gitee.com/uploads/images/2020/0913/122505_93749824_547642.png "WX20200913-122442@2x.png")
# 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
```

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:aspectj-autoproxy></aop:aspectj-autoproxy>
<context:component-scan base-package="com.ace.cache"/>
<context:annotation-config/> 
```
##### maven依赖
```
<properties>
 
 <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的方式一样，在方法上直接注解即可。

todayliao/Cloud-Cache

简介

发行版

贡献者

近期动态

todayliao/Cloud-Cache .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

todayliao/Cloud-Cache