com.google.gwt.dev.cfg

Class ModuleDef

java.lang.Object

com.google.gwt.dev.cfg.ModuleDef

All Implemented Interfaces:

DepsInfoProvider

public class ModuleDef
extends Object
implements DepsInfoProvider

Represents a module specification. In principle, this could be built without XML for unit tests.

Field Summary

Fields

Modifier and Type	Field and Description
protected ResourceOracleImpl	lazyPublicOracle All resources found on the public path, specified by directives in modules (or the implicit ./public directory).

Constructor Summary

Constructors

Constructor and Description
ModuleDef(String name)
ModuleDef(String name, ResourceLoader resources)
ModuleDef(String name, ResourceLoader resources, boolean monolithic, boolean mergePathPrefixes) Constructs a ModuleDef.

Method Summary

Modifier and Type	Method and Description
void	addEntryPointTypeName(String typeName)
void	addGwtXmlFile(File xmlFile)
void	addLinker(String name)
void	addPublicPackage(String publicPackage, String[] includeList, String[] excludeList, String[] skipList, boolean defaultExcludes, boolean caseSensitive)
void	addResourcePath(String resourcePath)
void	addRule(Rule rule)
void	addSourcePackage(String sourcePackage, String[] includeList, String[] excludeList, String[] skipList, boolean defaultExcludes, boolean caseSensitive)
void	addSourcePackageImpl(String sourcePackage, String[] includeList, String[] excludeList, String[] skipList, boolean defaultExcludes, boolean caseSensitive, boolean isSuperSource)
void	addSuperSourcePackage(String superSourcePackage, String[] includeList, String[] excludeList, String[] skipList, boolean defaultExcludes, boolean caseSensitive)
void	clearEntryPoints()
boolean	deactivateLinker(String linkerName) Deactivate a linker by name.
void	defineLinker(TreeLogger logger, String name, Class<? extends Linker> linker) Associate a Linker class with a symbolic name.
void	enterModule(String canonicalModuleName) Called as module tree parsing enters and exits individual module file of various types and so provides the ModuleDef with an opportunity to keep track of what context it is currently operating.
void	exitModule()
Resource	findPublicFile(String partialPath)
String	findServletForPath(String actual)
Resource	findSourceFile(String partialPath) Returns the Resource for a source file if it is found; null otherwise.
Set<String>	getActiveLinkerNames()
Set<Class<? extends Linker>>	getActiveLinkers()
Class<? extends Linker>	getActivePrimaryLinker()
String[]	getAllSourceFiles() Strictly for statistics gathering.
ResourceOracle	getBuildResourceOracle()
String	getCanonicalName() Returns the physical name for the module by which it can be found in the classpath.
CompilationState	getCompilationState(TreeLogger logger, CompilerContext compilerContext)
String[]	getEntryPointTypeNames()
String	getFunctionName()
List<Rule>	getGeneratorRules()
String	getGwtXmlFilePath(String moduleName) Returns the .gwt.xml file path for the given module referenced by name.
int	getInputFilenameHash() Calculates a hash of the filenames of all the input files for the GWT compiler.
Class<? extends Linker>	getLinker(String name)
Map<String,Class<? extends Linker>>	getLinkers()
String	getName()
Properties	getProperties() The properties that have been defined.
ResourceOracleImpl	getPublicResourceOracle()
long	getResourceLastModified()
Set<Resource>	getResourcesNewerThan(long modificationTime)
Deque<Rule>	getRules() Gets a reference to the internal rules for this module def.
Scripts	getScripts() Gets a reference to the internal scripts list for this module def.
String[]	getServletPaths()
Set<String>	getSourceModuleNames(String typeSourceName) Returns a set of the names of modules that source included the given type referenced by name.
ResourceOracle	getSourceResourceOracle()
Styles	getStyles() Gets a reference to the internal styles list for this module def.
boolean	isGwtXmlFileStale()
boolean	isInherited(String moduleName)
static boolean	isValidModuleName(String moduleName)
long	lastModified()
void	mapServlet(String path, String servletClassName) For convenience in unit tests, servlets can be automatically loaded and mapped in the embedded web server.
void	recordModuleGwtXmlFile(String moduleName, String fileSourcePath)
void	refresh()
void	setCollapseAllProperties(boolean collapse) Mainly for testing and decreasing compile times.
void	setNameOverride(String nameOverride) Override the module's apparent name.

Methods inherited from class java.lang.Object

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

Field Detail

lazyPublicOracle

protected ResourceOracleImpl lazyPublicOracle

All resources found on the public path, specified by directives in modules (or the implicit ./public directory). Marked 'lazy' because it does not start searching for resources until a query is made.

Constructor Detail

ModuleDef

public ModuleDef(String name)

ModuleDef

public ModuleDef(String name,
                 ResourceLoader resources)

ModuleDef

public ModuleDef(String name,
                 ResourceLoader resources,
                 boolean monolithic,
                 boolean mergePathPrefixes)

Constructs a ModuleDef.

Method Detail

isValidModuleName

public static boolean isValidModuleName(String moduleName)

addEntryPointTypeName

public void addEntryPointTypeName(String typeName)

addGwtXmlFile

public void addGwtXmlFile(File xmlFile)

addLinker

public void addLinker(String name)

addPublicPackage

public void addPublicPackage(String publicPackage,
                             String[] includeList,
                             String[] excludeList,
                             String[] skipList,
                             boolean defaultExcludes,
                             boolean caseSensitive)

addResourcePath

public void addResourcePath(String resourcePath)

addRule

public void addRule(Rule rule)

addSourcePackage

public void addSourcePackage(String sourcePackage,
                             String[] includeList,
                             String[] excludeList,
                             String[] skipList,
                             boolean defaultExcludes,
                             boolean caseSensitive)

addSourcePackageImpl

public void addSourcePackageImpl(String sourcePackage,
                                 String[] includeList,
                                 String[] excludeList,
                                 String[] skipList,
                                 boolean defaultExcludes,
                                 boolean caseSensitive,
                                 boolean isSuperSource)

addSuperSourcePackage

public void addSuperSourcePackage(String superSourcePackage,
                                  String[] includeList,
                                  String[] excludeList,
                                  String[] skipList,
                                  boolean defaultExcludes,
                                  boolean caseSensitive)

clearEntryPoints

public void clearEntryPoints()

deactivateLinker

public boolean deactivateLinker(String linkerName)

Deactivate a linker by name. Returns false if the linker was not active, true otherwise.

defineLinker

public void defineLinker(TreeLogger logger,
                         String name,
                         Class<? extends Linker> linker)
                  throws UnableToCompleteException

Associate a Linker class with a symbolic name. If the name had been previously assigned, this method will redefine the name. If the redefined linker had been previously added to the set of active linkers, the old active linker will be replaced with the new linker.

Throws:

UnableToCompleteException

enterModule

public void enterModule(String canonicalModuleName)

Called as module tree parsing enters and exits individual module file of various types and so provides the ModuleDef with an opportunity to keep track of what context it is currently operating.

exitModule

public void exitModule()

findPublicFile

public Resource findPublicFile(String partialPath)

findServletForPath

public String findServletForPath(String actual)

findSourceFile

public Resource findSourceFile(String partialPath)

Returns the Resource for a source file if it is found; null otherwise.

Parameters:

partialPath - the partial path of the source file

Returns:

the resource for the requested source file

getActiveLinkerNames

public Set<String> getActiveLinkerNames()

getActiveLinkers

public Set<Class<? extends Linker>> getActiveLinkers()

getActivePrimaryLinker

public Class<? extends Linker> getActivePrimaryLinker()

getAllSourceFiles

public String[] getAllSourceFiles()

Strictly for statistics gathering. There is no guarantee that the source oracle has been initialized.

getBuildResourceOracle

public ResourceOracle getBuildResourceOracle()

getCanonicalName

public String getCanonicalName()

Returns the physical name for the module by which it can be found in the classpath.

getCompilationState

public CompilationState getCompilationState(TreeLogger logger,
                                            CompilerContext compilerContext)
                                     throws UnableToCompleteException

Throws:

UnableToCompleteException

getEntryPointTypeNames

public String[] getEntryPointTypeNames()

getFunctionName

public String getFunctionName()

getGeneratorRules

public List<Rule> getGeneratorRules()

getGwtXmlFilePath

public String getGwtXmlFilePath(String moduleName)

Description copied from interface: DepsInfoProvider

Returns the .gwt.xml file path for the given module referenced by name.

Specified by:

getGwtXmlFilePath in interface DepsInfoProvider

getInputFilenameHash

public int getInputFilenameHash()

Calculates a hash of the filenames of all the input files for the GWT compiler.

This is needed because the list of files could change without affecting the timestamp. For example, consider a glob that matches fewer files than before because a file was deleted.

getLinker

public Class<? extends Linker> getLinker(String name)

getLinkers

public Map<String,Class<? extends Linker>> getLinkers()

getName

public String getName()

getProperties

public Properties getProperties()

The properties that have been defined.

getPublicResourceOracle

public ResourceOracleImpl getPublicResourceOracle()

getResourceLastModified

public long getResourceLastModified()

getResourcesNewerThan

public Set<Resource> getResourcesNewerThan(long modificationTime)

getRules

public Deque<Rule> getRules()

Gets a reference to the internal rules for this module def.

getScripts

public Scripts getScripts()

Gets a reference to the internal scripts list for this module def.

getServletPaths

public String[] getServletPaths()

getSourceModuleNames

public Set<String> getSourceModuleNames(String typeSourceName)

Description copied from interface: DepsInfoProvider

Returns a set of the names of modules that source included the given type referenced by name.

Specified by:

getSourceModuleNames in interface DepsInfoProvider

getSourceResourceOracle

public ResourceOracle getSourceResourceOracle()

getStyles

public Styles getStyles()

Gets a reference to the internal styles list for this module def.

isGwtXmlFileStale

public boolean isGwtXmlFileStale()

isInherited

public boolean isInherited(String moduleName)

lastModified

public long lastModified()

mapServlet

public void mapServlet(String path,
                       String servletClassName)

For convenience in unit tests, servlets can be automatically loaded and mapped in the embedded web server. If a servlet is already mapped to the specified path, it is replaced.

Parameters:

path - the url path at which the servlet resides

servletClassName - the name of the servlet to publish

recordModuleGwtXmlFile

public void recordModuleGwtXmlFile(String moduleName,
                                   String fileSourcePath)

refresh

public void refresh()

setCollapseAllProperties

public void setCollapseAllProperties(boolean collapse)

Mainly for testing and decreasing compile times.

setNameOverride

public void setNameOverride(String nameOverride)

Override the module's apparent name. Setting this value to nullwill disable the name override.