org.apache.flex.compiler.internal.as.codegen

Class GlobalLexicalScope

java.lang.Object

org.apache.flex.compiler.internal.as.codegen.LexicalScope

org.apache.flex.compiler.internal.as.codegen.GlobalLexicalScope

public class GlobalLexicalScope
extends LexicalScope

The global lexical scope for codegen. This class can't have a containing lexical scope.

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.flex.compiler.internal.as.codegen.LexicalScope

LexicalScope.NestingState, LexicalScope.TempManager, LexicalScope.VariableMutability

Field Summary

Fields

Modifier and Type	Field and Description
static String	EMPTY_NAME_PREFIX No synthetic name prefix.
static ICodeGenerator	NO_GENERATOR No code generator.
static boolean	NO_PARALLEL_CODEGEN Single-thread code generation.
static IABCVisitor	USE_DEFAULT_EMITTER No IABCVisitor supplied, this scope should supply a default implementation.
static boolean	VISIBLE_COMPILATION_UNIT The value for the inInvisibleCompilationUnit constructor parameter that means we are not in an invisible compilation unit.

Fields inherited from class org.apache.flex.compiler.internal.as.codegen.LexicalScope

anyType, DEBUG_LINE_UNKNOWN, methodBodySemanticChecker, noInitializer

Constructor Summary

Constructors

Constructor and Description
GlobalLexicalScope(ICompilerProject project, ICodeGenerator generator) Construct a "global" scope to attempt to generate a constant value.
GlobalLexicalScope(ICompilerProject project, ICodeGenerator generator, String syntheticNamePrefix, boolean inInvisibleCompilationUnit, boolean useParallelCodegen, Map<String,String> encodedDebugFiles) Construct a global lexical scope to serve as the basis for generating code for a compilation unit.
GlobalLexicalScope(ICompilerProject project, ICodeGenerator generator, String syntheticNamePrefix, IABCVisitor emitter) Construct a global scope with a specialized IABCVisitor.

Method Summary

Methods

Modifier and Type	Method and Description
void	addProblem(ICompilerProblem problem) Add a problem to this code generation phase.
Set<EmbedData>	getEmbeds()
protected String	getEncodedDebugFile(String filename)
ICodeGenerator	getGenerator()
boolean	getInInvisibleCompilationUnit()
InstructionList	getInitInstructions()
MethodBodySemanticChecker	getMethodBodySemanticChecker()
Collection<ICompilerProblem>	getProblems()
ICompilerProject	getProject()
protected String	getSyntheticName(String user_supplied)
boolean	isGlobalScope()

Methods inherited from class org.apache.flex.compiler.internal.as.codegen.LexicalScope

addDefaultValue, addHasNexts, addInlinedBindings, addProblems, allocateTemp, allocateTemp, declareVariableName, emitFile, emitLine, findProperty, findProperty, finishClassStaticInitializer, generateBindableGetter, generateBindableSetter, getBinding, getBinding, getDebugFile, getEnclosingFrame, getFlowManager, getGlobalScope, getHasNexts, getLocalASScope, getLocalBindings, getMethodInfo, getNestingState, getParamTypes, getPropertyValue, getPropertyValue, getThisBinding, initializeTempRegisters, insideInlineFunction, isLocalDefinition, makeBindableVariable, makeNamespace, makeParameter, makeVariable, makeVariable, makeVariable, makeVariable, mergeTemps, needsActivation, needsArguments, needsHoistedInitInsns, needsThis, popFrame, processMetadata, pushFrame, pushInlineFunctionFrame, releaseTemp, resetDebugInfo, resetMethodInfo, resolveName, setDebugFile, setDebugLine, setLocalASScope, setMethodInfo, setNeedsActivation, setNeedsArguments, setNeedsRest, setSetsDxns, transferInitializerData

Methods inherited from class java.lang.Object

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

Field Detail

VISIBLE_COMPILATION_UNIT

public static final boolean VISIBLE_COMPILATION_UNIT

The value for the inInvisibleCompilationUnit constructor parameter that means we are not in an invisible compilation unit.

See Also:

Constant Field Values

NO_PARALLEL_CODEGEN

public static final boolean NO_PARALLEL_CODEGEN

Single-thread code generation.

See Also:

Constant Field Values

EMPTY_NAME_PREFIX

public static final String EMPTY_NAME_PREFIX

No synthetic name prefix.

See Also:

Constant Field Values

NO_GENERATOR

public static final ICodeGenerator NO_GENERATOR

No code generator.

USE_DEFAULT_EMITTER

public static final IABCVisitor USE_DEFAULT_EMITTER

No IABCVisitor supplied, this scope should supply a default implementation.

Constructor Detail

GlobalLexicalScope

public GlobalLexicalScope(ICompilerProject project,
                  ICodeGenerator generator)

Construct a "global" scope to attempt to generate a constant value.

Parameters:

project - - the active compiler project.

generator - - the active code generator.

GlobalLexicalScope

public GlobalLexicalScope(ICompilerProject project,
                  ICodeGenerator generator,
                  String syntheticNamePrefix,
                  IABCVisitor emitter)

Construct a global scope with a specialized IABCVisitor. Callers are typically cross-compilers with a visitor that implements novel semantics.

Parameters:

project - - the active compiler project.

generator - - the caller's code generator.

syntheticNamePrefix - - text to prefix any synthetic names generated.

emitter - - the caller's IABCVisitor.

GlobalLexicalScope

public GlobalLexicalScope(ICompilerProject project,
                  ICodeGenerator generator,
                  String syntheticNamePrefix,
                  boolean inInvisibleCompilationUnit,
                  boolean useParallelCodegen,
                  Map<String,String> encodedDebugFiles)

Construct a global lexical scope to serve as the basis for generating code for a compilation unit.

Parameters:

project - - the active compiler project.

generator - - the active code generator.

syntheticNamePrefix - - text to prefix any synthetic names generated.

inInvisibleCompilationUnit - - true if we are compiling an invisible compilation unit, which does not contribute any definitions to the project scope

useParallelCodegen - - use multiple threads to generate code if true.

encodedDebugFiles - - a mapping between the absolute path of a file, and the encoded path that is used by OP_debugfile

Method Detail

isGlobalScope

public boolean isGlobalScope()

Overrides:

isGlobalScope in class LexicalScope

Returns:

true if this scope is the root of a scope chain.

getProject

public ICompilerProject getProject()

Overrides:

getProject in class LexicalScope

Returns:

this scope's compiler project.

getGenerator

public ICodeGenerator getGenerator()

Overrides:

getGenerator in class LexicalScope

Returns:

the code generator that this lexical scope is using.

getInInvisibleCompilationUnit

public boolean getInInvisibleCompilationUnit()

Overrides:

getInInvisibleCompilationUnit in class LexicalScope

Returns:

true if this scope is for an invisible compilation unit. In this case, IDefinition's for package/file classes, interfaces, function's, var's, const's, and namespaces need to be normalized before comparing them by identity in some semantic checks ( namely the type conversion checks ). Also, in this case, we must do additional checking to determine whether an import is valid.

getInitInstructions

public InstructionList getInitInstructions()

Overrides:

getInitInstructions in class LexicalScope

Returns:

any initial instructions for this code generation phase.

getMethodBodySemanticChecker

public MethodBodySemanticChecker getMethodBodySemanticChecker()

Overrides:

getMethodBodySemanticChecker in class LexicalScope

Returns:

the MethodBodySemanticChecker covering this code generation phase.

getProblems

public Collection<ICompilerProblem> getProblems()

Overrides:

getProblems in class LexicalScope

Returns:

the problems covering this code generation phase.

addProblem

public void addProblem(ICompilerProblem problem)

Description copied from class: LexicalScope

Add a problem to this code generation phase.

Overrides:

addProblem in class LexicalScope

Parameters:

problem - The ICompilerProblem to add.

getEmbeds

public Set<EmbedData> getEmbeds()

Returns:

All embeds found during the code generation phase.

getSyntheticName

protected String getSyntheticName(String user_supplied)

Parameters:

user_supplied - - some user-supplied text, which may make debugging easier.

Returns:

a synthetic name string, unique within this compilation unit.

getEncodedDebugFile

protected String getEncodedDebugFile(String filename)

Parameters:

filename - The filename to get the encoded filename for

Returns:

the encoded filename