Cache (autoload-cache-common fut.1.2 API)

@Retention(value=RUNTIME)
 @Target(value=METHOD)
 @Inherited
 @Documented
public @interface Cache

缓存注解

必需元素概要

所需元素
限定符和类型必需的元素和说明

int expire
缓存的过期时间，单位：秒，如果为0则表示永久缓存

String key
自定义缓存Key，支持表达式

所需元素
限定符和类型	必需的元素和说明
`int`	`expire` 缓存的过期时间，单位：秒，如果为0则表示永久缓存
`String`	`key` 自定义缓存Key，支持表达式

可选元素概要

可选元素
限定符和类型	可选元素和说明
`int`	`alarmTime` 预警自动刷新时间(单位：秒)，必须满足 0 < alarmTime < expire才有效当缓存在alarmTime 时间内即将过期的话，会自动刷新缓存内容；
`boolean`	`alwaysCache` 是否总是缓存（常驻内存）默认不开启; 如果开启则缓存的有效期为永久,高频/低频/后台刷新异常则均不影响缓存的生命周期
`boolean`	`argumentsDeepcloneEnable` 是否打开对参数进行深度复制,默认是true,是为了避免外部改变参数值。
`boolean`	`autoload` 是否启用自动加载缓存，缓存时间必须大于120秒时才有效如果magic为true时，会强制关闭自动加载功能
`String`	`autoloadCondition` 自动缓存的条件，可以为空，返回 true 或者 false，如果设置了此值，autoload() 就失效，例如：null !
`String`	`condition` 缓存的条件表达式，可以为空，返回 true 或者 false，只有为 true 才进行缓存
`ExCache[]`	`exCache` 扩展缓存
`String`	`expireExpression` 动态获取缓存过期时间的表达式，当其执行结果为null或小于0的整数时，会使用expire
`String`	`hfield` 设置哈希表中的字段，如果设置此项，则用哈希表进行存储，支持表达式
`int`	`lockExpire` 分布式锁的缓存时间（单位：秒），在设置分布式锁的前提下，如果此项值大于0，则会使用分布式锁，如果小于等于0，则不会使用分布式锁。
`Magic`	`magic` 魔术模式
`boolean`	`openLockDown` 是否开启锁降级默认不开启; 如果开启，当分布式锁抛异常时不使用分布式锁
`CacheOpType`	`opType` 缓存的操作类型：默认是READ_WRITE，先缓存取数据，如果没有数据则从DAO中获取并写入缓存；如果是WRITE则从DAO取完数据后，写入缓存
`long`	`requestTimeout` 当autoload为true时，缓存数据在 requestTimeout 秒之内没有使用了，就不进行自动加载数据,如果requestTimeout为0时，会一直自动加载
`int`	`waitTimeOut` 并发等待时间(毫秒),等待正在DAO中加载数据的线程返回的等待时间。

- 元素详细资料
  - expire
```
public abstract int expire
```
    缓存的过期时间，单位：秒，如果为0则表示永久缓存
    
    返回:
    
    时间
- - key
```
public abstract String key
```
    自定义缓存Key，支持表达式
    
    返回:
    
    String 自定义缓存Key
- - magic
```
public abstract Magic magic
```
    魔术模式
    
    返回:
    
    Magic
    
    默认值:
    
    @com.jarvis.cache.annotation.Magic(key="")
- - expireExpression
```
public abstract String expireExpression
```
    动态获取缓存过期时间的表达式，当其执行结果为null或小于0的整数时，会使用expire
    
    返回:
    
    时间
    
    默认值:
    
    ""
- - alarmTime
```
public abstract int alarmTime
```
    预警自动刷新时间(单位：秒)，必须满足 0 < alarmTime < expire才有效当缓存在alarmTime 时间内即将过期的话，会自动刷新缓存内容；
    
    返回:
    
    时间
    
    默认值:
    
    0
- - hfield
```
public abstract String hfield
```
    设置哈希表中的字段，如果设置此项，则用哈希表进行存储，支持表达式
    
    返回:
    
    String
    
    默认值:
    
    ""
- - autoload
```
public abstract boolean autoload
```
    是否启用自动加载缓存，缓存时间必须大于120秒时才有效如果magic为true时，会强制关闭自动加载功能
    
    返回:
    
    boolean
    
    默认值:
    
    false
- - alwaysCache
```
public abstract boolean alwaysCache
```
    是否总是缓存（常驻内存）默认不开启; 如果开启则缓存的有效期为永久,高频/低频/后台刷新异常则均不影响缓存的生命周期
    
    返回:
    
    boolean
    
    默认值:
    
    false
- - autoloadCondition
```
public abstract String autoloadCondition
```
    自动缓存的条件，可以为空，返回 true 或者 false，如果设置了此值，autoload() 就失效，例如：null != #args[0].keyword，当第一个参数的keyword属性为null时设置为自动加载。
    
    返回:
    
    String 表达式
    
    默认值:
    
    ""
- - requestTimeout
```
public abstract long requestTimeout
```
    当autoload为true时，缓存数据在 requestTimeout 秒之内没有使用了，就不进行自动加载数据,如果requestTimeout为0时，会一直自动加载
    
    返回:
    
    long 请求过期
    
    默认值:
    
    36000L
- - condition
```
public abstract String condition
```
    缓存的条件表达式，可以为空，返回 true 或者 false，只有为 true 才进行缓存
    
    返回:
    
    String
    
    默认值:
    
    ""
- - opType
```
public abstract CacheOpType opType
```
    缓存的操作类型：默认是READ_WRITE，先缓存取数据，如果没有数据则从DAO中获取并写入缓存；如果是WRITE则从DAO取完数据后，写入缓存
    
    返回:
    
    CacheOpType
    
    默认值:
    
    com.jarvis.cache.type.CacheOpType.READ_WRITE
- - waitTimeOut
```
public abstract int waitTimeOut
```
    并发等待时间(毫秒),等待正在DAO中加载数据的线程返回的等待时间。
    
    返回:
    
    时间
    
    默认值:
    
    500
- - exCache
```
public abstract ExCache[] exCache
```
    扩展缓存
    
    返回:
    
    ExCache[]
    
    默认值:
    
    @com.jarvis.cache.annotation.ExCache(expire=-1, key="")
- - lockExpire
```
public abstract int lockExpire
```
    分布式锁的缓存时间（单位：秒），在设置分布式锁的前提下，如果此项值大于0，则会使用分布式锁，如果小于等于0，则不会使用分布式锁。
    
    返回:
    
    分布式锁的缓存时间
    
    默认值:
    
    10
- - openLockDown
```
public abstract boolean openLockDown
```
    是否开启锁降级默认不开启; 如果开启，当分布式锁抛异常时不使用分布式锁
    
    默认值:
    
    false
- - argumentsDeepcloneEnable
```
public abstract boolean argumentsDeepcloneEnable
```
    是否打开对参数进行深度复制,默认是true,是为了避免外部改变参数值。如果确保不被修改，最好是设置为false,这样性能会更高。
    
    返回:
    
    是否打开对参数进行深度复制
    
    默认值:
    
    true

注释类型 Cache

必需元素概要

可选元素概要

元素详细资料

expire

key

magic

expireExpression

alarmTime

hfield

autoload

alwaysCache

autoloadCondition

requestTimeout

condition

opType

waitTimeOut

exCache

lockExpire

openLockDown

argumentsDeepcloneEnable