Package org.aspectj.weaver.tools.cache

Klasse AsynchronousFileCacheBacking

java.lang.Object

org.aspectj.weaver.tools.cache.AbstractCacheBacking

org.aspectj.weaver.tools.cache.AbstractFileCacheBacking

org.aspectj.weaver.tools.cache.AbstractIndexedFileCacheBacking

org.aspectj.weaver.tools.cache.AsynchronousFileCacheBacking

Alle implementierten Schnittstellen:

CacheBacking

Bekannte direkte Unterklassen:

FlatFileCacheBacking, ZippedFileCacheBacking

public abstract class AsynchronousFileCacheBacking
extends AbstractIndexedFileCacheBacking

Uses a background thread to do the actual I/O and for caching "persistence" so that the caching works faster on repeated activations of the application. The class maintains an in-memory cache, and uses a queue of AsynchronousFileCacheBacking.AsyncCommands to signal to a background thread various actions required to "synchronize" the in-memory cache with the persisted copy. Whenever there is a cache miss from the get(CachedClassReference, byte[]) call, the weaver issues a put(CachedClassEntry, byte[]) call. This call has 2 side-effects:

• The in-memory cache is updated so that subsequent calls to get(CachedClassReference, byte[]) will not return the mapped value.
• An "update index" AsynchronousFileCacheBacking.AsyncCommand is posted to the background thread so that the newly mapped value will be persisted (eventually)

The actual persistence is implemented by the concrete classes

Verschachtelte Klassen - Übersicht

Verschachtelte Klassen

Modifizierer und Typ	Klasse	Beschreibung
static class	AsynchronousFileCacheBacking.AbstractCommand
static interface	AsynchronousFileCacheBacking.AsyncCommand	Represents an asynchronous command that can be sent to the AsynchronousFileCacheBacking instance to be executed on it asynchronously
static interface	AsynchronousFileCacheBacking.AsynchronousFileCacheBackingCreator<T extends AsynchronousFileCacheBacking>
static class	AsynchronousFileCacheBacking.ClearCommand
static class	AsynchronousFileCacheBacking.InsertCommand
static class	AsynchronousFileCacheBacking.KeyedCommand	Base class for AsynchronousFileCacheBacking.AbstractCommands that refer to a cache key
static class	AsynchronousFileCacheBacking.RemoveCommand
static class	AsynchronousFileCacheBacking.UpdateIndexCommand

Von Klasse geerbte verschachtelte Klassen/Schnittstellen org.aspectj.weaver.tools.cache.AbstractIndexedFileCacheBacking

AbstractIndexedFileCacheBacking.IndexEntry

Feldübersicht

Felder

Modifizierer und Typ	Feld	Beschreibung
protected final Map<String,byte[]>	bytesMap
protected final Map<String,byte[]>	exposedBytes
protected final Map<String,AbstractIndexedFileCacheBacking.IndexEntry>	exposedIndex
protected final Map<String,AbstractIndexedFileCacheBacking.IndexEntry>	index

Von Klasse geerbte Felder org.aspectj.weaver.tools.cache.AbstractIndexedFileCacheBacking

EMPTY_INDEX, EMPTY_KEYS, INDEX_FILE

Von Klasse geerbte Felder org.aspectj.weaver.tools.cache.AbstractFileCacheBacking

WEAVED_CLASS_CACHE_DIR

Von Klasse geerbte Felder org.aspectj.weaver.tools.cache.AbstractCacheBacking

logger

Konstruktorübersicht

Konstruktoren

Modifizierer	Konstruktor	Beschreibung
protected	AsynchronousFileCacheBacking(File cacheDir)

Methodenübersicht

Modifizierer und Typ	Methode	Beschreibung
void	clear()	Clear the entire cache
protected static final <T extends AsynchronousFileCacheBacking> T	createBacking(File cacheDir, AsynchronousFileCacheBacking.AsynchronousFileCacheBackingCreator<T> creator)
protected void	executeClearCommand()
protected void	executeCommand(AsynchronousFileCacheBacking.AsyncCommand cmd)
protected void	executeInsertCommand(AsynchronousFileCacheBacking.InsertCommand cmd)
protected void	executeRemoveCommand(AsynchronousFileCacheBacking.RemoveCommand cmd)
protected void	executeUpdateIndexCommand()
CachedClassEntry	get(CachedClassReference ref, byte[] originalBytes)	Get a cache entry
Map<String,byte[]>	getBytesMap()
protected Map<String,AbstractIndexedFileCacheBacking.IndexEntry>	getIndex()
List<AbstractIndexedFileCacheBacking.IndexEntry>	getIndexEntries()
Map<String,AbstractIndexedFileCacheBacking.IndexEntry>	getIndexMap()
static final boolean	postCacheCommand(AsynchronousFileCacheBacking.AsyncCommand cmd)
void	put(CachedClassEntry entry, byte[] originalBytes)	Put an entry in the cache
protected abstract Map<String,byte[]>	readClassBytes(Map<String,AbstractIndexedFileCacheBacking.IndexEntry> indexMap, File cacheDir)
protected AbstractIndexedFileCacheBacking.IndexEntry	remove(String key)
void	remove(CachedClassReference ref)	Remove an entry from the cache
protected abstract void	removeClassBytes(String key)	Helper for executeRemoveCommand(RemoveCommand)
String	toString()

Von Klasse geerbte Methoden org.aspectj.weaver.tools.cache.AbstractIndexedFileCacheBacking

createIndexEntry, getIndexFile, getKeys, readIndex, readIndex, readIndex, resolveIndexMapEntry, writeIndex, writeIndex, writeIndex, writeIndex, writeIndex

Von Klasse geerbte Methoden org.aspectj.weaver.tools.cache.AbstractFileCacheBacking

close, close, delete, getCacheDirectory, writeClassBytes

Von Klasse geerbte Methoden org.aspectj.weaver.tools.cache.AbstractCacheBacking

crc

Von Klasse geerbte Methoden java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Felddetails

index

protected final Map<String,AbstractIndexedFileCacheBacking.IndexEntry> index

exposedIndex

protected final Map<String,AbstractIndexedFileCacheBacking.IndexEntry> exposedIndex

bytesMap

protected final Map<String,byte[]> bytesMap

exposedBytes

protected final Map<String,byte[]> exposedBytes

Konstruktordetails

AsynchronousFileCacheBacking

protected AsynchronousFileCacheBacking(File cacheDir)

Methodendetails

getIndex

protected Map<String,AbstractIndexedFileCacheBacking.IndexEntry> getIndex()

Angegeben von:

getIndex in Klasse AbstractIndexedFileCacheBacking

get

public CachedClassEntry get(CachedClassReference ref,
 byte[] originalBytes)

Beschreibung aus Schnittstelle kopiert: CacheBacking

Get a cache entry

Parameter:

ref - entry to retrieve

originalBytes - Pre-weaving class bytes - required in order to ensure that the cached entry refers to the same original class

Gibt zurück:

the cached bytes or null, if the entry does not exist

put

public void put(CachedClassEntry entry,
 byte[] originalBytes)

Beschreibung aus Schnittstelle kopiert: CacheBacking

Put an entry in the cache

Parameter:

entry - key of the entry

originalBytes - Pre-weaving class bytes - required in order to ensure that the cached entry refers to the same original class

remove

public void remove(CachedClassReference ref)

Beschreibung aus Schnittstelle kopiert: CacheBacking

Remove an entry from the cache

Parameter:

ref -

remove

protected AbstractIndexedFileCacheBacking.IndexEntry remove(String key)

getIndexEntries

public List<AbstractIndexedFileCacheBacking.IndexEntry> getIndexEntries()

getIndexMap

public Map<String,AbstractIndexedFileCacheBacking.IndexEntry> getIndexMap()

getBytesMap

public Map<String,byte[]> getBytesMap()

clear

public void clear()

Beschreibung aus Schnittstelle kopiert: CacheBacking

Clear the entire cache

executeCommand

protected void executeCommand(AsynchronousFileCacheBacking.AsyncCommand cmd)
                       throws Exception

Löst aus:

Exception

executeClearCommand

protected void executeClearCommand()
                            throws Exception

Löst aus:

Exception

executeUpdateIndexCommand

protected void executeUpdateIndexCommand()
                                  throws Exception

Löst aus:

Exception

executeInsertCommand

protected void executeInsertCommand(AsynchronousFileCacheBacking.InsertCommand cmd)
                             throws Exception

Löst aus:

Exception

executeRemoveCommand

protected void executeRemoveCommand(AsynchronousFileCacheBacking.RemoveCommand cmd)
                             throws Exception

Löst aus:

Exception

removeClassBytes

protected abstract void removeClassBytes(String key)
                                  throws Exception

Helper for executeRemoveCommand(RemoveCommand)

Parameter:

key - The key representing the class whose bytes are to be removed

Löst aus:

Exception - if failed to remove class bytes

readClassBytes

protected abstract Map<String,byte[]> readClassBytes(Map<String,AbstractIndexedFileCacheBacking.IndexEntry> indexMap,
 File cacheDir)

toString

public String toString()

Setzt außer Kraft:

toString in Klasse Object

createBacking

protected static final <T extends AsynchronousFileCacheBacking>
T createBacking(File cacheDir,
 AsynchronousFileCacheBacking.AsynchronousFileCacheBackingCreator<T> creator)

postCacheCommand

public static final boolean postCacheCommand(AsynchronousFileCacheBacking.AsyncCommand cmd)