ehcache技术详解.md
Ehcache技术详解

一：基本概念

EHCache是一个快速的、轻量级的、易于使用的、进程内的缓存。它支持read-only和read/write缓存，内存和磁盘缓存。是一个非常轻量级的缓存实现，而且从1.2 之后就支持了集群，目前的最新版本是2.8。

1：主要特性

1. 快速、简单
2. 提供LRU、LFU和FIFO 缓存策略
3. 缓存数据有两级：内存和磁盘，因此无需担心容量问题
4. 缓存数据会在虚拟机重启的过程中写入磁盘
5. 支持分布式缓存
6. 支持多缓存管理器实例，以及一个实例的多个缓存区域

   二：部署

   引入

   官网地址：http://www.ehcache.org/
   添加maven依赖
   
   net.sf.ehcache
   ehcache
   2.10.3
   

   配置

   ehcache.xml中的内容如下：
   <?xml version=“1.0” encoding=“UTF-8”?>
   
   
   
   
   maxElementsInMemory=”100”
   eternal=”true”
   overflowToDisk=”true”/>
   maxEntriesLocalHeap=“10000”
   maxEntriesLocalDisk=“1000”
   eternal=“false”
   overflowToDisk=“true”
   diskPersistent=“true”
   diskSpoolBufferSizeMB=“20”
   timeToIdleSeconds=“300”
   timeToLiveSeconds=“600”
   memoryStoreEvictionPolicy=“LFU”
   diskExpiryThreadIntervalSeconds =“120”
   transactionalMode=“off”>
   class=“com.ehcache.EhcacheListenerTest”
   properties=“wxwtestkey=200,wxtestkey2=300”/>
   
   
   
   配置项详解：
   
   此配置项配置的是，磁盘缓存的位置。其中java.io.tmpdir的具体位置可以由java代码，System.getProperty(“java.io.tmpdir”) 来查看。此处的path也可以配置成 user.home，user.dir或用户设定的系统变量指定的路径。
   Cache 元素表示一个一个缓存区域，在ehcache.xml中可以有多个cache,他们之间由name属性来区分。
   maxEntriesLocalHeap=“10000”：表示内存中最大可以存在10000个元素。
   maxEntriesLocalDisk=“1000”：表示磁盘中最大可以存在1000个元素
   eternal=“false”：表示缓存是否持久，false表示不持久可被销毁，true表示一直存在。
   overflowToDisk=”true”：是否保存到磁盘，当内存中的元素溢出时。
   diskPersistent=”true”：是否保存到磁盘，当进程重启时。
   diskSpoolBufferSizeMB=“20”：保存到磁盘的后台线程的缓存为20M，当数据从内存中转到磁盘时，会先将数据转入此缓存，然后由后台线程将数据从缓存中持久化到磁盘。
   timeToIdleSeconds=”300”：表示缓存空闲300s后被销毁。
   timeToLiveSeconds=“600”：表示缓存最长可以存在300s，然后被销毁。
   memoryStoreEvictionPolicy=“LFU”：_Ehcache的三种清空策略，FIFO：先进先出。LFU：一直以来最少被使用的，即缓存的元素有一个hit属性，hit值最小的将会被清出缓存。LRU：最近最少使用的，缓存的元素有一个时间戳，当缓存容量满了，而又需要腾出地方来缓存新的元素的时候，那么现有缓存元素中时间戳离当前时间最远的元素将被清出缓存。
   diskExpiryThreadIntervalSeconds =“120”：检查磁盘上的缓存超期的线程的运行周期为120s。
   transactionalMode=“off”：事务关闭（ehcache中的事务是怎么使用的？）_

   三：使用

   1：类层次结构

   

2：基本用法

使用如下：

1. 获取manager, 如果ehcache.xml不是在src下，可以由create(“config/ehcache.xml”)来指定路径。

CacheManager manager = CacheManager.create();
2、获取缓存区，根据ehcache.xml中配置的cache节点，指定name来获取cache.
Cache cache = manager.getCache(“sampleCache1”);
3、创建key-value形式的元素，存入缓存区，或从缓存区取出。
Element element = new Element(“key1”, “wxwtest”);
cache.put(element);
Element find = cache.get(“key1”);
4、关闭mananger.
manager.shutdown();
另外，Ehcache还提供了监听的机制，在如上的配置文件中：
class=“com.ehcache.EhcacheListenerTest”
properties=“wxwtestkey=200,wxtestkey2=300”/>
其中class是自定义的实现类，继承CacheEventListenerFactory，覆盖createCacheEventListener(Properties props)方法。EhcacheListenerTest代码如下所示：
package com.ehcache;
import java.util.Properties;
import net.sf.ehcache.CacheException;
import net.sf.ehcache.Ehcache;
import net.sf.ehcache.Element;
import net.sf.ehcache.event.CacheEventListener;
import net.sf.ehcache.event.CacheEventListenerFactory;
public class EhcacheListenerTest extends CacheEventListenerFactory
{
\@Override
public CacheEventListener createCacheEventListener(Properties props)
{
System.out.println(“==create listener==”);
for(Object key : props.keySet())
{
System.out.println(key+”=”+props.get(key));
}
return new TestCacheEventListener();
}
class TestCacheEventListener implements CacheEventListener
{
public Object clone()
{
return new TestCacheEventListener();
}
public void dispose()
{
System.out.println(“==dispose”);
}
public void notifyElementEvicted(Ehcache ehcache, Element element)
{
System.out.println(“==notifyElementEvicted”);
}
public void notifyElementExpired(Ehcache ehcache, Element element)
{
System.out.println(“==notifyElementExpired”);
}
public void notifyElementPut(Ehcache ehcache, Element element)
throws CacheException
{
System.out.println(“==notifyElementPut”);
}
public void notifyElementRemoved(Ehcache ehcache, Element element)
throws CacheException
{
System.out.println(“==notifyElementRemoved”);
}
public void notifyElementUpdated(Ehcache ehcache, Element element)
throws CacheException
{
System.out.println(“==notifyElementUpdated”);
}
public void notifyRemoveAll(Ehcache ehcache)
{
System.out.println(“==notifyRemoveAll”);
}
}
}
通过监听，在对cache做操作时，调用相应的监听类方法。
ehcache的基本用法就是这样。根据以上的基本用法，我们就更容易理解以下ehcache的一些复杂应用。
例二：
import net.sf.ehcache.Cache;
import net.sf.ehcache.CacheManager;
import net.sf.ehcache.Element;
public class EhcacheTest {
public static void main(String[] args) {
// 根据ehcache.xml配置文件创建Cache管理器
CacheManager manager=CacheManager.create(“./src/main/resources/ehcache.xml”);
Cache c=manager.getCache(“a”); // 获取指定Cache
Element e=new Element(“java1234”,”屌”); // 实例化一个元素
c.put(e); // 把一个元素添加到Cache中
Element e2=c.get(“java1234”); // 根据Key获取缓存元素
System.out.println(e2);
System.out.println(e2.getObjectValue());
c.flush(); // 刷新缓存
manager.shutdown(); // 关闭缓存管理器
}
}

Ehcache+Mybatis做DAO缓存

1. 在搭建好ehcache和Mybatis的基础上，引入mybatis-ehcache-xxx.jar。
2. 在ehcache.xml中将默认的缓存区配置上，如下：