polyglot.ast

Class Initializer_c

java.lang.Object

polyglot.ast.Node_c

polyglot.ast.Term_c

polyglot.ast.Initializer_c

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, ClassMember, CodeBlock, CodeDecl, CodeNode, Initializer, Node, NodeOps, Term, TermOps, Copy<Node>

public class Initializer_c
extends Term_c
implements Initializer

An Initializer is an immutable representation of an initializer block in a Java class (which appears outside of any method). Such a block is executed before the code for any of the constructors. Such a block can optionally be static, in which case it is executed when the class is loaded.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface polyglot.ast.Term

Term.Instance

Nested classes/interfaces inherited from interface polyglot.util.Copy

Copy.Util

Field Summary

Fields

Modifier and Type	Field and Description
protected Block	body
protected Flags	flags
protected InitializerInstance	ii

Fields inherited from class polyglot.ast.Term_c

exceptions, reachable

Fields inherited from class polyglot.ast.Node_c

del, error, ext, position

Fields inherited from interface polyglot.ast.Term

ENTRY, EXIT

Constructor Summary

Constructors

Constructor and Description
Initializer_c(Position pos, Flags flags, Block body)
Initializer_c(Position pos, Flags flags, Block body, Ext ext)

Method Summary

Methods

Modifier and Type	Method and Description
<T> java.util.List<T>	acceptCFG(CFGBuilder<?> v, java.util.List<T> succs) Visit this term in evaluation order, calling v.edge() for each successor in succs, if data flows on that edge.
Block	body() The body of the method, constructor, or initializer.
CodeBlock	body(Block body) Set the body of the method, constructor, or initializer.
protected <N extends Initializer_c> N	body(N n, Block body)
Node	buildTypes(TypeBuilder tb) Collects classes, methods, and fields from the AST rooted at this node and constructs type objects for these.
NodeVisitor	buildTypesEnter(TypeBuilder tb) Collects classes, methods, and fields from the AST rooted at this node and constructs type objects for these.
Term	codeBody() The body of the method, constructor, initializer, or field initializer.
CodeInstance	codeInstance() The CodeInstance of the method, constructor, or initializer.
Node	copy(NodeFactory nf) Produce a copy of this node using the given NodeFactory.
void	dump(CodeWriter w) Dump the AST node for debugging purposes.
Context	enterScope(Context c) Push a new scope upon entering this node, and add any declarations to the context that should be in scope when visiting children of this node.
NodeVisitor	exceptionCheckEnter(ExceptionChecker ec) Check that exceptions are properly propagated throughout the AST.
Node	extRewrite(ExtensionRewriter rw) Rewrite the AST for the compilation in this language.
Term	firstChild() Return the first direct subterm performed when evaluating this term.
Flags	flags() Get the initializer's flags.
Initializer	flags(Flags flags) Set the initializer's flags.
protected <N extends Initializer_c> N	flags(N n, Flags flags)
InitializerInstance	initializerInstance() Get the initializer's type object.
Initializer	initializerInstance(InitializerInstance ii) Set the initializer's type object.
protected <N extends Initializer_c> N	initializerInstance(N n, InitializerInstance ii)
boolean	isDisambiguated()
MemberInstance	memberInstance()
void	prettyPrint(CodeWriter w, PrettyPrinter tr) Pretty-print the AST using the given CodeWriter.
protected <N extends Initializer_c> N	reconstruct(N n, Block body) Reconstruct the initializer.
java.lang.String	toString()
Node	typeCheck(TypeChecker tc) Type check the AST.
Node	visitChildren(NodeVisitor v) Visit the children of the node.

Methods inherited from class polyglot.ast.Term_c

exceptionCheck, exceptions, exceptions, exceptions, listChild, reachable, reachable, reachable

Methods inherited from class polyglot.ast.Node_c

addDecls, checkConstants, childExpectedType, copy, copy, copyIfNeeded, del, del, disambiguate, disambiguateEnter, disambiguateOverride, dump, dump, dump, dump, enterChildScope, error, error, error, ext, ext, ext, ext, extRewriteEnter, isTypeChecked, lang, position, position, position, prettyPrint, prettyPrint, prettyPrint, prettyPrint, print, printBlock, printSubStmt, throwTypes, translate, typeCheckEnter, typeCheckOverride, visit, visitChild, visitEdge, visitList

Methods inherited from class java.lang.Object

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

Methods inherited from interface polyglot.ast.Term

exceptions, exceptions, reachable, reachable

Methods inherited from interface polyglot.ast.Node

del, del, error, error, ext, ext, ext, ext, isTypeChecked, position, position, visit, visitEdge

Methods inherited from interface polyglot.ast.NodeOps

addDecls, checkConstants, childExpectedType, copy, disambiguate, disambiguateEnter, disambiguateOverride, dump, dump, dump, dump, enterChildScope, exceptionCheck, extRewriteEnter, lang, prettyPrint, prettyPrint, prettyPrint, prettyPrint, throwTypes, translate, typeCheckEnter, typeCheckOverride, visitChild, visitList

Methods inherited from interface polyglot.util.Copy

copy

Field Detail

flags

protected Flags flags

body

protected Block body

ii

protected InitializerInstance ii

Constructor Detail

Initializer_c

public Initializer_c(Position pos,
             Flags flags,
             Block body)

Initializer_c

public Initializer_c(Position pos,
             Flags flags,
             Block body,
             Ext ext)

Method Detail

isDisambiguated

public boolean isDisambiguated()

Specified by:

isDisambiguated in interface Node

Overrides:

isDisambiguated in class Node_c

Returns:

true if the all type information for the node (but not necessarily for the node's children) is unambiguous.

flags

public Flags flags()

Description copied from interface: Initializer

Get the initializer's flags.

Specified by:

flags in interface Initializer

flags

public Initializer flags(Flags flags)

Description copied from interface: Initializer

Set the initializer's flags.

Specified by:

flags in interface Initializer

flags

protected <N extends Initializer_c> N flags(N n,
                                Flags flags)

codeInstance

public CodeInstance codeInstance()

Description copied from interface: CodeNode

The CodeInstance of the method, constructor, or initializer.

Specified by:

codeInstance in interface CodeNode

memberInstance

public MemberInstance memberInstance()

Specified by:

memberInstance in interface ClassMember

initializerInstance

public InitializerInstance initializerInstance()

Description copied from interface: Initializer

Get the initializer's type object. This field may not be valid until after signature disambiguation.

Specified by:

initializerInstance in interface Initializer

initializerInstance

public Initializer initializerInstance(InitializerInstance ii)

Description copied from interface: Initializer

Set the initializer's type object.

Specified by:

initializerInstance in interface Initializer

initializerInstance

protected <N extends Initializer_c> N initializerInstance(N n,
                                              InitializerInstance ii)

codeBody

public Term codeBody()

Description copied from interface: CodeNode

The body of the method, constructor, initializer, or field initializer.

Specified by:

codeBody in interface CodeNode

body

public Block body()

Description copied from interface: CodeBlock

The body of the method, constructor, or initializer.

Specified by:

body in interface CodeBlock

body

public CodeBlock body(Block body)

Description copied from interface: CodeBlock

Set the body of the method, constructor, or initializer.

Specified by:

body in interface CodeBlock

body

protected <N extends Initializer_c> N body(N n,
                               Block body)

reconstruct

protected <N extends Initializer_c> N reconstruct(N n,
                                      Block body)

Reconstruct the initializer.

visitChildren

public Node visitChildren(NodeVisitor v)

Description copied from interface: NodeOps

Visit the children of the node.

Specified by:

visitChildren in interface NodeOps

Overrides:

visitChildren in class Node_c

Parameters:

v - The visitor that will traverse/rewrite the AST.

Returns:

A new AST if a change was made, or this.

enterScope

public Context enterScope(Context c)

Description copied from class: Node_c

Push a new scope upon entering this node, and add any declarations to the context that should be in scope when visiting children of this node.

Specified by:

enterScope in interface NodeOps

Overrides:

enterScope in class Node_c

Parameters:

c - the current Context

Returns:

the Context to be used for visiting this node.

buildTypesEnter

public NodeVisitor buildTypesEnter(TypeBuilder tb)
                            throws SemanticException

Description copied from interface: NodeOps

Collects classes, methods, and fields from the AST rooted at this node and constructs type objects for these. These type objects may be ambiguous. Inserts classes into the TypeSystem. This method is called by the enter() method of the visitor. The * method should perform work that should be done before visiting the children of the node. The method may return this or a new copy of the node on which visitChildren() and leave() will be invoked.

Specified by:

buildTypesEnter in interface NodeOps

Overrides:

buildTypesEnter in class Node_c

Parameters:

tb - The visitor which adds new type objects to the TypeSystem.

Throws:

SemanticException

buildTypes

public Node buildTypes(TypeBuilder tb)
                throws SemanticException

Description copied from interface: NodeOps

Collects classes, methods, and fields from the AST rooted at this node and constructs type objects for these. These type objects may be ambiguous. Inserts classes into the TypeSystem. This method is called by the leave() method of the visitor. The method should perform work that should be done after visiting the children of the node. The method may return this or a new copy of the node which will be installed as a child of the node's parent.

Specified by:

buildTypes in interface NodeOps

Overrides:

buildTypes in class Node_c

Parameters:

tb - The visitor which adds new type objects to the TypeSystem.

Throws:

SemanticException

typeCheck

public Node typeCheck(TypeChecker tc)
               throws SemanticException

Description copied from interface: NodeOps

Type check the AST. This method is called by the leave() method of the visitor. The method should perform work that should be done after visiting the children of the node. The method may return this or a new copy of the node which will be installed as a child of the node's parent.

Specified by:

typeCheck in interface NodeOps

Overrides:

typeCheck in class Node_c

Parameters:

tc - The type checking visitor.

Throws:

SemanticException

exceptionCheckEnter

public NodeVisitor exceptionCheckEnter(ExceptionChecker ec)
                                throws SemanticException

Description copied from interface: NodeOps

Check that exceptions are properly propagated throughout the AST. This method is called by the enter() method of the visitor. The * method should perform work that should be done before visiting the children of the node. The method may return this or a new copy of the node on which visitChildren() and leave() will be invoked.

Specified by:

exceptionCheckEnter in interface NodeOps

Overrides:

exceptionCheckEnter in class Node_c

Parameters:

ec - The visitor.

Throws:

SemanticException

extRewrite

public Node extRewrite(ExtensionRewriter rw)
                throws SemanticException

Description copied from interface: NodeOps

Rewrite the AST for the compilation in this language. This method is called by the leave() method of the visitor. The method should perform work that should be done after visiting the children of the node. The method may return this or a new copy of the node which will be installed as a child of the node's parent.

Specified by:

extRewrite in interface NodeOps

Overrides:

extRewrite in class Term_c

Parameters:

rw - The visitor.

Throws:

SemanticException

firstChild

public Term firstChild()

Description copied from interface: TermOps

Return the first direct subterm performed when evaluating this term. If this term has no subterms, this should return null. This method is similar to the deprecated entry(), but it should *not* recursively drill down to the innermost subterm. The direct child visited first in this term's dataflow should be returned.

Specified by:

firstChild in interface TermOps

Specified by:

firstChild in class Term_c

acceptCFG

public <T> java.util.List<T> acceptCFG(CFGBuilder<?> v,
                              java.util.List<T> succs)

Description copied from interface: TermOps

Visit this term in evaluation order, calling v.edge() for each successor in succs, if data flows on that edge.

Specified by:

acceptCFG in interface TermOps

Specified by:

acceptCFG in class Term_c

toString

public java.lang.String toString()

Overrides:

toString in class Node_c

prettyPrint

public void prettyPrint(CodeWriter w,
               PrettyPrinter tr)

Description copied from class: Node_c

Pretty-print the AST using the given CodeWriter.

Specified by:

prettyPrint in interface NodeOps

Overrides:

prettyPrint in class Node_c

Parameters:

w - The code writer to which to write.

tr - The pretty printer. This is not a visitor.

dump

public void dump(CodeWriter w)

Description copied from interface: Node

Dump the AST node for debugging purposes.

Specified by:

dump in interface Node

Overrides:

dump in class Node_c

copy

public Node copy(NodeFactory nf)

Description copied from interface: NodeOps

Produce a copy of this node using the given NodeFactory.

Specified by:

copy in interface NodeOps

Overrides:

copy in class Node_c