Ehcache——监听器

监听器

 

       Ehcache中监听器有两种，监听CacheManager的CacheManagerEventListener和监听Cache的CacheEventListener。在Ehcache中，Listener是通过对应的监听器工厂来生产和发生作用的。下面我们将来介绍一下这两种类型的监听器。

 

1       CacheManager监听器

       Ehcache中定义了一个CacheManagerEventListener接口来监听CacheManager的事件。CacheManagerEventListener可以监听的事件有CacheManager添加和移除Cache。其中定义有如下五个方法：

Java代码  

1. public interface CacheManagerEventListener {  
2.    
3.     void init() throws CacheException;  
4.    
5.     Status getStatus();  
6.    
7.     void dispose() throws CacheException;  
8.    
9.     void notifyCacheAdded(String cacheName);  
10.    
11.     void notifyCacheRemoved(String cacheName);  
12.    
13. }  

 

 

l  init方法会在CacheManagerEventListener实现类实例化后被调用，用于初始化CacheManagerEventListener。

l  getStatus方法返回当前CacheManagerEventListener所处的状态，可选值有STATUS_UNINITIALISED、 STATUS_ALIVE和STATUS_SHUTDOWN。

l  dispose方法用于释放资源。

l  notifyCacheAdded方法会在往CacheManager中添加Cache时被调用。

l  notifyCacheRemoved方法会在从CacheManager中移除Cache时被调用。

 

       Ehcache是通过CacheManagerEventListenerFactory来获取当前CacheManager所使用的CacheManagerEventListener的。CacheManagerEventListenerFactory是一个抽象类，其定义如下：

Java代码  

1. public abstract class CacheManagerEventListenerFactory {  
2.    
3.     public abstract CacheManagerEventListener  
4.             createCacheManagerEventListener(CacheManager cacheManager, Properties properties);  
5.    
6. }  

 

 

       在我们自己的CacheManagerEventListenerFactory子类中需要实现其抽象方法createCacheManagerEventListener，在生成对应的CacheManagerEventListener进行返回时我们可以使用当前的CacheManager以及在ehcache.xml文件中定义CacheManagerEventListenerFactory时指定的属性Properties。通过CacheManagerEventListenerFactory我们可以实现为不同的CacheManager使用不同的CacheManagerEventListener。

       有了CacheManagerEventListener和CacheManagerEventListenerFactory之后，我们需要在对应的ehcache.xml文件中通过cacheManagerEventListenerFactory元素来指定当前ehcache.xml文件对应的CacheManager所使用的事件监听器工厂，每一个ehcache.xml文件中最多只能指定一个cacheManagerEventListenerFactory元素。

       cacheManagerEventListenerFactory元素可以指定三个属性：class、properties和propertySeparator。

l  class属性必须指定，表示对应的CacheManagerEventListenerFactory实现类全名。

l  properties属性可选，用来指定CacheManagerEventListenerFactory在创建CacheManagerEventListener时需要使用的属性，里面是键值对的形式，多个属性之间默认用逗号隔开。如“prop1=val1,prop2=val2”。

l  propertySeparator属性可选，用来指定properties属性之间的分隔符。

 

       下面给一个监听CacheManager事件的示例。

       1、实现自己的CacheManagerEventListener。

Java代码  

1. public class MyCacheManagerEventListener implements CacheManagerEventListener {  
2.    
3.    private final CacheManager cacheManager;  
4.     
5.    public MyCacheManagerEventListener(CacheManager cacheManager) {  
6.       this.cacheManager = cacheManager;  
7.    }  
8.     
9.    @Override  
10.    public void init() throws CacheException {  
11.       System.out.println("init.....");  
12.    }  
13.    
14.    @Override  
15.    public Status getStatus() {  
16.       System.out.println("getStatus.....");  
17.       returnnull;  
18.    }  
19.    
20.    @Override  
21.    public void dispose() throws CacheException {  
22.       System.out.println("dispose......");  
23.    }  
24.    
25.    @Override  
26.    public void notifyCacheAdded(String cacheName) {  
27.       System.out.println("cacheAdded......." + cacheName);  
28.       System.out.println(cacheManager.getCache(cacheName));  
29.    }  
30.    
31.    @Override  
32.    public void notifyCacheRemoved(String cacheName) {  
33.       System.out.println("cacheRemoved......" + cacheName);  
34.    }  
35.    
36. }  

 

 

       2、实现自己的CacheManagerEventListenerFactory，根据条件创建对应的CacheManagerEventListener。

Java代码  

1. public class MyCacheManagerEventListenerFactory extends  
2.       CacheManagerEventListenerFactory {  
3.    
4.    @Override  
5.    public CacheManagerEventListener createCacheManagerEventListener(  
6.          CacheManager cacheManager, Properties properties) {  
7.       returnnew MyCacheManagerEventListener(cacheManager);  
8.    }  
9.    
10. }  

 

 

       3、在ehcache.xml文件中通过cacheManagerEventListenerFactory元素指定当前CacheManager所使用的CacheManagerEventListenerFactory为我们自己定义的CacheManagerEventListenerFactory。

Xml代码  

2.    xsi:noNamespaceSchemaLocation="http://ehcache.org/ehcache.xsd"  
3.    maxBytesLocalHeap="100M">  
4.    
5.      
6.     
7.      
8.     
9.      
10.     
11.   

 

 

       针对于上述监听器所进行的测试代码如下所示：

Java代码  

1. @Test  
2. public void testAdd() {  
3.    CacheManager cacheManager = CacheManager.create(this.getClass().getResource("/ehcache-listener.xml"));  
4.    cacheManager.addCache("test1");  
5.    cacheManager.removeCache("test1");  
6. }  

 

 

2       Cache监听器

       Ehcache中定义了一个CacheEventListener接口来监听Cache的事件。其能监听到Cache中元素的添加、删除、更新等。CacheEventListener中主要定义有以下方法：

Java代码  

1. public interface CacheEventListener extends Cloneable {  
2.    
3.     void notifyElementRemoved(Ehcache cache, Element element) throws CacheException;  
4.    
5.     void notifyElementPut(Ehcache cache, Element element) throws CacheException;  
6.    
7.     void notifyElementUpdated(final Ehcache cache, final Element element) throws CacheException;  
8.    
9.     void notifyElementExpired(final Ehcache cache, final Element element);  
10.    
11.     void notifyElementEvicted(final Ehcache cache, final Element element);  
12.    
13.     void notifyRemoveAll(final Ehcache cache);  
14.    
15.     public Object clone() throws CloneNotSupportedException;  
16.    
17.     void dispose();  
18. }  

 

 

l  notifyElementRemoved方法会在往Cache中移除单个元素时被调用，即在调用Cache的remove方法之后被调用。

l  notifyElementPut方法会在往Cache中添加元素时被调用。调用Cache的put方法添加元素时会被阻塞，直到对应的notifyElementPut方法返回之后。

l  notifyElementUpdated方法，当往Cache中put一个已经存在的元素时就会触发CacheEventListener的notifyElementUpdated方法，此时put操作也会处于阻塞状态，直到notifyElementUpdated方法执行完毕。

l  notifyElementExpired方法，当Ehcache检测到Cache中有元素已经过期的时候将调用notifyElementExpired方法。

l  notifyElementEvicted方法将会在元素被驱除的时候调用。

l  notifyRemoveAll方法将在调用Cache的removeAll方法之后被调用。

dispose方法用于释放资源。

 

       那我们在实现自己的CacheEventListener时就需要实现上述所有的方法。Ehcache为我们提供了一个默认的空实现CacheEventListenerAdapter，我们可以在实际应用中继承CacheEventListenerAdapter，然后重写其中的某些方法，以简化我们对CacheEventListener的实现。

 

       跟CacheManagerEventListener一样，CacheEventListener不能单独起作用，它需要通过当前Cache相关联的CacheEventListenerFactory来构建一个当前Cache使用的CacheEventListener。CacheEventListenerFactory是一个抽象类，其中只定义了一个createCacheEventListener方法，该方法接收一个Properties对象作为参数。

       在ehcahce.xml文件中通过cache元素下的子元素cacheEventListenerFactory可以指定当前Cache所使用的CacheEventListenerFactory。其可以指定四个属性：

l  class：指定当前CacheEventListenerFactory对应的Java类全名称。

l  properties：指定在构建CacheEventListenerFactory时需传入的属性键值对，多个属性之间默认用逗号分开，如：“prop1=value1,prop2=value2”。

l  propertySeparator：指定properties中多个属性之间的分隔符。

l  listenFor：表示在集群环境下可以监听到的Cache事件的范围，可选值有local、remote和all。local代表只监听本节点的Cache事件，remote代表只监听其他节点的Cache事件，all代表监听所有的Cache事件。默认是all。

       与CacheManagerEventListenerFactory不同的是一个Cache可以定义多个CacheEventListenerFactory。

 

       下面来看一个使用Cache监听器的例子。

       1、实现一个CacheEventListener。

Java代码  

1. public class MyCacheEventListener implements CacheEventListener {  
2.    
3.    @Override  
4.    public void notifyElementRemoved(Ehcache cache, Element element)  
5.          throws CacheException {  
6.       System.out.println("removed");  
7.    }  
8.    
9.    @Override  
10.    public void notifyElementPut(Ehcache cache, Element element)  
11.          throws CacheException {  
12.       System.out.println("put");  
13.    }  
14.    
15.    @Override  
16.    public void notifyElementUpdated(Ehcache cache, Element element)  
17.          throws CacheException {  
18.       System.out.println("updated");  
19.    }  
20.    
21.    @Override  
22.    public void notifyElementExpired(Ehcache cache, Element element) {  
23.       System.out.println("expired");  
24.    }  
25.    
26.    @Override  
27.    public void notifyElementEvicted(Ehcache cache, Element element) {  
28.       System.out.println("evicted");  
29.    }  
30.    
31.    @Override  
32.    public void notifyRemoveAll(Ehcache cache) {  
33.       System.out.println("removeAll");  
34.    }  
35.    
36.    @Override  
37.    public void dispose() {  
38.    
39.    }  
40.     
41.    public Object clone() throws CloneNotSupportedException {  
42.       thrownew CloneNotSupportedException();  
43.    }  
44.    
45. }  

 

 

       2、实现抽象工厂类CacheEventListenerFactory来生产前面已经定义好的CacheEventListener。

Java代码  

1. public class MyCacheEventListenerFactory extends CacheEventListenerFactory {  
2.    
3.    @Override  
4.    public CacheEventListener createCacheEventListener(Properties properties) {  
5.       returnnew MyCacheEventListener();  
6.    }  
7.    
8. }  

 

 

       3、在ehcache.xml文件中通过cache元素的子元素cacheEventListenerFactory来指定当前Cache使用的CacheEventListenerFactory。

Xml代码  

2.    xsi:noNamespaceSchemaLocation="http://ehcache.org/ehcache.xsd"  
3.    maxBytesLocalHeap="100M">  
4.    
5.      
6.     
7.      
8.         
9.      
10.     
11.      
12.     
13.   

 

 

       经过以上三步我们就完成了对Cache事件的监听。

 

 

 

（注：本文是基于ehcache2.8.1所写）