com.google.gwt.dev.javac

Interface UnitCache

All Known Implementing Classes:

MemoryUnitCache

public interface UnitCache

An interface for caching CompilationUnits. Alternate implementations may cache only in memory or both cache in memory and persist to disk.
All implementations must be reusable across multiple compiles of potentially different applications within the same process. Some JUnitShell test suite execution exercises exactly this path.

Method Summary

Modifier and Type	Method and Description
void	add(CompilationUnit newUnit) Adds a CompilationUnit to the cache.
void	cleanup(TreeLogger logger) Each run of the compiler should call cleanup(TreeLogger) when finished adding units to the cache so that cache files from previous runs can be purged from a persistent cache.
void	clear() Wipe the contents of the cache.
CompilationUnit	find(com.google.gwt.dev.javac.ContentId contentId) Lookup a CompilationUnit by ContentId.
CompilationUnit	find(String resourcePath) Lookup a CompilationUnit by resource path.
void	remove(CompilationUnit unit) Remove a CompilationUnit from the cache.

Method Detail

add

void add(CompilationUnit newUnit)

Adds a CompilationUnit to the cache.

cleanup

void cleanup(TreeLogger logger)

Each run of the compiler should call cleanup(TreeLogger) when finished adding units to the cache so that cache files from previous runs can be purged from a persistent cache.

clear

void clear()
    throws UnableToCompleteException

Wipe the contents of the cache.

Throws:

UnableToCompleteException

find

CompilationUnit find(com.google.gwt.dev.javac.ContentId contentId)

Lookup a CompilationUnit by ContentId.

find

CompilationUnit find(String resourcePath)

Lookup a CompilationUnit by resource path. This should include any path prefix that may have been stripped to reroot the resource.
Contained CompilationUnits must be keyed on this combination of path prefix and path to avoid collision when reusing a UnitCache instance between compiles that do and do not SuperSource a given class.

See Also:

CompilationUnit.getResourcePath()

remove

void remove(CompilationUnit unit)

Remove a CompilationUnit from the cache.