Ehcache3 迁移指南：从2.x到3.x的XML配置变更解析

概述

Ehcache作为Java生态中广泛使用的缓存解决方案，在3.x版本中对架构进行了重大重构。本文将详细解析从Ehcache 2.x迁移到3.x时XML配置文件的变更要点，帮助开发者顺利完成迁移工作。

核心配置变更对比

1. 基础结构变化

Ehcache 3.x的XML配置采用了全新的schema定义。最显著的变化是<cache>元素现在使用alias属性替代了原来的name属性：

<!-- 2.x版本 -->
<cache name="cache_name" .../>

<!-- 3.x版本 -->
<cache alias="cache_name">
  ...
</cache>

2. 内存管理配置

在Ehcache 2.x中，内存配置相对复杂，涉及多个属性：

<!-- 2.x版本 -->
<cache maxElementsInMemory="500" 
       memoryStoreEvictionPolicy="LRU" 
       overflowToDisk="false"/>

在3.x中简化为<resources>元素：

<!-- 3.x版本 -->
<cache alias="cache_name">
  <resources>
    <heap unit="entries">500</heap>
  </resources>
</cache>

重要变更点：

• maxElementsInMemory被<heap>元素替代
• memoryStoreEvictionPolicy在3.x中不可配置（内部采用优化算法）
• overflowToDisk不再需要显式声明，只需配置实际需要的存储层级

3. 过期策略调整

Ehcache 2.x支持TTL(Time-To-Live)和TTI(Time-To-Idle)两种过期策略：

<!-- 2.x版本 -->
<cache timeToLiveSeconds="1200" 
       timeToIdleSeconds="1200"
       eternal="false"/>

在3.x中简化为：

<!-- 3.x版本 -->
<cache alias="cache_name">
  <expiry>
    <ttl unit="minutes">20</ttl>
  </expiry>
</cache>

重要变更点：

• eternal属性被移除，不配置<expiry>即表示永不过期
• TTI策略在3.x中被视为不推荐使用
• 时间单位更加灵活，支持unit属性指定

架构变化带来的编程模型调整

Ehcache 3.x采用了JSR-107(JCache)标准，这导致了与Spring集成方式的变化。2.x中直接使用EhCacheCacheManager的方式在3.x中需要调整为：

@Bean
public CacheManager ehCacheManager() throws URISyntaxException {
    ClassLoader classLoader = getClass().getClassLoader();
    URI ehcacheURI = Objects.requireNonNull(classLoader.getResource("ehcache.xml")).toURI();
    return new JCacheCacheManager(
        Caching.getCachingProvider(EhcacheCachingProvider.class.getName())
            .getCacheManager(ehcacheURI, classLoader));
}

这种变化虽然增加了少量代码，但带来了更好的标准化支持，使得Ehcache可以与其他JCache实现更无缝地协作。

迁移建议

1. 逐条映射配置：按照本文提供的对照表，将每个2.x配置项映射到3.x格式

2. 测试验证：特别注意过期策略的变化对业务逻辑的影响

3. 性能调优：由于3.x的内部实现有重大改进，建议在迁移后进行性能测试

4. 多级缓存：考虑利用3.x更灵活的存储层级配置优化缓存策略

总结

Ehcache 3.x通过简化的配置模型和遵循JCache标准，提供了更现代、更灵活的缓存解决方案。虽然迁移过程需要一定的适配工作，但最终将获得更好的性能、更标准化的接口和更简洁的配置方式。理解核心配置项的变更关系是顺利完成迁移的关键。