org.dromara.hutool.core.cache.impl

类 StampedCache<K,V>

java.lang.Object

org.dromara.hutool.core.cache.impl.AbstractCache<K,V>

org.dromara.hutool.core.cache.impl.StampedCache<K,V>

类型参数:

K - 键类型

V - 值类型

所有已实现的接口:

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

直接已知子类:

FIFOCache, LFUCache, TimedCache

public abstract class StampedCache<K,V>
extends AbstractCache<K,V>

使用StampedLock保护的缓存，使用读写乐观锁

作者:

looly

从以下版本开始:

5.7.15

另请参阅:

序列化表格

字段概要

字段

限定符和类型	字段和说明
protected StampedLock	lock

从类继承的字段 org.dromara.hutool.core.cache.impl.AbstractCache

cacheMap, capacity, existCustomTimeout, hitCount, keyLockMap, listener, missCount, timeout

构造器概要

构造器

构造器和说明
StampedCache()

方法概要

限定符和类型	方法和说明
Iterator<CacheObj<K,V>>	cacheObjIterator() 返回包含键和值得迭代器
void	clear() 清空缓存
boolean	containsKey(K key) 是否包含key
V	get(K key, boolean isUpdateLastAccess) 从缓存中获得对象，当对象不在缓存中或已经过期返回null 调用此方法时，会检查上次调用时间，如果与当前时间差值大于超时时间返回null，否则返回值。
int	prune() 从缓存中清理过期对象，清理策略取决于具体实现
void	put(K key, V object, long timeout) 将对象加入到缓存，使用指定失效时长 如果缓存空间满了，Cache.prune() 将被调用以获得空间来存放新对象
void	remove(K key) 从缓存中移除对象

从类继承的方法 org.dromara.hutool.core.cache.impl.AbstractCache

cacheObjIter, capacity, get, getHitCount, getMissCount, getWithoutLock, isEmpty, isFull, isPruneExpiredActive, iterator, keySet, onRemove, pruneCache, put, putWithoutLock, removeWithoutLock, setListener, size, timeout, toString

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

从接口继承的方法 org.dromara.hutool.core.cache.Cache

get, get

从接口继承的方法 java.lang.Iterable

forEach, spliterator

字段详细资料

lock

protected final StampedLock lock

构造器详细资料

StampedCache

public StampedCache()

方法详细资料

put

public void put(K key,
                V object,
                long timeout)

从接口复制的说明: Cache

将对象加入到缓存，使用指定失效时长
如果缓存空间满了，Cache.prune() 将被调用以获得空间来存放新对象

参数:

key - 键

object - 缓存的对象

timeout - 失效时长，单位毫秒

containsKey

public boolean containsKey(K key)

从接口复制的说明: Cache

是否包含key

参数:

key - KEY

返回:

是否包含key

get

public V get(K key,
             boolean isUpdateLastAccess)

从接口复制的说明: Cache

从缓存中获得对象，当对象不在缓存中或已经过期返回null

调用此方法时，会检查上次调用时间，如果与当前时间差值大于超时时间返回null，否则返回值。

每次调用此方法会可选是否刷新最后访问时间，true表示会重新计算超时时间。

参数:

key - 键

isUpdateLastAccess - 是否更新最后访问时间，即重新计算超时时间。

返回:

键对应的对象

cacheObjIterator

public Iterator<CacheObj<K,V>> cacheObjIterator()

从接口复制的说明: Cache

返回包含键和值得迭代器

返回:

缓存对象迭代器

prune

public final int prune()

从接口复制的说明: Cache

从缓存中清理过期对象，清理策略取决于具体实现

返回:

清理的缓存对象个数

remove

public void remove(K key)

从接口复制的说明: Cache

从缓存中移除对象

参数:

key - 键

clear

public void clear()

从接口复制的说明: Cache

清空缓存