com.google.gwt.dev.javac

Class LibraryGroupUnitCache

java.lang.Object

com.google.gwt.dev.javac.LibraryGroupUnitCache

All Implemented Interfaces:

UnitCache

public class LibraryGroupUnitCache
extends Object
implements UnitCache

A cache that finds compilation unit instances in a library group.
ContentId based lookups are not supported since having multiple versions of the same compilation unit in a set of libraries would be an error.
Removals are not supported since libraries are immutable and the removals would only be needed if library contents were invalid.

Constructor Summary

Constructors

Constructor and Description
LibraryGroupUnitCache(LibraryGroup libraryGroup)

Method Summary

Modifier and Type	Method and Description
void	add(CompilationUnit compilationUnit) Adds a CompilationUnit to the cache. Though this class is intended primarily to expose and cache compilation units from previously compiled library files it must also be prepared to accept brand new compilation units resulting from live compilation as this is an absolute requirement for the current compiler design.
void	addArchivedUnit(CompilationUnit compilationUnit) Adds a new entry into the cache, but marks it as already coming from a persistent archive.
void	cleanup(TreeLogger logger) Each run of the compiler should call UnitCache.cleanup(TreeLogger) when finished adding units to the cache so that cache files from previous runs can be purged from a persistent 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.
static String	typeNameToResourcePath(String typeName) Translates type names to resource paths to ease lookups since the unit cache system caches based on resource path but the natural mode of interaction with this cache is via type names.

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, toString

Constructor Detail

LibraryGroupUnitCache

public LibraryGroupUnitCache(LibraryGroup libraryGroup)

Method Detail

typeNameToResourcePath

public static String typeNameToResourcePath(String typeName)

Translates type names to resource paths to ease lookups since the unit cache system caches based on resource path but the natural mode of interaction with this cache is via type names.

add

public void add(CompilationUnit compilationUnit)

Adds a CompilationUnit to the cache.
Though this class is intended primarily to expose and cache compilation units from previously compiled library files it must also be prepared to accept brand new compilation units resulting from live compilation as this is an absolute requirement for the current compiler design.

Specified by:

add in interface UnitCache

addArchivedUnit

public void addArchivedUnit(CompilationUnit compilationUnit)

Description copied from interface: UnitCache

Adds a new entry into the cache, but marks it as already coming from a persistent archive. This means it doesn't need to be saved out to disk in a persistent implementation of the cache.

Specified by:

addArchivedUnit in interface UnitCache

cleanup

public void cleanup(TreeLogger logger)

Description copied from interface: UnitCache

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

Specified by:

cleanup in interface UnitCache

find

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

Description copied from interface: UnitCache

Lookup a CompilationUnit by ContentId.

Specified by:

find in interface UnitCache

find

public CompilationUnit find(String resourcePath)

Description copied from interface: UnitCache

Lookup a CompilationUnit by resource path. This should include any path prefix that may have been was stripped to reroot the resource.

Specified by:

find in interface UnitCache

See Also:

CompilationUnit.getResourcePath()

remove

public void remove(CompilationUnit unit)

Description copied from interface: UnitCache

Remove a CompilationUnit from the cache.

Specified by:

remove in interface UnitCache