Class WeakCache<K,V>
java.lang.Object
com.sure.tool.cache.WeakCache<K,V>
- Type Parameters:
K- 键类型V- 值类型
- All Implemented Interfaces:
Cache<K,V>
弱引用缓存:值以
WeakReference 持有,对象被 GC 回收后自动清理键;
支持可选 TTL(默认不过期)与容量上限(0 表示无上限),参考 Hutool 的 WeakCache 设计。
所有操作线程安全(synchronized),可安全用于虚拟线程高并发场景。
值对象仅被本缓存弱引用时,JVM 可在任意时刻回收,读取时返回 null 并自动移除。
- Since:
- 1.10.0
- Author:
- suretool
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidclear()清空缓存。booleancontainsKey(K key) 是否包含键(已过期或已回收视为不存在)。读取缓存值;已过期或已被 GC 回收返回null并移除。int容量上限。long默认 TTL(毫秒),<=0 表示不过期。booleanisEmpty()是否为空。写入缓存(使用默认 TTL)。写入缓存并指定 TTL。移除缓存项。intsize()缓存项数量(含待清理的已回收项,实际读取时自动收敛)。
-
Constructor Details
-
WeakCache
public WeakCache()创建弱引用缓存:无容量上限、默认不过期。 -
WeakCache
public WeakCache(long defaultTimeout) 创建弱引用缓存:无容量上限、指定默认 TTL。- Parameters:
defaultTimeout- 默认存活时间(毫秒),<=0 表示不过期
-
WeakCache
public WeakCache(int capacity, long defaultTimeout) 创建弱引用缓存。- Parameters:
capacity- 容量上限,<=0 表示无上限;达到上限时优先清理已回收/过期项,仍超则按写入顺序淘汰defaultTimeout- 默认存活时间(毫秒),<=0 表示不过期
-
-
Method Details
-
get
-
put
-
put
-
remove
-
clear
-
size
-
containsKey
是否包含键(已过期或已回收视为不存在)。- Specified by:
containsKeyin interfaceCache<K,V> - Parameters:
key- 键- Returns:
- 是否包含
-
isEmpty
-
getCapacity
public int getCapacity()容量上限。- Returns:
- 容量上限,0 表示无上限
-
getDefaultTimeout
public long getDefaultTimeout()默认 TTL(毫秒),<=0 表示不过期。- Returns:
- 默认 TTL
-