当前位置：首页 > news >正文

Hutool 的 `TimedCache` 到期会自动清理吗？ ——————hutool cache的“惰性清理“和“定期清理“

news 2026/6/30 1:54:05

核心清理机制

1.惰性清理（Lazy Eviction）

TimedCache<String, Object> cache = new TimedCache<>(1000); // 默认过期时间1秒 cache.put("key1", "value1"); // 在get时检查是否过期 Object value = cache.get("key1"); // 如果已过期，返回null并从map中移除

每次调用get()或containsKey()时，会检查该键是否过期，如果过期则移除。

2.定期清理（Schedule Prune）

TimedCache<String, Object> cache = new TimedCache<>(1000); cache.schedulePrune(1000); // 启动定时清理，每1000ms执行一次

通过调用schedulePrune()方法启动定时清理任务，定期扫描并移除过期项。

回到顶部

🔧 使用示例

示例1：基本使用（不自动清理）

import cn.hutool.cache.impl.TimedCache; public class TimedCacheExample1 { public static void main(String[] args) throws InterruptedException { // 创建缓存，默认过期时间1000ms TimedCache<String, String> cache = new TimedCache<>(1000); // 放入数据 cache.put("key1", "value1"); // 立即获取 System.out.println("立即获取：" + cache.get("key1")); // 输出: value1 // 等待1.1秒 Thread.sleep(1100); // 过期后获取 System.out.println("1.1秒后获取：" + cache.get("key1")); // 输出: null // 注意：此时key1会从map中移除 // 检查大小 System.out.println("缓存大小：" + cache.size()); // 输出: 0 } }

示例2：启动定时清理

import cn.hutool.cache.impl.TimedCache; public class TimedCacheExample2 { public static void main(String[] args) throws InterruptedException { // 创建缓存，默认过期时间1000ms TimedCache<String, String> cache = new TimedCache<>(1000); // 启动定时清理，每500ms执行一次 cache.schedulePrune(500); cache.put("key1", "value1"); cache.put("key2", "value2", 2000); // 单独设置过期时间2000ms System.out.println("初始大小：" + cache.size()); // 输出: 2 Thread.sleep(1100); System.out.println("1.1秒后大小：" + cache.size()); // 输出: 1（key1被清理） Thread.sleep(1000); System.out.println("2.1秒后大小：" + cache.size()); // 输出: 0（key2被清理） // 关闭定时清理 cache.cancelPruneSchedule(); } }

回到顶部

⚡ 清理时机总结

清理类型	触发条件	清理范围	是否立即生效
惰性清理	调用`get()`、`containsKey()`等方法	只检查被访问的key	是
定时清理	定时任务触发（需手动调用`schedulePrune()`）	所有过期key	是
容量清理	达到缓存容量上限	最近最少使用的过期项	是

回到顶部

📊 源码解析

查看TimedCache源码的关键方法：

1.检查过期并移除的方法

// 在get操作时会调用 public V get(K key, boolean isUpdateLastAccess) { CacheObj<K, V> co = getWithoutLock(key); if (co == null) { missCount.increment(); return null; } // 检查是否过期 if (co.isExpired()) { // 过期则移除 remove(key, true); missCount.increment(); return null; } // ... 返回缓存值 }

2.定时清理任务

public void schedulePrune(long delay) { this.pruneTimer.schedule(new TimerTask() { @Override public void run() { pruneCache(); // 执行清理 } }, delay, delay); }

回到顶部

💡 使用建议

1.根据场景选择清理策略

// 场景1：低频率访问，使用惰性清理即可 TimedCache<String, Object> cache1 = new TimedCache<>(5000); // 场景2：高频率访问，需要定时清理避免内存泄漏 TimedCache<String, Object> cache2 = new TimedCache<>(5000); cache2.schedulePrune(1000); // 每1秒清理一次 // 场景3：需要严格内存控制 TimedCache<String, Object> cache3 = new TimedCache<>(5000, 1000); // 容量限制1000 cache3.schedulePrune(500);

2.合理设置过期时间

// 为不同数据设置不同过期时间 TimedCache<String, Object> cache = new TimedCache<>(); // 默认过期时间5秒 cache.setDefaultTimeout(5000); // 特定key设置特定过期时间 cache.put("session_token", "abc123", 30 * 60 * 1000); // 30分钟 cache.put("captcha", "1234", 5 * 60 * 1000); // 5分钟 cache.put("page_cache", "<html>...</html>", 1000); // 1秒

3.监听器支持

TimedCache<String, Object> cache = new TimedCache<>(1000); cache.setListener(new CacheListener<String, Object>() { @Override public void onRemove(String key, Object value) { System.out.println("Key被移除：" + key + "，值：" + value); } });

回到顶部