Ehcache3配置使用

Posted 2020-11-27 woetu

Ehcache3配置方式与Ehcache2的配置方式区别很大！

缓存管理器只有全局状态下其他地方才能根据名称拿到缓存，也就是只有保证在同一个缓存管理器下才能拿到指定缓存

两种配置方式可同时使用

xml配置方式

• http://www.ehcache.org/documentation/3.8/xml.html

<config xmlns:xsi=‘http://www.w3.org/2001/XMLSchema-instance‘
        xmlns=‘http://www.ehcache.org/v3‘
        xsi:schemaLocation="http://www.ehcache.org/v3 http://www.ehcache.org/schema/ehcache-core.xsd">

    <!--  http://www.ehcache.org/documentation/3.8/xml.html  -->

    <!--指定缓存持久化目录-->
    <persistence directory="${java.io.tmpdir}/ehcache-data"/>

    <!-- 1、声明一个名为foo的Cache-->
    <cache alias="foo">
        <!--2、foo的键值对被声明为字符串类型，如果没有指明，默认是Object类型。-->
        <key-type>java.lang.String</key-type>
        <value-type>java.lang.String</value-type>
        <resources>
            <!--3、foo被声明在堆上保存多达2,000个条目。-->
            <heap unit="entries">2000</heap>
            <!--4、在它开始被驱逐之前，还有多达500 MB的外堆内存-->
            <offheap unit="MB">500</offheap>
        </resources>
    </cache>

    <!-- <cache-template>可以让你创建一个抽象的<cache>配置文件，该配置文件可以进一步的被扩展。-->
    <cache-template name="myDefaults">
        <key-type>java.lang.Long</key-type>
        <value-type>java.lang.String</value-type>
        <!--  org.ehcache.config.ResourceUnit中的属性，声明在堆上保存多达2,000个条目 -->
        <heap unit="entries">200</heap>
    </cache-template>
    <!-- bar是这样的cache，它使用名为myDefaults的<cache-template>，并将其主键覆盖到更广泛的类型-->
    <cache alias="bar" uses-template="myDefaults">
        <key-type>java.lang.Number</key-type>
        <expiry>
            <!-- 通过ttl指定了cache过期时间,java.wechatutil.concurrent.TimeUnit中的属性，这里指定为10秒 -->
            <ttl unit="seconds">10</ttl>
        </expiry>
    </cache>
    <!-- simpleCache是另一个cache，它使用myDefaults配置文件作为其唯一的CacheConfiguration-->
    <cache alias="simpleCache" uses-template="myDefaults"/>


    <cache-template name="stringTemplate">
        <key-type>java.lang.String</key-type>
        <value-type>java.lang.Object</value-type>
        <heap unit="MB">200</heap>
    </cache-template>
    <cache alias="stringCache" uses-template="stringTemplate">
        <value-type>java.lang.String</value-type>
        <expiry>
            <!-- 通过ttl指定了cache过期时间,java.wechatutil.concurrent.TimeUnit中的属性，这里指定为10分钟 -->
            <ttl unit="minutes">10</ttl>
        </expiry>
    </cache>
</config>

SpringBoot配置

# 新版本使用jcache，老版本使用ehcache
spring.cache.jcache.config=classpath:ehcache3.xml

代码配置方式

• 资源池生成器配置持久化

ResourcePoolsBuilder resourcePoolsBuilder = ResourcePoolsBuilder.newResourcePoolsBuilder()
    // 堆内缓存大小
    .heap(heapCacheSize, MemoryUnit.KB)
    // 堆外缓存大小
    .offheap(offHeapCacheSize, MemoryUnit.MB)
    // 文件缓存大小
    .disk(diskCacheSize, MemoryUnit.MB);

• 生成配置

CacheConfigurationBuilder.newCacheConfigurationBuilder(keyType, valueType, resourcePoolsBuilder)
    // 缓存超时时间
    .withExpiry(ExpiryPolicyBuilder.timeToLiveExpiration(withExpiry))
    // 统计对象大小时对象图遍历深度
    .withSizeOfMaxObjectGraph(heapMaxObjectGraph)
    //可缓存的最大对象大小
    .withSizeOfMaxObjectSize(heapMaxObjectSize, MemoryUnit.MB)
    // 添加监听器
    .add(CacheEventListenerConfigurationBuilder.newEventListenerConfiguration(
            new EhCacheEventListener(), EventType.EXPIRED).unordered().asynchronous())
    //最后调用build()返回一个完整的实例，但是该实例并未初始化。
    .build();

• 根据配置创建缓存管理器

CacheManagerBuilder.newCacheManagerBuilder().withCache(cacheName, config).build(true);