EHCache使用(收集ZZ)

[FROM: http://blog.csdn.net/zyl623/archive/2007/02/28/1517465.aspx

http://hi.baidu.com/en_wan/blog/item/20b78c59bfda0a2f2934f0f8.html]

1. //ehcache-1.2 管理器各种建立的方法：
2.    //方法一：
3.      CacheManager manager = new CacheManager();
4.    //方法二：
5.      CacheManager manager = new CacheManager("src/config/ehcache.xml");
6.    //方法三：
7.      URL url = getClass().getResource("/anotherconfigurationname.xml");
8.      CacheManager manager = new CacheManager(url);
9.   // 方法四：
10.      InputStream fis = new FileInputStream(new File("src/config/ehcache.xml").getAbsolutePath());
11.      try {
12.        CacheManager manager = new CacheManager(fis);
13.      } finally {
14.        fis.close();
15.      }
16. //缓存的创建，采用自动的方式
17. CacheManager singletonManager = CacheManager.create();
18. singletonManager.addCache("testCache");
19. Cache test = singletonManager.getCache("testCache");     
21. //或者直接创建Cache
22. CacheManager singletonManager = CacheManager.create();
23. Cache memoryOnlyCache = new Cache("testCache", 5000, false, false, 5, 2);
24. manager.addCache(memoryOnlyCache);
25. Cache test = singletonManager.getCache("testCache");    
27.    //ehcache-1.2 cacheNames 列表的取得；
28.    //方法一：
29.      CacheManager.create();
30.      String[] cacheNames = CacheManager.getInstance().getCacheNames();
31.    //方法二：
32.      CacheManager manager = new CacheManager();
33.      String[] cacheNames = manager.getCacheNames();
34.    //方法三：
35.      CacheManager manager1 = new CacheManager("src/config/ehcache1.xml");
36.      String[] cacheNamesForManager1 = manager1.getCacheNames();
38.   
39. //删除cache
40. CacheManager singletonManager = CacheManager.create();
41. singletonManager.removeCache("sampleCache1");    
43. //在使用ehcache后，需要关闭
44. CacheManager.getInstance().shutdown()  
45.    
46. //caches 的使用
47. Cache cache = manager.getCache("sampleCache1");     
49. //执行crud操作
50. Cache cache = manager.getCache("sampleCache1");
51. Element element = new Element("key1", "value1");
52. cache.put(element);     
54. //update
55. Cache cache = manager.getCache("sampleCache1");
56. cache.put(new Element("key1", "value1");
57.     //This updates the entry for "key1"
58. cache.put(new Element("key1", "value2");     
60. //get Serializable
61. Cache cache = manager.getCache("sampleCache1");
62. Element element = cache.get("key1");
63. Serializable value = element.getValue();     
65. //get non serializable
66. Cache cache = manager.getCache("sampleCache1");
67. Element element = cache.get("key1");
68. Object value = element.getObjectValue();     
70. //remove
71. Cache cache = manager.getCache("sampleCache1");
72. Element element = new Element("key1", "value1"
73. cache.remove("key1");      
75.      //Cache 属性说明：
76.      //  构造函数：
77.        public Cache(java.lang.String name,
78.              int maxElementsInMemory,
79.              boolean overflowToDisk,
80.              boolean eternal,
81.              long timeToLiveSeconds,
82.              long timeToIdleSeconds)
83.        参数说明：
84.         name              - 元素名字。
85.          maxElementsInMemory      - 设定内存中创建对象的最大值。
86.          overflowToDisk         - 设置当内存中缓存达到 maxInMemory 限制时元素是否可写到磁盘上。
87.          eternal   - 设置元素（译注：内存中对象）是否永久驻留。如果是，将忽略超时限制且             元素永不消亡。
88.          timeToIdleSeconds       - 设置某个元素消亡前的停顿时间。
89.                             也就是在一个元素消亡之前，两次访问时间的最大时间间隔值。
90.                             这只能在元素不是永久驻留时有效（译注：如果对象永恒不灭，则
91.                             设置该属性也无用）。
92.                             如果该值是 0 就意味着元素可以停顿无穷长的时间。
93.          timeToLiveSeconds       - 为元素设置消亡前的生存时间。
94.                             也就是一个元素从构建到消亡的最大时间间隔值。
95.                             这只能在元素不是永久驻留时有效。
96. ehcache的默认配置文件名为ehcache.xml，也可以自己指定。配置文件比较的简单，基本上也就是常用的几个元素。

 

1. 配置元素说明：
3. diskStore：配置DiskStore，当需要使用磁盘保存的时候，需要对象实现序列化接口
5.     属性：path 配置文件存储位置，如user.home，user.dir，java.io.tmpdir
7. cacheManagerEventListenerFactory ：指定CacheManagerEventListenerFactory，用于创建CacheManagerPeerProvider
9. 用于提醒当CacheManager中的缓存增加或者删除时。
10.     
11.     属性:class:完整的工厂类名称 
12.          properties:逗号分割的属性
14. 事件包括 增加cache和删除cache
16. cacheManagerPeerProviderFactory:指定CacheManagerPeerProviderFactory，用于创建 CacheManagerPeerProvider，用于在cluster中查找CacheManagers，主要用于机群环境
18.     属性：
19.         class:完整的工厂类名称
20.         properties:逗号分割的属性
22. 默认的配置：
24. <cacheManagerPeerProviderFactory
25.                                 class="net.sf.ehcache.distribution.RMICacheManagerPeerProviderFactory"
26.                                 properties="peerDiscovery=automatic, multicastGroupAddress=230.0.0.1,
27.                                     multicastGroupPort=4446, timeToLive=32"/>
28.        
29. <cacheManagerPeerProviderFactory class=
30.                           "net.sf.ehcache.distribution.RMICacheManagerPeerProviderFactory"
31.                           properties="peerDiscovery=manual,
32. rmiUrls=//server1:40000/sampleCache1|//server2:40000/sampleCache         1//server1:40000/sampleCache2|//server2:40000/sampleCache2"/>     
34. cacheManagerPeerListenerFactory：指定CacheManagerPeerListenerFactory，用于创建CacheManagerPeerListener，监听cluster中的复制信息
35.     属性：
36.         class:完整的工厂类名称
37.         properties:逗号分割的属性
39. 默认配置
40.     <cacheManagerPeerListenerFactory
41.         class="net.sf.ehcache.distribution.RMICacheManagerPeerListenerFactory"
42.         properties="hostName=fully_qualified_hostname_or_ip,
43.                     port=40001,
44.                     socketTimeoutMillis=120000"/>     
45. defaultCache: 默认缓存配置    
46. 必须属性：
47.         name:设置缓存的名称，用于标志缓存,惟一
48.         maxElementsInMemory:在内存中最大的对象数量
49.         maxElementsOnDisk：在DiskStore中的最大对象数量，如为0，则没有限制
50.         eternal：设置元素是否永久的，如果为永久，则timeout忽略
51.         overflowToDisk：是否当memory中的数量达到限制后，保存到Disk
52.     可选的属性：
53.         timeToIdleSeconds：设置元素过期前的空闲时间
54.         timeToLiveSeconds：设置元素过期前的活动时间
55.         diskPersistent：是否disk store在虚拟机启动时持久化。默认为false
56.         diskExpiryThreadIntervalSeconds:运行disk终结线程的时间，默认为120秒
57.         memoryStoreEvictionPolicy：策略关于Eviction
59. 缓存子元素：    cacheEventListenerFactory：注册相应的的缓存监听类，用于处理缓存事件，如put,remove,update,和expire
60.    bootstrapCacheLoaderFactory:指定相应的BootstrapCacheLoader，用于在初始化缓存，以及自动设置。
61. 如下的例子：
63.  <cacheEventListenerFactory class="net.sf.ehcache.distribution.RMICacheReplicatorFactory"
64.          properties="replicateAsynchronously=true,
65.          replicatePuts=true,
66.          replicateUpdates=true,
67.          replicateUpdatesViaCopy=true,
68.          replicateRemovals=true "/>     
69.   
70. <bootstrapCacheLoaderFactory
71.         class="net.sf.ehcache.distribution.RMIBootstrapCacheLoaderFactory"
72.         properties="bootstrapAsynchronously=true, maximumChunkSizeBytes=5000000"/>     
73.   
74.  <defaultCache
75.             maxElementsInMemory="10000"
76.             eternal="false"
77.             timeToIdleSeconds="120"
78.             timeToLiveSeconds="120"
79.             overflowToDisk="true"
80.             maxElementsOnDisk="10000000"
81.             diskPersistent="false"
82.             diskExpiryThreadIntervalSeconds="120"
83.             memoryStoreEvictionPolicy="LRU"
84.             />     
86. <!--cache配置同defaultCache -->
87. <cache name="sampleDistributedCache1"
88.            maxElementsInMemory="10"
89.            eternal="false"
90.            timeToIdleSeconds="100"
91.            timeToLiveSeconds="100"
92.            overflowToDisk="false">
93.         <cacheEventListenerFactory
94.                 class="net.sf.ehcache.distribution.RMICacheReplicatorFactory"/>
95.         <bootstrapCacheLoaderFactory
96.                 class="net.sf.ehcache.distribution.RMIBootstrapCacheLoaderFactory"/>
97.     </cache>