ehcache.docx

1、ehcacheEhcache缓存配置文章分类:Java编程 简介 Cache的配置很灵活，官方提供的Cache配置方式有好几种。你可以通过声明配置、在xml中配置、在程序里配置或者调用构造方法时传入不同的参数。 你可以将Cache的配置从代码中剥离出来，也可以在使用运行时配置，所谓的运行时配置无非也就是在代码中配置。以下是运行时配置的好处： 在同一个地方配置所有的Cache，这样很容易管理Cache的内存和磁盘消耗。 发布时可更改Cache配置。 可再安装阶段就检查出配置错误信息，而避免了运行时错误。 本文将会对ehcache.xml配置文件进行详细的阐述。在配置的时可以拷贝一个现有的ehca

2、che.xml，如果没有请点击这里去下载。 ehcache-failsafe.xml 如果你调用了CacheManager默认构造方法去创建CacheManager的实例，此方法会到classpath中找ehcache.xml文件，否则它会到类路径下找ehcache-failsafe.xml文件。而ehcache-failsafe.xml被包含在jar包中，所有它肯定能找的到。 ehcache-failsafe.xml提供了一个非常简单的默认配置，这样可以使用户在没有创建ehcache.xml的情况下使用Ehcache。 不过这样做Ehcache会提醒用户创建一个正确的Ehcache配置。 e

3、hcache.xml片段： ehcache.xml和其他配置文件 在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/XMLSche

4、ma-instance CacheManager配置 DmulticastGroupPort=4446，这样可以配置监听端口。 DiskStore配置 如果你使用的DiskStore（磁盘缓存），你必须要配置DiskStore配置项。如果不配置，Ehcache将会使用java.io.tmpdir。 diskStroe的“path”属性是用来配置磁盘缓存使用的物理路径的，Ehcache磁盘缓存使用的文件后缀名是.data和.index。 CacheManagerEventListener配置 我们通过CacheManagerEventListenerFactory可以实例化一个CacheMana

5、gerPeerProvider，当我们从CacheManager中added和removed Cache时，将通知CacheManagerPeerProvider，这样一来，我们就可以很方面的对CacheManager中的Cache做一些统计。 注册到CacheManager的事件监听类名有： adding a Cache和removing a Cache CacheManagerPeerProvider配置 在集群中CacheManager配置CacheManagerPeerProviderFactory创建CacheManagerPeerProvider。具体的实例如下： CacheMan

6、agerPeerListener配置 CacheManagerPeerListener配置是用来监听集群中缓存消息的分发的。 Cache配置 name：Cache的唯一标识 maxElementsInMemory：内存中最大缓存对象数。 maxElementsOnDisk：磁盘中最大缓存对象数，若是0表示无穷大。 eternal：Element是否永久有效，一但设置了，timeout将不起作用。 overflowToDisk：配置此属性，当内存中Element数量达到maxElementsInMemory时，Ehcache将会Element写到磁盘中。 timeToIdleSeconds：设置

7、Element在失效前的允许闲置时间。仅当element不是永久有效时使用，可选属性，默认值是0，也就是可闲置时间无穷大。 timeToLiveSeconds：设置Element在失效前允许存活时间。最大时间介于创建时间和失效时间之间。仅当element不是永久有效时使用，默认是0.，也就是element存活时间无穷大。 diskPersistent：是否缓存虚拟机重启期数据。（这个虚拟机是指什么虚拟机一直没看明白是什么,有高人还希望能指点一二）。 diskExpiryThreadIntervalSeconds：磁盘失效线程运行时间间隔，默认是120秒。 diskSpoolBufferSize

8、MB：这个参数设置DiskStore（磁盘缓存）的缓存区大小。默认是30MB。每个Cache都应该有自己的一个缓冲区。 memoryStoreEvictionPolicy：当达到maxElementsInMemory限制时，Ehcache将会根据指定的策略去清理内存。默认策略是LRU（最近最少使用）。你可以设置为FIFO（先进先出）或是LFU（较少使用）。这里比较遗憾，Ehcache并没有提供一个用户定制策略的接口，仅仅支持三种指定策略，感觉做的不够理想。 Cache Exception Handling配置 总结 这里只对通用缓存的配置做了详细的阐述，至于RMI缓存和集群缓存可以参考这里。

9、下面给出几个配置示例： Ehcache默认Cache配置 SampleCache1配置 简单配置，在ehcache.xml文件中有此配置，在使用Ehcache前最好将其删除掉，自己配置。 缓存名sampleCache1，内存中最多可缓存10000个Element，其中的element会在闲置5分钟或是存活10分钟之后失效。 超过10000element时，element将会输出到磁盘中，输出路径是java.io.tmpdir。 SampleCache2配置 Cache名为SampleCache2，内存中最多可以缓存1000个element，超出1000不能输出到磁盘中。缓存是永久有效的。 Sa

10、mpleCache3配置 Cache名为SampleCache3。可缓存到磁盘。磁盘缓存将会缓存虚拟机重启期的数据。磁盘缓存失效线程运行间隔时间是10分钟。 sampleDistributedCache1配置 Cache名为sampleDistributedCache1。 sampleDistributedCache2配置 sampleDistributedCache3配置 EhcacheRecipes and Code SamplesThe Recipes and Code Samples page contains recipes - short concise examples for

11、specific use cases - and a set of code samples that will help you get started with Ehcache.If you have a suggestion or an idea for a recipe or more code samples, please tell us about it using the mailing list or forums.RecipesRecipeDescriptionWeb Page and Fragment CachingHow to use inluded Servlet F

12、ilters to Cache Web Page and Web Page FragmentsData Freshness and ExpirationHow to maintain cache freshness by configuring TTL and data expiration properlyEnable Terracotta ProgrammaticallyHow to enable Terracotta support for Ehcache programmaticallyCaching Empty ValuesWhy caching empty values can b

13、e desirable to deflect load from the databaseDatabase OverloadWhen many readers simultaneously request the same data element it is called the Thundering Herd problem. How to prevent it in a single jvm or clustered configurationCaching methods with Spring AnnotationsAdding caching to methods using Eh

14、cache Annotations for Spring projectCache WrapperA simple class to make accessing Ehcache easier for simple use casesCode Samples Using the CacheManager o Singleton versus Instance o Ways of loading Cache Configuration o Adding and Removing Caches Programmatically o Shutdown the CacheManager Creatin

15、g Caches Programmatically o Creating a new cache from defaults o Creating a new cache with custom parameters Using Caches o Obtaining a reference to a Cache o Performing CRUD operations o Disk Persistence on demand o Obtaining Cache Sizes o Obtaining Statistics of Cache Hits and Misses o Dynamically

16、 Modifying Cache Configurations o JTA Using Distributed Caches o Terracotta Example Cache Statistics and Monitoring o Registering CacheStatistics in an MBeanServer More examples o JCache Examples o Cache Server Examples o Browse the JUnit TestsUsing the CacheManagerAll usages of Ehcache start with t

17、he creation of a CacheManager.Singleton versus InstanceAs of ehcache-1.2, Ehcache CacheManagers can be created as either singletons (use the create factory method) or instances (use new).Create a singleton CacheManager using defaults, then list caches.CacheManager.create();String cacheNames = CacheM

18、anager.getInstance().getCacheNames();Create a CacheManager instance using defaults, then list caches. CacheManager manager = new CacheManager(); String cacheNames = manager.getCacheNames();Create two CacheManagers, each with a different configuration, and list the caches in each. CacheManager manager1 = new CacheManager(src/config/ehcache1.xml); CacheManager manager2 = new CacheManager(src/config/ehcache2.xml); String cacheNamesForManager1 = manager1.getCacheNames(); String cacheNamesFo