01: /**
02: * JDBM LICENSE v1.00
03: *
04: * Redistribution and use of this software and associated documentation
05: * ("Software"), with or without modification, are permitted provided
06: * that the following conditions are met:
07: *
08: * 1. Redistributions of source code must retain copyright
09: * statements and notices. Redistributions must also contain a
10: * copy of this document.
11: *
12: * 2. Redistributions in binary form must reproduce the
13: * above copyright notice, this list of conditions and the
14: * following disclaimer in the documentation and/or other
15: * materials provided with the distribution.
16: *
17: * 3. The name "JDBM" must not be used to endorse or promote
18: * products derived from this Software without prior written
19: * permission of Cees de Groot. For written permission,
20: * please contact cg@cdegroot.com.
21: *
22: * 4. Products derived from this Software may not be called "JDBM"
23: * nor may "JDBM" appear in their names without prior written
24: * permission of Cees de Groot.
25: *
26: * 5. Due credit should be given to the JDBM Project
27: * (http://jdbm.sourceforge.net/).
28: *
29: * THIS SOFTWARE IS PROVIDED BY THE JDBM PROJECT AND CONTRIBUTORS
30: * ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT
31: * NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
32: * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
33: * CEES DE GROOT OR ANY CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
34: * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
35: * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
36: * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
37: * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
38: * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
39: * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
40: * OF THE POSSIBILITY OF SUCH DAMAGE.
41: *
42: * Copyright 2000 (C) Cees de Groot. All Rights Reserved.
43: * Contributions are Copyright (C) 2000 by their associated contributors.
44: *
45: * $Id: CachePolicyListener.java,v 1.3 2003/11/01 13:25:41 dranatunga Exp $
46: */package jdbm.helper;
47:
48: /**
49: * Callback interface between {@link CachePolicy} and a Cache implementation
50: * to notify about cached object eviction.
51: * <p>
52: * Note that <code>CachePolicy</code> implementations typically use
53: * <em>object equality</em> when removing listeners, so concrete
54: * implementations of this interface should also pay attention to
55: * their {@link Object#equals(Object)} and {@link Object#hashCode()}
56: * methods.
57: *
58: * @author <a href="mailto:boisvert@intalio.com">Alex Boisvert</a>
59: * @version $Id: CachePolicyListener.java,v 1.3 2003/11/01 13:25:41 dranatunga Exp $
60: */
61: public interface CachePolicyListener {
62:
63: /**
64: * Notification that the cache this listener is attached to is evicting
65: * the object indicated.
66: *
67: * @param obj object being evited from cache
68: * @throws CacheEvictionException if this listener encountered problems
69: * while preparing for the specified object's eviction. For example,
70: * a listener may try to persist the object to disk, and encounter
71: * an <code>IOException</code>.
72: */
73: public void cacheObjectEvicted(Object obj)
74: throws CacheEvictionException;
75:
76: }
|