# mPass-cache

**Repository Path**: ibyte/icloud-cache

## Basic Information

- **Project Name**: mPass-cache
- **Description**: 基于Spring Boot上的注解缓存，自带轻量级缓存管理页面。@Cache比spring cache更轻量的缓存，支持单个缓存设置过期时间，可以根据前缀移除缓存。采用fastjson序列化与反序列化，以json串存于缓存之中。icloud-cache可以快速用于日常的spring boot应用之中。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 97
- **Forks**: 41
- **Created**: 2018-11-15
- **Last Updated**: 2025-02-12

## Categories & Tags

**Categories**: cache-modules, spring-boot-ext

**Tags**: None

## README

[![fork](https://gitee.com/ibyte/icloud-cache/badge/fork.svg?theme=gray)](https://gitee.com/ibyte/icloud-cache/members)
[![Maven Central Repo](https://img.shields.io/maven-central/v/com.ctrip.framework.apollo/apollo.svg)](https://oss.sonatype.org/#nexus-search;quick~icloud-cache)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
[![build](https://img.shields.io/wercker/build/wercker/go-wercker-api/master.svg)](https://gitee.com/ibyte/icloud-cache)
[![librariesio](https://img.shields.io/librariesio/release/hex/phoenix/1.0.3.svg)](https://gitee.com/ibyte/icloud-cache)
[![uptimerobot](https://img.shields.io/uptimerobot/status/m778918918-3e92c097147760ee39d02d36.svg)](https://gitee.com/ibyte/icloud-cache)
[![stars](https://img.shields.io/amo/stars/dustman.svg)](https://gitee.com/ibyte/icloud-cache)


基于spring boot上的注解缓存，自带轻量级缓存管理页面。<br>
@Cache比spring cache更轻量的缓存，支持单个缓存设置过期时间，可以根据前缀移除缓存。<br>
采用fastjson序列化与反序列化，以json串存于缓存之中。<br>
icloud-cache可以快速用于日常的spring boot应用之中。<br>

> 数据可视化展示（生产环境不建议使用）

![输入图片说明](https://images.gitee.com/uploads/images/2018/1204/101824_234f5acc_1468963.png "屏幕截图.png")
> Redis 客户端查看

![输入图片说明](https://images.gitee.com/uploads/images/2018/1204/101903_1fa09224_1468963.png "屏幕截图.png")

> Cache API
![输入图片说明](https://images.gitee.com/uploads/images/2018/1204/114233_01acbf48_1468963.png "屏幕截图.png")

# 使用手册
## Maven依赖
```
<dependency>
    <groupId>com.gitee.ibyte</groupId>
    <artifactId>icloud-cache</artifactId>
    <version>0.0.2</version>
</dependency>
```
## 缓存配置
1、配置redis数据源，application.yml文件
```
#redis-cache 相关
redis:
    pool:
         maxActive: 300
         maxIdle: 100
         maxWait: 1000
    host: 127.0.0.1
    port: 6379
    password:
    timeout: 2000
    # 服务或应用名
    sysName: icloud
    enable: true
    database: 0
```
## 缓存开启
2、开启AOP扫描
```
@EnableiCloudCache
```
## 缓存使用
3、在Service上进行@Cache注解或@CacheClear注解
# 注解说明
## 配置缓存：@Cache
 注解参数 | 类型  | 说明
 -------------  |------------- | -----
 key  | 字符串                                | 缓存表达式，动态运算出key 
 expires        | 整形            |    缓存时长，单位：分钟 
 desc           | 描述            |   缓存说明              
 parser         | Class<? extends ICacheResultParser> |  缓存返回结果自定义处理类 
 generator      | Class<? extends IKeyGenerator> |  缓存键值自定义生成类 
## 清除缓存：@CacheClear
注解参数 | 类型  | 说明
 -------------  |------------- | -----
 pre	|字符串 |	清除某些前缀key缓存
key |	字符串 |	清除某个key缓存
keys |	字符串数组 |	清除某些前缀key缓存
generator      | Class<? extends IKeyGenerator> |  缓存键值自定义生成类 
## 默认key动态表达式说明
表达式举例 | 说明 | 举例
-------------  |------------- | -----
@Cache(key="user:{1}")<br>public User getUserByAccount(String account) | {1}表示获取第一个参数值<br>{2}表示获取第二个参数值<br>……依此类推 | 若：account = icloud，则：key = user:icloud
@CacheClear(pre="user{1.account}")<br>User saveOrUpdate(User user)|{1}表示获取第一个参数值<br>{1.xx}表示获取第一个参数中的xxx属性|若：account=icloud，则：key = user:icloud
# 轻量管理端
访问地址：http://localhost:8080/cache
<br>管理端批量或前缀清除icloud-cache注册的缓存，同时也可以快速预览缓存的数据内容，也可以对缓存的失效时间进行延长。

# Demo
1、在src/main/test中展开的相关示例代码
>CacheTest是核心启动类
>>service包是缓存调用例子，包含自定义表达式和结果解析、注解的使用


## 兼容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 = icloud
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.icloud.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>

```