AbstractCache (hutool 6.0.0-M20 API)

java.lang.Object
- org.dromara.hutool.core.cache.impl.AbstractCache<K,V>

Type Parameters:

K - 键类型

V - 值类型

All Implemented Interfaces:

Serializable, Iterable<V>, Cache<K,V>

Direct Known Subclasses:

LockedCache
```
public abstract class AbstractCache<K,V>
extends Object
implements Cache<K,V>
```
超时和限制大小的缓存的默认实现
继承此抽象缓存需要：
- 创建一个新的Map
- 实现 prune 策略
Author:

Looly, jodd

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`protected Map<Mutable<K>,CacheObj<K,V>>`	`cacheMap` 缓存Map。
`protected int`	`capacity` 返回缓存容量，`0`表示无大小限制
`protected boolean`	`existCustomTimeout` 每个对象是否有单独的失效时长，用于决定清理过期对象是否有必要。
`protected LongAdder`	`hitCount` 命中数，即命中缓存计数
`protected Map<K,Lock>`	`keyLockMap` 写的时候每个key一把锁，降低锁的粒度
`protected CacheListener<K,V>`	`listener` 缓存监听
`protected LongAdder`	`missCount` 丢失数，即未命中缓存计数
`protected long`	`timeout` 缓存失效时长， `0` 表示无限制，单位毫秒

Constructor Summary

Constructors
Constructor and Description

AbstractCache()

Constructors
Constructor and Description
`AbstractCache()`

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`protected Iterator<CacheObj<K,V>>`	`cacheObjIter()` 获取所有`CacheObj`值的`Iterator`形式
`int`	`capacity()` 返回缓存容量，`0`表示无大小限制
`V`	`get(K key, boolean isUpdateLastAccess, long timeout, SerSupplier<V> supplier)` 从缓存中获得对象，当对象不在缓存中或已经过期（与当前时间差值大于超时时间）返回SerSupplier回调产生的对象，否则返回值。
`V`	`get(K key, boolean isUpdateLastAccess, SerSupplier<V> supplier)` 从缓存中获得对象，当对象不在缓存中或已经过期（与当前时间差值大于超时时间）返回SerSupplier回调产生的对象，否则返回值。
`long`	`getHitCount()`
`long`	`getMissCount()`
`protected CacheObj<K,V>`	`getWithoutLock(K key)` 获取键对应的`CacheObj`
`boolean`	`isEmpty()` 缓存是否为空
`boolean`	`isFull()` 缓存是否已满，仅用于有空间限制的缓存对象
`protected boolean`	`isPruneExpiredActive()` 只有设置公共缓存失效时长或每个对象单独的失效时长时清理可用
`Iterator<V>`	`iterator()`
`Set<K>`	`keySet()` 返回所有键
`protected void`	`onRemove(K key, V cachedObject)` 对象移除回调。
`protected abstract int`	`pruneCache()` 清理实现子类实现此方法时无需加锁
`void`	`put(K key, V object)` 将对象加入到缓存，使用默认失效时长
`protected void`	`putWithoutLock(K key, V object, long timeout)` 加入元素，无锁
`protected CacheObj<K,V>`	`removeWithoutLock(K key)` 移除key对应的对象，不加锁
`AbstractCache<K,V>`	`setListener(CacheListener<K,V> listener)` 设置监听
`int`	`size()` 缓存的对象数量
`long`	`timeout()` 缓存失效时长， `0` 表示没有设置，单位毫秒
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.dromara.hutool.core.cache.Cache
cacheObjIterator, clear, containsKey, get, get, get, prune, put, remove

Methods inherited from interface java.lang.Iterable
forEach, spliterator

- Field Detail
  - cacheMap
```
protected Map<Mutable<K>,CacheObj<K,V>> cacheMap
```
    缓存Map。子类中初始化
  - keyLockMap
```
protected final Map<K,Lock> keyLockMap
```
    写的时候每个key一把锁，降低锁的粒度
  - capacity
```
protected int capacity
```
    返回缓存容量，0表示无大小限制
  - timeout
```
protected long timeout
```
    缓存失效时长， 0 表示无限制，单位毫秒
  - existCustomTimeout
```
protected boolean existCustomTimeout
```
    每个对象是否有单独的失效时长，用于决定清理过期对象是否有必要。
  - hitCount
```
protected LongAdder hitCount
```
    命中数，即命中缓存计数
  - missCount
```
protected LongAdder missCount
```
    丢失数，即未命中缓存计数
  - listener
```
protected CacheListener<K,V> listener
```
    缓存监听
- Constructor Detail
  - AbstractCache
```
public AbstractCache()
```
- Method Detail
  - put
```
public void put(K key,
                V object)
```
    Description copied from interface: Cache
    
    将对象加入到缓存，使用默认失效时长
    
    Specified by:
    
    put in interface Cache<K,V>
    
    Parameters:
    
    key - 键
    
    object - 缓存的对象
    
    See Also:
    
    Cache.put(Object, Object, long)
  - putWithoutLock
```
protected void putWithoutLock(K key,
                              V object,
                              long timeout)
```
    加入元素，无锁
    
    Parameters:
    
    key - 键
    
    object - 值
    
    timeout - 超时时长
    
    Since:
    
    4.5.16
  - getHitCount
```
public long getHitCount()
```
    Returns:
    
    命中数
  - getMissCount
```
public long getMissCount()
```
    Returns:
    
    丢失数
  - get
```
public V get(K key,
             boolean isUpdateLastAccess,
             SerSupplier<V> supplier)
```
    Description copied from interface: Cache
    
    从缓存中获得对象，当对象不在缓存中或已经过期（与当前时间差值大于超时时间）返回SerSupplier回调产生的对象，否则返回值。
    每次调用此方法会可选是否刷新最后访问时间，true表示会重新计算超时时间。
    
    Specified by:
    
    get in interface Cache<K,V>
    
    Parameters:
    
    key - 键
    
    isUpdateLastAccess - 是否更新最后访问时间，即重新计算超时时间。
    
    supplier - 如果不存在回调方法，用于生产值对象
    
    Returns:
    
    值对象
  - get
```
public V get(K key,
             boolean isUpdateLastAccess,
             long timeout,
             SerSupplier<V> supplier)
```
    Description copied from interface: Cache
    
    从缓存中获得对象，当对象不在缓存中或已经过期（与当前时间差值大于超时时间）返回SerSupplier回调产生的对象，否则返回值。
    每次调用此方法会可选是否刷新最后访问时间，true表示会重新计算超时时间。
    
    Specified by:
    
    get in interface Cache<K,V>
    
    Parameters:
    
    key - 键
    
    isUpdateLastAccess - 是否更新最后访问时间，即重新计算超时时间。
    
    timeout - 自定义超时时间
    
    supplier - 如果不存在回调方法，用于生产值对象
    
    Returns:
    
    值对象
  - getWithoutLock
```
protected CacheObj<K,V> getWithoutLock(K key)
```
    获取键对应的CacheObj
    
    Parameters:
    
    key - 键，实际使用时会被包装为MutableObj
    
    Returns:
    
    CacheObj
    
    Since:
    
    5.8.0
  - iterator
```
public Iterator<V> iterator()
```
    Specified by:
    
    iterator in interface Iterable<V>
  - pruneCache
```
protected abstract int pruneCache()
```
    清理实现
    子类实现此方法时无需加锁
    
    Returns:
    
    清理数
  - capacity
```
public int capacity()
```
    Description copied from interface: Cache
    
    返回缓存容量，0表示无大小限制
    
    Specified by:
    
    capacity in interface Cache<K,V>
    
    Returns:
    
    返回缓存容量，0表示无大小限制
  - timeout
```
public long timeout()
```
    Description copied from interface: Cache
    
    缓存失效时长， 0 表示没有设置，单位毫秒
    
    Specified by:
    
    timeout in interface Cache<K,V>
    
    Returns:
    
    默认缓存失效时长。
    每个对象可以单独设置失效时长
  - isPruneExpiredActive
```
protected boolean isPruneExpiredActive()
```
    只有设置公共缓存失效时长或每个对象单独的失效时长时清理可用
    
    Returns:
    
    过期对象清理是否可用，内部使用
  - isFull
```
public boolean isFull()
```
    Description copied from interface: Cache
    
    缓存是否已满，仅用于有空间限制的缓存对象
    
    Specified by:
    
    isFull in interface Cache<K,V>
    
    Returns:
    
    缓存是否已满，仅用于有空间限制的缓存对象
  - size
```
public int size()
```
    Description copied from interface: Cache
    
    缓存的对象数量
    
    Specified by:
    
    size in interface Cache<K,V>
    
    Returns:
    
    缓存的对象数量
  - isEmpty
```
public boolean isEmpty()
```
    Description copied from interface: Cache
    
    缓存是否为空
    
    Specified by:
    
    isEmpty in interface Cache<K,V>
    
    Returns:
    
    缓存是否为空
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - setListener
```
public AbstractCache<K,V> setListener(CacheListener<K,V> listener)
```
    设置监听
    
    Specified by:
    
    setListener in interface Cache<K,V>
    
    Parameters:
    
    listener - 监听
    
    Returns:
    
    this
    
    Since:
    
    5.5.2
  - keySet
```
public Set<K> keySet()
```
    返回所有键
    
    Returns:
    
    所有键
    
    Since:
    
    5.5.9
  - onRemove
```
protected void onRemove(K key,
                        V cachedObject)
```
    对象移除回调。默认无动作
    子类可重写此方法用于监听移除事件，如果重写，listener将无效
    
    Parameters:
    
    key - 键
    
    cachedObject - 被缓存的对象
  - removeWithoutLock
```
protected CacheObj<K,V> removeWithoutLock(K key)
```
    移除key对应的对象，不加锁
    
    Parameters:
    
    key - 键
    
    Returns:
    
    移除的对象，无返回null
  - cacheObjIter
```
protected Iterator<CacheObj<K,V>> cacheObjIter()
```
    获取所有CacheObj值的Iterator形式
    
    Returns:
    
    Iterator
    
    Since:
    
    5.8.0

Class AbstractCache<K,V>

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface org.dromara.hutool.core.cache.Cache

Methods inherited from interface java.lang.Iterable

Field Detail

cacheMap

keyLockMap

capacity

timeout

existCustomTimeout

hitCount

missCount

listener

Constructor Detail

AbstractCache

Method Detail

put

putWithoutLock

getHitCount

getMissCount

get

get

getWithoutLock

iterator

pruneCache

capacity

timeout

isPruneExpiredActive

isFull

size

isEmpty

toString

setListener

keySet

onRemove

removeWithoutLock

cacheObjIter