/******************************************************************************* | |
* Copyright (c) 2008, 2009 Sun Microsystems. All rights reserved. | |
* | |
* This program and the accompanying materials are made available under the | |
* terms of the Eclipse Public License v1.0 and Eclipse Distribution License v. 1.0 | |
* which accompanies this distribution. | |
* The Eclipse Public License is available at http://www.eclipse.org/legal/epl-v10.html | |
* and the Eclipse Distribution License is available at | |
* http://www.eclipse.org/org/documents/edl-v10.php. | |
* | |
* Contributors: | |
* Linda DeMichiel -Java Persistence 2.0 - Proposed Final Draft, Version 2.0 (August 31, 2009) | |
* Specification available from http://jcp.org/en/jsr/detail?id=317 | |
* | |
* Java(TM) Persistence API, Version 2.0 - EARLY ACCESS | |
* This is an implementation of an early-draft specification developed under the | |
* Java Community Process (JCP). The code is untested and presumed not to be a | |
* compatible implementation of JSR 317: Java(TM) Persistence API, Version 2.0. | |
* We encourage you to migrate to an implementation of the Java(TM) Persistence | |
* API, Version 2.0 Specification that has been tested and verified to be compatible | |
* as soon as such an implementation is available, and we encourage you to retain | |
* this notice in any implementation of Java(TM) Persistence API, Version 2.0 | |
* Specification that you distribute. | |
******************************************************************************/ | |
package javax.persistence; | |
/** | |
* Interface used to interact with the second-level cache. | |
* If a cache is not in use, the methods of this interface have | |
* no effect, except for <code>contains</code>, which returns false. | |
* | |
* @since Java Persistence 2.0 | |
*/ | |
public interface Cache { | |
/** | |
* Whether the cache contains data for the given entity. | |
* @param cls entity class | |
* @param primaryKey primary key | |
* @return boolean indicating whether the entity is in the cache | |
*/ | |
public boolean contains(Class cls, Object primaryKey); | |
/** | |
* Remove the data for the given entity from the cache. | |
* @param cls entity class | |
* @param primaryKey primary key | |
*/ | |
public void evict(Class cls, Object primaryKey); | |
/** | |
* Remove the data for entities of the specified class (and its | |
* subclasses) from the cache. | |
* @param cls entity class | |
*/ | |
public void evict(Class cls); | |
/** | |
* Clear the cache. | |
*/ | |
public void evictAll(); | |
} |