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

Class ABCGenerator

java.lang.Object

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

All Implemented Interfaces:

ICodeGenerator

public class ABCGenerator
extends Object
implements ICodeGenerator

ABCGenerator is the public interface to the code generator.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ABCGenerator.ConstantValue Represents the result of ICodeGenerator.generateConstantValue(org.apache.flex.compiler.tree.as.IASNode, org.apache.flex.compiler.projects.ICompilerProject)(}.

Nested classes/interfaces inherited from interface org.apache.flex.compiler.internal.as.codegen.ICodeGenerator

ICodeGenerator.IConstantValue

Constructor Summary

Constructors

Constructor and Description
ABCGenerator()

Method Summary

Methods

Modifier and Type	Method and Description
MethodInfo	createMethodInfo(LexicalScope scope, FunctionNode func, Name alternate_name) Creates a MethodInfo specifying the signature of a method declared by a FunctionNode.
MethodInfo	createMethodInfoWithDefaultArgumentValues(LexicalScope scope, FunctionNode func) Creates a MethodInfo specifying the signature of a method declared by a FunctionNode, and adds in the information for any default argument values.
ABCBytesRequestResult	generate(ExecutorService executorService, boolean useParallelCodegen, String synthetic_name_prefix, IASNode root_node, ICompilerProject project, boolean inInvisibleCompilationUnit, Map<String,String> encodedDebugFiles) Generate an ABC file equivalent to the input syntax tree.
ABCBytesRequestResult	generate(String synthetic_name_prefix, IASNode root_node, ICompilerProject project) Generate an ABC file equivalent to the input syntax tree.
ICodeGenerator.IConstantValue	generateConstantValue(IASNode subtree, ICompilerProject project) Helper method to expose the constant folding code to clients outside of the burm, such as org.apache.flex.compiler.internal.as.definitions.ConstantDefinition.
MethodInfo	generateFunction(FunctionNode func, LexicalScope enclosing_scope, InstructionList instance_init_insns, Name alternate_name) Generate code for a function declaration, and put its initialization code on the relevant instruction list.
GenerateFunctionInParallelResult	generateFunctionInParallel(ExecutorService executorService, FunctionNode func, LexicalScope enclosing_scope) Generate code for a function declaration, using a background thread provided by the specified ExecutorService.
InstructionList	generateInstructions(IASNode subtree, int goal_state, LexicalScope scope) Translate an AST into ABC instructions.
InstructionList	generateInstructions(IASNode subtree, int goal_state, LexicalScope scope, InstructionList instance_init_insns) Translate an AST into ABC instructions.
void	generateMethodBodyForFunction(MethodInfo mi, IASNode node, LexicalScope enclosing_scope, InstructionList instance_init_insns) Helper method used by generateFunction() (and also by generateEventHandler() in MXMLDocumentDirectiveProcessor).
void	generateMXMLDataBindingGetterFunction(MethodInfo mi, List<IExpressionNode> nodes, LexicalScope enclosing_scope) Helper method used by databinding codegen to emit an anonymous function based on a list of IExpressionNode's.
void	generateMXMLDataBindingSetterFunction(MethodInfo mi, IExpressionNode setterExpression, LexicalScope enclosing_scope) Helper method used by mxml databinding codegen to emit an anonymous function used by an mxml data binding destination function.
static ICodeGeneratorFactory	getABCGeneratorFactory() Get an ICodeGeneratorFactory that will always return the same ABCGenerator instance
Object	reduceSubtree(IASNode subtree, LexicalScope scope, int goal) Reduce an AST to its equivalent ABC structures.

Methods inherited from class java.lang.Object

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

Constructor Detail

ABCGenerator

public ABCGenerator()

Method Detail

generate

public ABCBytesRequestResult generate(String synthetic_name_prefix,
                             IASNode root_node,
                             ICompilerProject project)
                               throws InterruptedException

Description copied from interface: ICodeGenerator

Generate an ABC file equivalent to the input syntax tree.

Specified by:

generate in interface ICodeGenerator

Parameters:

synthetic_name_prefix - Prefix to prepend to all synthetic names

root_node - the root of the syntax tree.

project - ICompilerProject whose symbol table is used to resolve references to definitions.

Returns:

An ABCBytesRequestResult that can provide the generated code

Throws:

InterruptedException

generate

public ABCBytesRequestResult generate(ExecutorService executorService,
                             boolean useParallelCodegen,
                             String synthetic_name_prefix,
                             IASNode root_node,
                             ICompilerProject project,
                             boolean inInvisibleCompilationUnit,
                             Map<String,String> encodedDebugFiles)
                               throws InterruptedException

Description copied from interface: ICodeGenerator

Generate an ABC file equivalent to the input syntax tree.

Specified by:

generate in interface ICodeGenerator

Parameters:

executorService - ExecutorService used by the code generator when parallel code generation is enabled.

useParallelCodegen - If true, some method bodies are generated in background threads. If false all method bodies are generated on the calling thread.

synthetic_name_prefix - Prefix to prepend to all synthetic names

root_node - the root of the syntax tree.

project - ICompilerProject whose symbol table is used to resolve references to definitions.

inInvisibleCompilationUnit - Indicates whether or not we are generating code for an IInvisibleCompilationUnit.

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

Returns:

An ABCBytesRequestResult that can provide the generated code

Throws:

InterruptedException

generateInstructions

public InstructionList generateInstructions(IASNode subtree,
                                   int goal_state,
                                   LexicalScope scope)

Translate an AST into ABC instructions.

Specified by:

generateInstructions in interface ICodeGenerator

Parameters:

subtree - - the CM subtree.

goal_state - - the desired goal state. One of the nonterminal states in CmcEmitter, or 0 if you're feeling lucky and are willing to accept whatever instruction sequence the BURM decides is optimal.

scope - - the active lexical scope.

Returns:

a list of ABC instructions.

generateInstructions

public InstructionList generateInstructions(IASNode subtree,
                                   int goal_state,
                                   LexicalScope scope,
                                   InstructionList instance_init_insns)

Translate an AST into ABC instructions.

Parameters:

subtree - - the CM subtree.

goal_state - - the desired goal state. One of the nonterminal states in CmcEmitter, or 0 if you're feeling lucky and are willing to accept whatever instruction sequence the BURM decides is optimal.

scope - - the active lexical scope.

instance_init_insns - - a list of instance initialization instructions collected outside a constructor body that must be included in the constructor.

Returns:

a list of ABC instructions.

generateFunction

public MethodInfo generateFunction(FunctionNode func,
                          LexicalScope enclosing_scope,
                          InstructionList instance_init_insns,
                          Name alternate_name)

Generate code for a function declaration, and put its initialization code on the relevant instruction list.

Post condition: if instance_init_insns is not null then the method will have been processed as and marked as a constructor.

Specified by:

generateFunction in interface ICodeGenerator

Parameters:

func - the function declaration node.

enclosing_scope - the lexical scope in which the function was defined.

instance_init_insns - a list of instance initialization instructions collected outside a constructor body that must be included in the constructor.

Returns:

MethodInfo created for the function.

generateFunctionInParallel

public GenerateFunctionInParallelResult generateFunctionInParallel(ExecutorService executorService,
                                                          FunctionNode func,
                                                          LexicalScope enclosing_scope)

Generate code for a function declaration, using a background thread provided by the specified ExecutorService.

Specified by:

generateFunctionInParallel in interface ICodeGenerator

Parameters:

executorService - ExecutorService used to do work in other threads.

func - the function declaration node.

enclosing_scope - the lexical scope in which the function was defined.

Returns:

GenerateFunctionInParallelResult which can be used to wait for code generation of the specified function to complete and to extract the MethodInfo created for the specified function. The MethodInfo may be extracted immediately after this method completes ( you don't have to wait for code generation of the specified function complete ).

generateMethodBodyForFunction

public void generateMethodBodyForFunction(MethodInfo mi,
                                 IASNode node,
                                 LexicalScope enclosing_scope,
                                 InstructionList instance_init_insns)

Helper method used by generateFunction() (and also by generateEventHandler() in MXMLDocumentDirectiveProcessor).

Specified by:

generateMethodBodyForFunction in interface ICodeGenerator

Parameters:

mi - - the MethodInfo describing the signature

node - - the FunctionNode or MXMLEventSpecifierNode.

enclosing_scope - - the lexical scope in which the handler method is autogenerated.

instance_init_insns - - a list of instance initialization instructions collected outside a constructor body that must be included in the constructor.

generateMXMLDataBindingSetterFunction

public void generateMXMLDataBindingSetterFunction(MethodInfo mi,
                                         IExpressionNode setterExpression,
                                         LexicalScope enclosing_scope)

Helper method used by mxml databinding codegen to emit an anonymous function used by an mxml data binding destination function. Example:

If the expression node is a.b.c, this method will generate a funtion whose source would look something like this:

 function (arg:*):void { a.b.c = arg; }
 

Specified by:

generateMXMLDataBindingSetterFunction in interface ICodeGenerator

Parameters:

mi - - the MethodInfo describing the signature

setterExpression - IExpressionNode that is the destination expression of a mxml data binding.

enclosing_scope - LexicalScope for the class initializer that encloses the function being generated.

generateMXMLDataBindingGetterFunction

public void generateMXMLDataBindingGetterFunction(MethodInfo mi,
                                         List<IExpressionNode> nodes,
                                         LexicalScope enclosing_scope)

Helper method used by databinding codegen to emit an anonymous function based on a list of IExpressionNode's. This method emits a function that contains code that evaluates each expression in the list and adds the expressions together with ABCConstants.OP_add.

Specified by:

generateMXMLDataBindingGetterFunction in interface ICodeGenerator

Parameters:

mi - - the MethodInfo describing the signature

nodes - - a List of IExpressionNode's to be codegen'd.

enclosing_scope - LexicalScope for the class initializer that encloses the function being generated.

createMethodInfo

public MethodInfo createMethodInfo(LexicalScope scope,
                          FunctionNode func,
                          Name alternate_name)

Creates a MethodInfo specifying the signature of a method declared by a FunctionNode.

Specified by:

createMethodInfo in interface ICodeGenerator

Parameters:

func - - A FunctionNode representing a method declaration.

Returns:

The MethodInfo specifying the signature of the method.

createMethodInfoWithDefaultArgumentValues

public MethodInfo createMethodInfoWithDefaultArgumentValues(LexicalScope scope,
                                                   FunctionNode func)

Creates a MethodInfo specifying the signature of a method declared by a FunctionNode, and adds in the information for any default argument values.

Specified by:

createMethodInfoWithDefaultArgumentValues in interface ICodeGenerator

Parameters:

func - - A FunctionNode representing a method declaration.

Returns:

The MethodInfo specifying the signature of the method. Will generate a compiler problem is the default value is bad

generateConstantValue

public ICodeGenerator.IConstantValue generateConstantValue(IASNode subtree,
                                                  ICompilerProject project)

Helper method to expose the constant folding code to clients outside of the burm, such as org.apache.flex.compiler.internal.as.definitions.ConstantDefinition.

Specified by:

generateConstantValue in interface ICodeGenerator

Parameters:

subtree - the tree to generate a constant value for

project - the project to use to evaluate the tree

Returns:

the constant value for the subtree, or null if a constant value can't be determined

reduceSubtree

public Object reduceSubtree(IASNode subtree,
                   LexicalScope scope,
                   int goal)
                     throws Exception

Reduce an AST to its equivalent ABC structures.

Specified by:

reduceSubtree in interface ICodeGenerator

Parameters:

subtree - - the root of the AST subtree. May be null, in which case this routine returns null.

scope - - the active LexicalScope.

goal - - the BURM's goal state. One of the CmcEmitter.__foo_NT constants.

Returns:

the result of reducing the subtree to the desired goal state, or null if the input subtree was null.

Throws:

Exception - from the BURM if the computation didn't succeed or was interrupted.

getABCGeneratorFactory

public static ICodeGeneratorFactory getABCGeneratorFactory()

Get an ICodeGeneratorFactory that will always return the same ABCGenerator instance