You need to enable JavaScript to run this app. 如何将CaffeineCacheManager缓存配置改造为异步模式?
优惠活动
大模型
产品
解决方案
定价
更多

如何将CaffeineCacheManager缓存配置改造为异步模式?

Caffeine 缓存改造为异步工作模式的实现方案

核心改造逻辑

原有实现基于同步CaffeineCacheManager,返回的都是阻塞式的同步缓存实例。切换异步模式不需要重构原有业务逻辑,核心是调整缓存实例的创建逻辑,适配Spring的异步缓存抽象,完全复用原有的过期配置、缓存加载器逻辑。

具体改造步骤

  • 调整CacheManager的缓存创建逻辑
    扩展原有CaffeineCacheManager,重写缓存创建方法,将原本同步构建的Cache实例,替换为基于Caffeine原生AsyncCache包装的异步缓存实现,改造后的完整配置代码:

    @Bean
    public CacheManager cacheManager() {
        // 扩展CaffeineCacheManager,重写缓存创建逻辑
        CaffeineCacheManager caffeineCacheManager = new CaffeineCacheManager() {
            @Override
            protected Cache createCaffeineCache(String name) {
                // 调用异步构建方法生成AsyncCache,包装为Spring兼容的异步缓存实例
                AsyncCache<Object, Object> asyncCache = (AsyncCache<Object, Object>) caffeineConfig().buildAsync();
                return new AsyncCaffeineCache(name, asyncCache, cacheLoader());
            }
        };
        // 原有配置逻辑完全保留,无改动
        caffeineCacheManager.setCacheNames(List.of("addresses", "cacheKey"));
        caffeineCacheManager.setCaffeine(caffeineConfig());
        return caffeineCacheManager;
    }
    
    // Caffeine基础配置和原有规则保持一致
    Caffeine<Object, Object> caffeineConfig() {
        return Caffeine.newBuilder()
                .expireAfterAccess(Duration.ofSeconds(5))
                // 可选:替换默认的ForkJoinPool公共线程池为自定义业务线程池
                // .executor(customBizExecutor);
    }
    
    // 缓存加载器逻辑和原有实现完全一致
    public CacheLoader<Object, Object> cacheLoader() {
        return string -> string;
    }
    
  • 适配缓存调用方式
    原有@Autowired注入CacheManager的方式完全保留。异步模式下缓存取值会直接返回CompletableFuture对象,不会阻塞当前线程,典型调用写法:

    Cache targetCache = cacheManager.getCache("cacheKey");
    // 异步获取缓存值,全程无阻塞
    CompletableFuture<ValueWrapper> valueFuture = targetCache.get(123);
    // 链式定义值返回后的处理逻辑
    valueFuture.thenAccept(wrapper -> {
        Object cachedValue = wrapper.get();
        // 业务处理逻辑
    });
    

注意事项

  1. 异步缓存的过期规则、缓存加载逻辑和同步模式完全统一,不需要额外调整参数
  2. 默认使用Caffeine内置的公共线程池执行异步读写,如果需要隔离业务线程,可在Caffeine构建时通过.executor()传入自定义线程池
  3. 异步模式下不会自动阻塞当前线程等待缓存值返回,需要通过CompletableFuture的回调机制处理结果,避免手动调用get()方法阻塞回到同步语义

内容的提问来源于stack exchange,提问作者Ankur Gupta

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.27 01:36:08