edu.illinois.cs.cogcomp.lbjava.IR

Class AST

java.lang.Object

edu.illinois.cs.cogcomp.lbjava.IR.ASTNode

edu.illinois.cs.cogcomp.lbjava.IR.AST

public class AST
extends ASTNode

The root node of LBJava's AST. The parser will create only one of these and return it as the ultimate result of parsing. It currently contains a single (optional) PackageDeclaration, a List of ImportDeclarations (also optional), the global SymbolTable, and a List containing ClassifierAssignments, ConstraintDeclarations, and InferenceDeclarations.

The PackageDeclaration specifies what package will contain the generated classes. The ImportDeclarations work similarly to import declarations in regular Java code: they allow the user to name classes in other packages without using their full package names. The list of Declarations comprises the LBJava program. The global SymbolTable simply associates variable names with their type information in the program.

Author:

Nick Rizzolo

Field Summary

Fields

Modifier and Type	Field and Description
DeclarationList	declarations (¬ø) The list of classifier, constraint, and inference declarations representing the LBJava program.
static SymbolTable	globalSymbolTable The symbolTable variable mirrors this variable.
ImportList	imports (¬ø) The list of import statements at the top of the source file.
PackageDeclaration	packageDeclaration (ø) An optional declaration of the package that generated classes should be a part of.

Fields inherited from class edu.illinois.cs.cogcomp.lbjava.IR.ASTNode

byteOffset, line, nodeID, symbolTable

Constructor Summary

Constructors

Constructor and Description
AST(DeclarationList d) Initializes just the statement list.
AST(ImportList i, DeclarationList d) Initializes both lists.
AST(PackageDeclaration p, DeclarationList d) Initializes package declaration and statement list.
AST(PackageDeclaration p, ImportList i, DeclarationList d) Initializes all member variables.
AST(PackageDeclaration p, ImportList i, DeclarationList d, int line, int byteOffset) Full constructor.

Method Summary

Modifier and Type	Method and Description
Object	clone() Creates a new object with the same primitive data, and recursively creates new member data objects as well.
ASTNodeIterator	iterator() Returns an iterator used to successively access the children of this node.
void	runPass(Pass pass) Ensures that the correct run() method is called for this type of node.
void	write(StringBuffer buffer) Writes a string representation of this ASTNode to the specified buffer.

Methods inherited from class edu.illinois.cs.cogcomp.lbjava.IR.ASTNode

toString

Methods inherited from class java.lang.Object

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

Field Detail

globalSymbolTable

public static final SymbolTable globalSymbolTable

The symbolTable variable mirrors this variable.

packageDeclaration

public PackageDeclaration packageDeclaration

(ø) An optional declaration of the package that generated classes should be a part of.

imports

public ImportList imports

(¬ø) The list of import statements at the top of the source file.

declarations

public DeclarationList declarations

(¬ø) The list of classifier, constraint, and inference declarations representing the LBJava program.

Constructor Detail

AST

public AST(DeclarationList d)

Initializes just the statement list. Line and byte offset information are taken from the statement list.

Parameters:

d - The declarations comprising the program.

AST

public AST(ImportList i,
           DeclarationList d)

Initializes both lists. Line and byte offset information are taken from the import list.

Parameters:

i - The import declarations.

d - The declarations comprising the program.

AST

public AST(PackageDeclaration p,
           DeclarationList d)

Initializes package declaration and statement list. Line and byte offset information are taken from the package declaration.

Parameters:

p - The package declaration.

d - The declarations comprising the program.

AST

public AST(PackageDeclaration p,
           ImportList i,
           DeclarationList d)

Initializes all member variables. Line and byte offset information are taken from the package declaration.

Parameters:

p - The package declaration.

i - The import declarations.

d - The declarations comprising the program.

AST

public AST(PackageDeclaration p,
           ImportList i,
           DeclarationList d,
           int line,
           int byteOffset)

Full constructor.

Parameters:

p - The package declaration.

i - The import declarations.

d - The declarations comprising the program.

line - The line on which the source code represented by this node is found.

byteOffset - The byte offset from the beginning of the source file at which the source code represented by this node is found.

Method Detail

iterator

public ASTNodeIterator iterator()

Returns an iterator used to successively access the children of this node.

Specified by:

iterator in class ASTNode

Returns:

An iterator used to successively access the children of this node.

clone

public Object clone()

Creates a new object with the same primitive data, and recursively creates new member data objects as well.

Overrides:

clone in class ASTNode

Returns:

The clone node.

runPass

public void runPass(Pass pass)

Ensures that the correct run() method is called for this type of node.

Specified by:

runPass in class ASTNode

Parameters:

pass - The pass whose run() method should be called.

write

public void write(StringBuffer buffer)

Writes a string representation of this ASTNode to the specified buffer. The representation written is parsable by the LBJava compiler, but not very readable.

Specified by:

write in class ASTNode

Parameters:

buffer - The buffer to write to.