com.google.gwt.dev.javac

Class CompilationUnit

java.lang.Object

com.google.gwt.dev.javac.CompilationUnit

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

CachedCompilationUnit

public abstract class CompilationUnit
extends Object
implements Serializable

Encapsulates the state of a single active compilation unit in a particular module. State is accumulated throughout the life cycle of the containing module and may be invalidated at certain times and recomputed.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static Comparator<CompilationUnit>	COMPARATOR
protected static DiskCache	diskCache

Constructor Summary

Constructors

Constructor and Description
CompilationUnit()

Method Summary

Methods

Modifier and Type	Method and Description
abstract CachedCompilationUnit	asCachedCompilationUnit() Returns the unit as an instance of CachedCompilationUnit, making a copy if necessary.
boolean	constructAnonymousClassMappings(TreeLogger logger) Deprecated.
boolean	createdClassMapping() Deprecated.
boolean	equals(Object obj) Overridden to finalize; always returns object identity.
Map<String,String>	getAnonymousClassMap() Deprecated.
abstract Collection<CompiledClass>	getCompiledClasses() Returns all contained classes.
abstract List<JsniMethod>	getJsniMethods()
abstract long	getLastModified() Returns the last modified time of the compilation unit.
abstract MethodArgNamesLookup	getMethodArgs()
abstract String	getResourceLocation() This is the resource location from the classpath or some deterministic virtual location (in the case of generators or mock data) where the source for this unit originated.
abstract String	getResourcePath() Returns the full abstract path of the resource.
JDeclaredType	getTypeByName(String typeName) Returns the contained type with the given name.
abstract String	getTypeName() Returns the source name of the top level public type.
List<JDeclaredType>	getTypes() Returns a copy of the GWT AST types in this unit. Callers are free to modify the returned type instances without worrying about modifying the original CompilationUnit instances.
abstract byte[]	getTypesSerialized() Returns the GWT AST types in this unit in serialized form.
boolean	hasAnonymousClasses() Deprecated.
int	hashCode() Overridden to finalize; always returns identity hash code.
static boolean	isClassnameGenerated(String className) Deprecated.
abstract boolean	isError() Returns true if this unit had errors.
abstract boolean	isGenerated() Deprecated.
abstract boolean	isSuperSource() Deprecated.
String	toString() Overridden to finalize; always returns getResourceLocation().
protected Object	writeReplace() The canonical serialized form of a CompilatinUnit is CachedCompilationUnit.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

COMPARATOR

public static final Comparator<CompilationUnit> COMPARATOR

diskCache

protected static final DiskCache diskCache

Constructor Detail

CompilationUnit

public CompilationUnit()

Method Detail

isClassnameGenerated

@Deprecated
public static boolean isClassnameGenerated(String className)

Deprecated.

Checks if the class names is generated. Accepts any classes whose names match .+$\d.* (handling named classes within anonymous classes and multiple named classes of the same name in a class, but in different methods). Checks if the class or any of its enclosing classes are anonymous or synthetic.

If new compilers have different conventions for anonymous and synthetic classes, this code needs to be updated.

Parameters:

className - name of the class to be checked.

Returns:

true iff class or any of its enclosing classes are anonymous or synthetic.

asCachedCompilationUnit

public abstract CachedCompilationUnit asCachedCompilationUnit()

Returns the unit as an instance of CachedCompilationUnit, making a copy if necessary.

constructAnonymousClassMappings

@Deprecated
public final boolean constructAnonymousClassMappings(TreeLogger logger)

Deprecated.

createdClassMapping

@Deprecated
public final boolean createdClassMapping()

Deprecated.

equals

public final boolean equals(Object obj)

Overridden to finalize; always returns object identity.

Overrides:

equals in class Object

getAnonymousClassMap

@Deprecated
public final Map<String,String> getAnonymousClassMap()

Deprecated.

getCompiledClasses

public abstract Collection<CompiledClass> getCompiledClasses()

Returns all contained classes.

getJsniMethods

public abstract List<JsniMethod> getJsniMethods()

getLastModified

public abstract long getLastModified()

Returns the last modified time of the compilation unit.

getMethodArgs

public abstract MethodArgNamesLookup getMethodArgs()

Returns:

a way to lookup method argument names for this compilation unit.

getResourceLocation

public abstract String getResourceLocation()

This is the resource location from the classpath or some deterministic virtual location (in the case of generators or mock data) where the source for this unit originated. This should be unique for each unit compiled to create a module.

See Also:

Resource.getLocation()

getResourcePath

public abstract String getResourcePath()

Returns the full abstract path of the resource. If a resource has been re-rooted, this path should include any path prefix that was stripped.

See Also:

Resource.getPath(), Resource.getPathPrefix()

getTypeByName

public JDeclaredType getTypeByName(String typeName)

Returns the contained type with the given name.

getTypeName

public abstract String getTypeName()

Returns the source name of the top level public type.

getTypes

public List<JDeclaredType> getTypes()

Returns a copy of the GWT AST types in this unit.
Callers are free to modify the returned type instances without worrying about modifying the original CompilationUnit instances. It is this protection that makes it safe to reuse a single UnitCache and the same CompilationUnit instances across multiple compiles within the same process.

getTypesSerialized

public abstract byte[] getTypesSerialized()

Returns the GWT AST types in this unit in serialized form.

hasAnonymousClasses

@Deprecated
public final boolean hasAnonymousClasses()

Deprecated.

hashCode

public final int hashCode()

Overridden to finalize; always returns identity hash code.

Overrides:

hashCode in class Object

isError

public abstract boolean isError()

Returns true if this unit had errors.

isGenerated

@Deprecated
public abstract boolean isGenerated()

Deprecated.

Returns true if this unit was generated by a Generator.

isSuperSource

@Deprecated
public abstract boolean isSuperSource()

Deprecated.

Returns:

true if the Compilation Unit is from a super-source.

toString

public final String toString()

Overridden to finalize; always returns getResourceLocation().

Overrides:

toString in class Object

writeReplace

protected final Object writeReplace()

The canonical serialized form of a CompilatinUnit is CachedCompilationUnit.