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的方式一样，在方法上直接注解即可。

wxiaoqi/ace-cache