Ehcache学习(1)

• 参考文档：

部分都是网络上查询的资料，很多，不列举了。

EHCache 简介：

http://apps.hi.baidu.com/share/detail/7491847

http://wangjicn.cn/data/read/9082403332378.html

http://blog.csdn.net/mgoann/archive/2009/04/16/4083179.aspx

http://yuanyong.javaeye.com/blog/691499

Spring 整合 EHCache ：

http://wangjicn.cn/data/read/909291257438.html

http://www.yybean.com/ehcache-getting-started-series-5-a-distributed-cache-clus

ter-environment-configuration

http://zhyt710.javaeye.com/blog/333213

http://tech.ddvip.com/2010-04/1270187299149502.html

http://blog.csdn.net/goodboylllll/archive/2010/04/01/5442329.aspx

 

• 术语及缩写解释

EHCache:EHCache 是一个快速的、轻量级的、易于使用的、进程内的缓存。它支持 read-only 和 read/write 缓存，内存和磁盘缓存。是一个非常轻量级的缓存实现，而且从 1.2 之后就支持了集群，即分布式。

• 背景

系统缓存是位于应用程序与物理数据源之间，用于临时存放复制数据的内存区域，目的是为了减少应用程序对物理数据源访问的次数，从而提高应用程序的运行性能. 缓存设想内存是有限的，缓存的时效性也是有限的，所以可以设定内存数量的大小，可以执行失效算法，可以在内存满了的时候，按照最少访问等算法将缓存直接移除或切换到硬盘上。

Ehcache 从 Hibernate 发展而来，逐渐涵盖了 Cahce 界的全部功能,是目前发展势头最好的一个项目。具有快速,简单,低消耗，依赖性小，扩展性强,支持对象或序列化缓存，支持缓存或元素的失效，提供 LRU、LFU 和 FIFO 缓存策略，支持内存缓存和磁盘缓存，分布式缓存机制等等特点。

Cache 存储方式　：内存或磁盘。

官方网站 ： http://ehcache.sourceforge.net/

 

• 主要特性

1.          快速 .

2.          简单 .

3.          多种缓存策略

4.          缓存数据有两级：内存和磁盘，因此无需担心容量问题

5.          缓存数据会在虚拟机重启的过程中写入磁盘

6.          可以通过 RMI 、可插入 API 等方式进行分布式缓存

7.          具有缓存和缓存管理器的侦听接口

8.          支持多缓存管理器实例，以及一个实例的多个缓存区域

9.          提供 Hibernate 的缓存实现

• Ehcache 缓存配置

Cache 的配置很灵活，官方提供的Cache 配置方式有好几种。你可以通过声明配置、在xml 中配置、在程序里配置或者调用构造方法时传入不同的参数，具体的Cache 的获取后续讲到。你可以将Cache 的配置从代码中剥离出来，也可以在使用运行时配置，所谓的运行时配置无非也就是在代码中配置。以下是运行时配置的好处：

Ø   在同一个地方配置所有的Cache ，这样很容易管理Cache 的内存和磁盘消耗。

Ø   发布时可更改Cache 配置。

Ø   可再安装阶段就检查出配置错误信息，而避免了运行时错误。

本文将会对ehcache.xml 配置文件进行详细的阐述。如果你调用了CacheManager 默认构造方法去创建CacheManager 的实例，此方法会到classpath 中找ehcache.xml 文件，否则它会到类路径下找ehcache-failsafe.xml 文件。而ehcache-failsafe.xml 被包含在jar 包中，所有它肯定能找的到。

ehcache-failsafe.xml 提供了一个非常简单的默认配置，这样可以使用户在没有创建ehcache.xml 的情况下使用Ehcache 。不过这样做Ehcache 会提醒用户创建一个正确的Ehcache 配置。

ehcache.xml 片段：

<ehcache>
    <diskStore path="java.io.tmpdir"/>
    <defaultCache
            maxElementsInMemory="10000"
            eternal="false"
            timeToIdleSeconds="120"
            timeToLiveSeconds="120"
            overflowToDisk="true"
            maxElementsOnDisk="10000000"
            diskPersistent="false"
            diskExpiryThreadIntervalSeconds="120"
            memoryStoreEvictionPolicy="LRU"
            />
</ehcache> 

 

在Ehcache-1.6 之前的版本，只支持ASCII 编码的ehcache.xml 配置文件。在Ehcach-1.6 之后版本中，支持UTF8 编码的ehcache.xml 配置文件。因为向后兼容，所有采用ASCII 编码的配置文件完全没有必要转换为UTF8 。一个CacheManager 必须要有一个XML 配置。由于磁盘路径或是监听端口，多个CacheManager 使用同一个配置文件时会出现错误。下面是ehcache.xml 具体实例以及配置指南

<ehcache xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance

l   CacheManager 配置

DmulticastGroupPort=4446 ，这样可以配置监听端口。

l   DiskStore 配置

如果你使用的DiskStore （磁盘缓存），你必须要配置DiskStore 配置项。如果不配置，Ehcache 将会使用java.io.tmpdir 。diskStroe 的“path” 属性是用来配置磁盘缓存使用的物理路径的，Ehcache 磁盘缓存使用的文件后缀名是.data 和.index 。

<disStore path=”java.io.tmpdir”/>

l   CacheManagerEventListener 配置

我们通过CacheManagerEventListenerFactory 可以实例化一个CacheManagerPeerProvider ，当我们从CacheManager 中added 和removed Cache 时，将通知CacheManagerPeerProvider ，这样一来，我们就可以很方面的对CacheManager 中的Cache 做一些统计。

注册到CacheManager 的事件监听类名有： adding a Cache 和removing a Cache <cacheManagerEventListenerFacotory class=”” properties=””/>

l   CacheManagerPeerProvider 配置

在集群中CacheManager 配置CacheManagerPeerProviderFactory 创建CacheManagerPeerProvider 。具体的实例如下：

 

<cacheManagerPeerProviderFactoryclass="net.sf.ehcache.distribution. RMICacheManagerPeerProviderFactory"

properties="peerDiscovery=manual, rmiUrls=//server1:40000/sampleCache1|//server2:40000/sampleCache1| //server1:40000/sampleCache2|//server2:40000/sampleCache2"

propertySeparator="," />

l  CacheManagerPeerListener配置

CacheManagerPeerListener配置是用来监听集群中缓存消息的分发的。
<cacheManagerPeerListenerFactory
    class="net.sf.ehcache.distribution.RMICacheManagerPeerListenerFactory"
    properties="hostName=fully_qualified_hostname_or_ip,
                port=40001,
               socketTimeoutMillis=120000"
                propertySeparator="," /> 

 

l   Cache 配置

Ø   name ：Cache 的唯一标识

Ø   maxElementsInMemory ：内存中最大缓存对象数。

Ø   maxElementsOnDisk ：磁盘中最大缓存对象数，若是0 表示无穷大。

Ø   eternal ：Element 是否永久有效，一但设置了，timeout 将不起作用。

Ø   overflowToDisk ：配置此属性，当内存中Element 数量达到maxElementsInMemory 时，Ehcache 将会Element 写到磁盘中。

Ø   timeToIdleSeconds ：设置Element 在失效前的允许闲置时间。仅当element 不是永久有效时使用，可选属性，默认值是0 ，也就是可闲置时间无穷大。

Ø   timeToLiveSeconds ：设置Element 在失效前允许存活时间。最大时间介于创建时间和失效时间之间。仅当element 不是永久有效时使用，默认是0. ，也就是element 存活时间无穷大。

Ø   diskPersistent ：是否缓存虚拟机重启期数据。（这个虚拟机是指什么虚拟机一直没看明白是什么, 有高人还希望能指点一二）。

Ø   diskExpiryThreadIntervalSeconds ：磁盘失效线程运行时间间隔，默认是120 秒。

Ø   diskSpoolBufferSizeMB ：这个参数设置DiskStore （磁盘缓存）的缓存区大小。默认是30MB 。每个Cache 都应该有自己的一个缓冲区。

Ø   memoryStoreEvictionPolicy ：当达到maxElementsInMemory 限制时，Ehcache 将会根据指定的策略去清理内存。默认策略是LRU （最近最少使用）。你可以设置为FIFO （先进先出）或是LFU （较少使用）。这里比较遗憾，Ehcache 并没有提供一个用户定制策略的接口，仅仅支持三种指定策略，感觉做的不够理想。

Ø   Cache Exception Handling 配置

<cacheExceptionHandlerFactory class="com.example.ExampleExceptionHandlerFactory"   properties="logLevel=FINE"/>

 

总结：

这里只对通用缓存的配置做了详细的阐述，至于RMI 缓存和集群缓存可以参考这里。

下面给出几个配置示例：

Ø   Ehcache 默认Cache 配置

<defaultCache
        maxElementsInMemory="10000"
        eternal="false"
        timeToIdleSeconds="120"
        timeToLiveSeconds="120"
        overflowToDisk="true"
        diskSpoolBufferSizeMB="30"
        maxElementsOnDisk="10000000"
        diskPersistent="false"
        diskExpiryThreadIntervalSeconds="120"
        memoryStoreEvictionPolicy="LRU"
        /> 

 Ø   SampleCache1 配置

 

简单配置，在ehcache.xml 文件中有此配置，在使用Ehcache 前最好将其删除掉，自己配置。
缓存名sampleCache1 ，内存中最多可缓存10000 个Element ，其中的element 会在闲置5 分钟或是存活10 分钟之后失效。
超过10000element 时，element 将会输出到磁盘中，输出路径是java.io.tmpdir 。

 

<cache name="sampleCache1"
       maxElementsInMemory="10000"
       maxElementsOnDisk="1000"
       eternal="false"
       overflowToDisk="true"
       diskSpoolBufferSizeMB="20"
       timeToIdleSeconds="300"
       timeToLiveSeconds="600"
       memoryStoreEvictionPolicy="LFU"
        /> 

 

Ø   SampleCache2 配置

 

Cache 名为SampleCache2 ，内存中最多可以缓存1000 个element ，超出1000 不能输出到磁盘中。缓存是永久有效的。

<cache name="sampleCache2"
       maxElementsInMemory="1000"
       eternal="true"
       overflowToDisk="false"
       memoryStoreEvictionPolicy="FIFO"
        /> 

 

Ø   SampleCache3 配置

 

Cache 名为SampleCache3 。可缓存到磁盘。磁盘缓存将会缓存虚拟机重启期的数据。磁盘缓存失效线程运行间隔时间是10 分钟。

 

<cache name="sampleCache3"
       maxElementsInMemory="500"
       eternal="false"
       overflowToDisk="true"
       timeToIdleSeconds="300"
       timeToLiveSeconds="600"
       diskPersistent="true"
       diskExpiryThreadIntervalSeconds="1"
       memoryStoreEvictionPolicy="LFU"
        /> 

 

Ø   sampleDistributedCache1 配置
Cache 名为sampleDistributedCache1 。

<cache name="sampleDistributedCache1"
       maxElementsInMemory="10"
       eternal="false"
       timeToIdleSeconds="100"
       timeToLiveSeconds="100"
       overflowToDisk="false">
    <cacheEventListenerFactory
            class="net.sf.ehcache.distribution.RMICacheReplicatorFactory"/>
    <bootstrapCacheLoaderFactory
            class="net.sf.ehcache.distribution.RMIBootstrapCacheLoaderFactory"/>
</cache> 

 

 

Ø   sampleDistributedCache2 配置

 

<cache name="sampleDistributedCache2"
       maxElementsInMemory="10"
       eternal="false"
       timeToIdleSeconds="100"
       timeToLiveSeconds="100"

       overflowToDisk="false">

    <cacheEventListenerFactory
            class="net.sf.ehcache.distribution.RMICacheReplicatorFactory"
            properties="replicateAsynchronously=false, replicatePuts=false,
                        replicateUpdates=true, replicateUpdatesViaCopy=true,
                       replicateRemovals=false"/>

</cache> 

 

Ø   sampleDistributedCache3 配置

 

<!--
Sample distributed cache named sampleDistributedCache3.
This cache replicates using defaults except that the asynchronous replication
interval is set to 200ms.
-->
<cache name="sampleDistributedCache3"
       maxElementsInMemory="10"
       eternal="false"
       timeToIdleSeconds="100"
       timeToLiveSeconds="100"
       overflowToDisk="false">
    <cacheEventListenerFactory
            class="net.sf.ehcache.distribution.RMICacheReplicatorFactory"
            properties="asynchronousReplicationIntervalMillis=200"/>
</cache>