com.google.javascript.jscomp

Class CompilerInput

java.lang.Object

com.google.javascript.jscomp.deps.DependencyInfo.Base

com.google.javascript.jscomp.CompilerInput

All Implemented Interfaces:

DependencyInfo, SourceAst, java.io.Serializable

public class CompilerInput
extends DependencyInfo.Base
implements SourceAst

A class for the internal representation of an input to the compiler. Wraps a SourceAst and maintain state such as module for the input and whether the input is an extern. Also calculates provided and required types.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CompilerInput.ModuleType JavaScript module type.

Nested classes/interfaces inherited from interface com.google.javascript.jscomp.deps.DependencyInfo

DependencyInfo.Base, DependencyInfo.Require, DependencyInfo.Util

Constructor Summary

Constructors

Constructor and Description
CompilerInput(SourceAst ast)
CompilerInput(SourceAst ast, boolean isExtern)
CompilerInput(SourceAst ast, InputId inputId, boolean isExtern)
CompilerInput(SourceAst ast, java.lang.String inputId, boolean isExtern)
CompilerInput(SourceFile file)
CompilerInput(SourceFile file, boolean isExtern)

Method Summary

Modifier and Type	Method and Description
boolean	addDynamicRequire(java.lang.String require) Registers a type that this input depends on in the order seen in the file.
boolean	addOrderedRequire(DependencyInfo.Require require) Registers a type that this input depends on in the order seen in the file.
void	addProvide(java.lang.String provide) Registers a type that this input defines.
void	addRequire(DependencyInfo.Require require) Registers a type that this input depends on.
void	clearAst() Removes any references to root node of the AST.
Node	getAstRoot(AbstractCompiler compiler) Gets the root node of the AST for the source file this represents.
java.lang.String	getCode()
com.google.common.collect.ImmutableList<java.lang.String>	getDynamicRequires() Returns the types that this input dynamically depends on in the order seen in the file.
boolean	getHasExternsAnnotation() Whether the file '@externs' annotation.
boolean	getHasNoCompileAnnotation() Whether the file has the '@nocompile' annotation.
InputId	getInputId() Returns a name for this input.
CompilerInput.ModuleType	getJsModuleType()
int	getLineOffset(int lineno)
com.google.common.collect.ImmutableMap<java.lang.String,java.lang.String>	getLoadFlags() Gets the loading information for this file.
JSModule	getModule() Returns the module to which the input belongs.
java.lang.String	getName() Returns a name for this input.
int	getNumLines()
ModuleLoader.ModulePath	getPath()
java.lang.String	getPathRelativeToClosureBase() Gets the path relative to closure-base, if one is available.
com.google.common.collect.ImmutableList<java.lang.String>	getProvides() Gets a list of types provided by this input.
com.google.common.collect.ImmutableList<DependencyInfo.Require>	getRequires() Gets a list of types depended on by this input.
SourceFile	getSourceFile() Returns the source file the generated AST represents.
com.google.common.collect.ImmutableList<java.lang.String>	getTypeRequires() Gets the symbols type-required by this file (i.e.
boolean	isExtern()
void	setCompiler(AbstractCompiler compiler) Sets an abstract compiler for doing parsing.
void	setHasFullParseDependencyInfo(boolean hasFullParseDependencyInfo)
void	setJsModuleType(CompilerInput.ModuleType moduleType)
void	setModule(JSModule module) Sets the module to which the input belongs.
void	setSourceFile(SourceFile file) Sets the source file the generated AST represents.
java.lang.String	toString()

Methods inherited from class com.google.javascript.jscomp.deps.DependencyInfo.Base

getRequiredSymbols, isModule

Methods inherited from class java.lang.Object

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

Constructor Detail

CompilerInput

public CompilerInput(SourceAst ast)

CompilerInput

public CompilerInput(SourceAst ast,
                     boolean isExtern)

CompilerInput

public CompilerInput(SourceAst ast,
                     java.lang.String inputId,
                     boolean isExtern)

CompilerInput

public CompilerInput(SourceAst ast,
                     InputId inputId,
                     boolean isExtern)

CompilerInput

public CompilerInput(SourceFile file)

CompilerInput

public CompilerInput(SourceFile file,
                     boolean isExtern)

Method Detail

getInputId

public InputId getInputId()

Returns a name for this input. Must be unique across all inputs.

Specified by:

getInputId in interface SourceAst

Returns:

The input id associated with this AST

getName

public java.lang.String getName()

Returns a name for this input. Must be unique across all inputs.

Specified by:

getName in interface DependencyInfo

getPathRelativeToClosureBase

public java.lang.String getPathRelativeToClosureBase()

Gets the path relative to closure-base, if one is available.

Specified by:

getPathRelativeToClosureBase in interface DependencyInfo

getAstRoot

public Node getAstRoot(AbstractCompiler compiler)

Description copied from interface: SourceAst

Gets the root node of the AST for the source file this represents. The AST is lazily instantiated and cached. This node is always non-null, even in the case of parse errors.

Specified by:

getAstRoot in interface SourceAst

clearAst

public void clearAst()

Description copied from interface: SourceAst

Removes any references to root node of the AST. If it is requested again, another parse will be performed. This method is needed to allow the ASTs to be garbage collected if the inputs are still around after compilation.

Specified by:

clearAst in interface SourceAst

getSourceFile

public SourceFile getSourceFile()

Description copied from interface: SourceAst

Returns the source file the generated AST represents.

Specified by:

getSourceFile in interface SourceAst

setSourceFile

public void setSourceFile(SourceFile file)

Description copied from interface: SourceAst

Sets the source file the generated AST represents. This can be called after deserializing if access to the source file is needed. If a different file is provided than that with which this was created, an IllegalStateException will be thrown.

Specified by:

setSourceFile in interface SourceAst

setCompiler

public void setCompiler(AbstractCompiler compiler)

Sets an abstract compiler for doing parsing.

getRequires

public com.google.common.collect.ImmutableList<DependencyInfo.Require> getRequires()

Gets a list of types depended on by this input.

Specified by:

getRequires in interface DependencyInfo

getTypeRequires

public com.google.common.collect.ImmutableList<java.lang.String> getTypeRequires()

Description copied from interface: DependencyInfo

Gets the symbols type-required by this file (i.e. for typechecking only).

Specified by:

getTypeRequires in interface DependencyInfo

getProvides

public com.google.common.collect.ImmutableList<java.lang.String> getProvides()

Gets a list of types provided by this input.

Specified by:

getProvides in interface DependencyInfo

getHasExternsAnnotation

public boolean getHasExternsAnnotation()

Description copied from interface: DependencyInfo

Whether the file '@externs' annotation.

Specified by:

getHasExternsAnnotation in interface DependencyInfo

getHasNoCompileAnnotation

public boolean getHasNoCompileAnnotation()

Description copied from interface: DependencyInfo

Whether the file has the '@nocompile' annotation.

Specified by:

getHasNoCompileAnnotation in interface DependencyInfo

addProvide

public void addProvide(java.lang.String provide)

Registers a type that this input defines. Includes both explicitly declared namespaces via goog.provide and goog.module calls as well as implicit namespaces provided by module rewriting.

addOrderedRequire

public boolean addOrderedRequire(DependencyInfo.Require require)

Registers a type that this input depends on in the order seen in the file.

getDynamicRequires

public com.google.common.collect.ImmutableList<java.lang.String> getDynamicRequires()

Returns the types that this input dynamically depends on in the order seen in the file. The returned types were loaded dynamically so while they are part of the dependency graph, they do not need sorted before this input.

addDynamicRequire

public boolean addDynamicRequire(java.lang.String require)

Registers a type that this input depends on in the order seen in the file. The type was loaded dynamically so while it is part of the dependency graph, it does not need sorted before this input.

setHasFullParseDependencyInfo

public void setHasFullParseDependencyInfo(boolean hasFullParseDependencyInfo)

getJsModuleType

public CompilerInput.ModuleType getJsModuleType()

setJsModuleType

public void setJsModuleType(CompilerInput.ModuleType moduleType)

addRequire

public void addRequire(DependencyInfo.Require require)

Registers a type that this input depends on.

getCode

public java.lang.String getCode()
                         throws java.io.IOException

Throws:

java.io.IOException

getModule

public JSModule getModule()

Returns the module to which the input belongs.

setModule

public void setModule(JSModule module)

Sets the module to which the input belongs.

isExtern

public boolean isExtern()

getLineOffset

public int getLineOffset(int lineno)

getNumLines

public int getNumLines()

Returns:

The number of lines in this input.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getLoadFlags

public com.google.common.collect.ImmutableMap<java.lang.String,java.lang.String> getLoadFlags()

Description copied from interface: DependencyInfo

Gets the loading information for this file.

Specified by:

getLoadFlags in interface DependencyInfo

getPath

public ModuleLoader.ModulePath getPath()