Ehcache（02）——ehcache.xml配置简介

ehcache.xml简介

 

       ehcache.xml文件是用来定义Ehcache的配置信息的，更准确的来说它是定义CacheManager的配置信息的。根据之前我们在《Ehcache简介》一文中对CacheManager的介绍我们知道一切Ehcache的应用都是从CacheManager开始的。在不指定配置信息参数创建CacheManager时，CacheManager将首先在类路径的根目录下寻找一个叫ehcache.xml的文件作为CacheManager的配置文件。如果不存在这样的文件则将使用封装在ehcache jar包中的ehcahce-failsafe.xml文件作为创建CacheManager的默认配置信息。除了使用Configuration作为参数外，使用其它参数构造CacheManager都是基于xml格式的配置信息的。当我们使用xml配置文件作为CacheManager的配置信息时，我们的文件名不一定叫ehcache.xml，这里只是把ehcache.xml文件作为这一类文件的一个代表，它们拥有共同的文档结构。本文将对ehcache.xml做一个简要的介绍，主要介绍常用的配置项。

1       ehcache元素

       首先我们的ehcache.xml文件必须遵守Ehcache的Xml Schema的定义，我们可以直接使用在线的http://ehcache.org/ehcache.xsd，也可以直接从该地址把ehcache.xsd文件下载到本地。ehcache.xml文件的根元素必须是ehcache，一个ehcache元素就相当于一个CacheManager，我们在ehcache元素上指定的属性以及在ehcache元素下定义的子元素都是针对于当前CacheManager的，比如我们在ehcache元素下定义了一个cache元素，那就代表我们所定义的CacheManager中有这么一个Cache存在。ehcache元素上的属性都是可选的，我们可以在ehcache元素上指定ehcache.xml文件所遵循的schema所在的位置，如：

Xml代码  

1. <ehcache xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
2.    xsi:noNamespaceSchemaLocation="http://ehcache.org/ehcache.xsd">  
3.    
4. </ehcache>  

 

 

1.1     可选属性

       除了指定ehcache.xml文件所遵循的schema之外，我们的ehcache元素还可以指定很多的属性，主要有如下这些。

       name:指定当前CacheManager的名称。

       dynamicConfig：boolean类型。表示是否可以动态的更新配置，默认为true。当设置为false的时候，我们在运行期通过CacheManager的Configuration来改变配置信息时将不会发生作用。使用代码进行配置时我们可以通过Configuration对象的dynamicConfig(boolean dynamicConfig)方法来指定该配置。

       maxBytesLocalDisk：在CacheManager级别指定能够使用的本地磁盘的最大容量。当指定了该属性后隐式的使所有Cache的overflowToDisk变为true，如需关闭则需要在对应的Cache上设置overflowToDisk为false。

       maxBytesLocalHeap：在CacheManager级别指定能够使用的堆内存的最大容量。

       maxBytesLocalOffHeap：在CacheManager级别指定能够使用的非堆内存的最大容量。当指定了该属性后会隐式的使所有