polyglot.ast
Class New_c

java.lang.Object
  polyglot.ast.Node_c
      polyglot.ast.Term_c
          polyglot.ast.Expr_c
              polyglot.ast.New_c

All Implemented Interfaces:

java.lang.Cloneable, Expr, JL, New, Node, NodeOps, Prefix, ProcedureCall, Receiver, Term, Typed, Copy

public class New_c
extends Expr_c
implements New

A New is an immutable representation of the use of the new operator to create a new instance of a class. In addition to the type of the class being created, a New has a list of arguments to be passed to the constructor of the object and an optional ClassBody used to support anonymous classes.

Field Summary

protected ParsedClassType	anonType
protected java.util.List	arguments
protected ClassBody	body
protected ConstructorInstance	ci
protected Expr	qualifier
protected TypeNode	tn

Fields inherited from class polyglot.ast.Expr_c

type

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

Fields inherited from interface polyglot.ast.Term

ENTRY, EXIT

Constructor Summary

New_c(Position pos, Expr qualifier, TypeNode tn, java.util.List arguments, ClassBody body)

Method Summary

java.util.List	acceptCFG(CFGBuilder v, java.util.List succs) Visit this term in evaluation order.
ParsedClassType	anonType() The type object for anonymous classes, or null.
New	anonType(ParsedClassType anonType) Set the type object for anonymous classes.
java.util.List	arguments() Actual arguments to pass to the constructor.
ProcedureCall	arguments(java.util.List arguments) Set the actual arguments to pass to the constructor.
ClassBody	body() The class body for anonymous classes, or null.
New	body(ClassBody body) Set the class body for anonymous classes.
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.
Type	childExpectedType(Expr child, AscriptionVisitor av) Get the expected type of a child expression of this.
ConstructorInstance	constructorInstance() The constructor invoked by this expression.
New	constructorInstance(ConstructorInstance ci) Set the constructor invoked by this expression.
Node	copy(NodeFactory nf) Produce a copy of this node using the given NodeFactory.
Node	disambiguate(AmbiguityRemover ar) Remove any remaining ambiguities from the AST.
Node	disambiguateOverride(Node parent, AmbiguityRemover ar) Disambiguate the AST.
Context	enterChildScope(Node child, Context c) Push a new scope for visiting the child node child.
Node	exceptionCheck(ExceptionChecker ec) Check that exceptions are properly propagated throughout the AST.
protected New	findQualifier(AmbiguityRemover ar, ClassType ct)
Term	firstChild() Return the first direct subterm performed when evaluating this term.
TypeNode	objectType() Get the type we are instantiating.
New	objectType(TypeNode tn) Set the type we are instantiating.
Precedence	precedence() Get the precedence of the expression.
void	prettyPrint(CodeWriter w, PrettyPrinter tr) Pretty-print the AST using the given CodeWriter.
protected void	printArgs(CodeWriter w, PrettyPrinter tr)
protected void	printBody(CodeWriter w, PrettyPrinter tr)
protected void	printQualifier(CodeWriter w, PrettyPrinter tr)
ProcedureInstance	procedureInstance() The type object of the method we are calling.
Expr	qualifier() Get the qualifier expression of the allocation.
New	qualifier(Expr qualifier) Set the qualifier expression of the allocation.
protected New_c	reconstruct(Expr qualifier, TypeNode tn, java.util.List arguments, ClassBody body) Reconstruct the expression.
java.util.List	throwTypes(TypeSystem ts) List of Types of exceptions that might get thrown.
java.lang.String	toString()
Node	typeCheck(TypeChecker tc) Type check the AST.
protected void	typeCheckFlags(TypeChecker tc)
protected void	typeCheckNested(TypeChecker tc)
Node	typeCheckOverride(Node parent, TypeChecker tc) Type check the AST.
Node	visitChildren(NodeVisitor v) Visit the children of the expression.

Methods inherited from class polyglot.ast.Expr_c

booleanValue, byteValue, charValue, constantValue, constantValueSet, doubleValue, dump, floatValue, intValue, isConstant, isTypeChecked, longValue, printSubExpr, printSubExpr, shortValue, stringValue, type, type

Methods inherited from class polyglot.ast.Term_c

exceptions, exceptions, listChild, reachable, reachable

Methods inherited from class polyglot.ast.Node_c

addDecls, checkConstants, copy, copy, del, del, disambiguateEnter, dump, dump, enterScope, error, error, exceptionCheckEnter, ext, ext, ext, ext, init, isDisambiguated, node, position, position, prettyPrint, prettyPrint, print, printBlock, printSubStmt, translate, typeCheckEnter, 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.Expr

constantValue, constantValueSet, isConstant, printSubExpr, printSubExpr, type

Methods inherited from interface polyglot.ast.Node

del, del, dump, error, error, ext, ext, ext, ext, isDisambiguated, isTypeChecked, position, position, visit, visitChild, visitEdge, visitList

Methods inherited from interface polyglot.ast.JL

init, node

Methods inherited from interface polyglot.ast.NodeOps

addDecls, checkConstants, copy, disambiguateEnter, dump, dump, enterScope, exceptionCheckEnter, prettyPrint, prettyPrint, translate, typeCheckEnter

Methods inherited from interface polyglot.util.Copy

copy

Methods inherited from interface polyglot.ast.Typed

type

Methods inherited from interface polyglot.ast.Term

exceptions, exceptions, reachable, reachable

Methods inherited from interface polyglot.ast.Term

exceptions, exceptions, reachable, reachable

Field Detail

qualifier

protected Expr qualifier

tn

protected TypeNode tn

arguments

protected java.util.List arguments

body

protected ClassBody body

ci

protected ConstructorInstance ci

anonType

protected ParsedClassType anonType

Constructor Detail

New_c

public New_c(Position pos,
             Expr qualifier,
             TypeNode tn,
             java.util.List arguments,
             ClassBody body)

Method Detail

qualifier

public Expr qualifier()

Get the qualifier expression of the allocation.

Specified by:

qualifier in interface New

qualifier

public New qualifier(Expr qualifier)

Set the qualifier expression of the allocation.

Specified by:

qualifier in interface New

objectType

public TypeNode objectType()

Get the type we are instantiating.

Specified by:

objectType in interface New

objectType

public New objectType(TypeNode tn)

Set the type we are instantiating.

Specified by:

objectType in interface New

anonType

public ParsedClassType anonType()

Description copied from interface: New

The type object for anonymous classes, or null.

Specified by:

anonType in interface New

anonType

public New anonType(ParsedClassType anonType)

Description copied from interface: New

Set the type object for anonymous classes.

Specified by:

anonType in interface New

procedureInstance

public ProcedureInstance procedureInstance()

Description copied from interface: ProcedureCall

The type object of the method we are calling. This is, generally, only valid after the type-checking pass.

Specified by:

procedureInstance in interface ProcedureCall

constructorInstance

public ConstructorInstance constructorInstance()

Description copied from interface: New

The constructor invoked by this expression.

Specified by:

constructorInstance in interface New

constructorInstance

public New constructorInstance(ConstructorInstance ci)

Description copied from interface: New

Set the constructor invoked by this expression.

Specified by:

constructorInstance in interface New

arguments

public java.util.List arguments()

Description copied from interface: New

Actual arguments to pass to the constructor.

Specified by:

arguments in interface New

Specified by:

arguments in interface ProcedureCall

Returns:

A list of Expr.

arguments

public ProcedureCall arguments(java.util.List arguments)

Description copied from interface: New

Set the actual arguments to pass to the constructor.

Specified by:

arguments in interface New

Specified by:

arguments in interface ProcedureCall

Parameters:

arguments - A list of Expr.

body

public ClassBody body()

Description copied from interface: New

The class body for anonymous classes, or null.

Specified by:

body in interface New

body

public New body(ClassBody body)

Description copied from interface: New

Set the class body for anonymous classes.

Specified by:

body in interface New

reconstruct

protected New_c reconstruct(Expr qualifier,
                            TypeNode tn,
                            java.util.List arguments,
                            ClassBody body)

Reconstruct the expression.

visitChildren

public Node visitChildren(NodeVisitor v)

Visit the children of the expression.

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.

enterChildScope

public Context enterChildScope(Node child,
                               Context c)

Description copied from class: Node_c

Push a new scope for visiting the child node child. The default behavior is to delegate the call to the child node, and let it add appropriate declarations that should be in scope. However, this method gives parent nodes have the ability to modify this behavior.

Specified by:

enterChildScope in interface NodeOps

Overrides:

enterChildScope in class Node_c

Parameters:

child - the child node about to be entered.

c - the current Context

Returns:

the Context to be used for visiting node child

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 Expr_c

Parameters:

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

Throws:

SemanticException

disambiguateOverride

public Node disambiguateOverride(Node parent,
                                 AmbiguityRemover ar)
                          throws SemanticException

Description copied from interface: NodeOps

Disambiguate the AST. This method is called by the override() method of the visitor. If this method returns non-null, the node's children will not be visited automatically. Thus, the method should check both the node this and it's children, usually by invoking visitChildren with tc or with another visitor, returning a non-null node. OR, the method should do nothing and simply return null to allow enter, visitChildren, and leave to be invoked on the node. The default implementation returns null. Overriding of this method is discouraged, but sometimes necessary.

Specified by:

disambiguateOverride in interface NodeOps

Overrides:

disambiguateOverride in class Node_c

ar - The visitor which disambiguates.

Throws:

SemanticException

disambiguate

public Node disambiguate(AmbiguityRemover ar)
                  throws SemanticException

Description copied from interface: NodeOps

Remove any remaining ambiguities from 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. The node should not assume that its children have been disambiguated. If it depends on a child being disambiguated, it may just return this without doing any work.

Specified by:

disambiguate in interface NodeOps

Overrides:

disambiguate in class Node_c

Parameters:

ar - The visitor which disambiguates.

Throws:

SemanticException

findQualifier

protected New findQualifier(AmbiguityRemover ar,
                            ClassType ct)
                     throws SemanticException

Parameters:

ar -

ct -

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

typeCheckNested

protected void typeCheckNested(TypeChecker tc)
                        throws SemanticException

Throws:

SemanticException

typeCheckFlags

protected void typeCheckFlags(TypeChecker tc)
                       throws SemanticException

Throws:

SemanticException

childExpectedType

public Type childExpectedType(Expr child,
                              AscriptionVisitor av)

Description copied from interface: Node

Get the expected type of a child expression of this. The expected type is determined by the context in that the child occurs (e.g., for x = e, the expected type of e is the declared type of x. The expected type should impose the least constraints on the child's type that are allowed by the parent node.

Specified by:

childExpectedType in interface Node

Overrides:

childExpectedType in class Node_c

Parameters:

child - A child expression of this node.

av - An ascription visitor.

Returns:

The expected type of child.

exceptionCheck

public Node exceptionCheck(ExceptionChecker ec)
                    throws SemanticException

Description copied from interface: NodeOps

Check that exceptions are properly propagated throughout 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:

exceptionCheck in interface NodeOps

Overrides:

exceptionCheck in class Term_c

Parameters:

ec - The visitor.

Throws:

SemanticException

precedence

public Precedence precedence()

Get the precedence of the expression.

Specified by:

precedence in interface Expr

Overrides:

precedence in class Expr_c

toString

public java.lang.String toString()

Overrides:

toString in class Node_c

printQualifier

protected void printQualifier(CodeWriter w,
                              PrettyPrinter tr)

printArgs

protected void printArgs(CodeWriter w,
                         PrettyPrinter tr)

printBody

protected void printBody(CodeWriter w,
                         PrettyPrinter tr)

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.

firstChild

public Term firstChild()

Description copied from interface: Term

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 Term

acceptCFG

public java.util.List acceptCFG(CFGBuilder v,
                                java.util.List succs)

Description copied from class: Term_c

Visit this term in evaluation order.

Specified by:

acceptCFG in interface Term

Specified by:

acceptCFG in class Term_c

throwTypes

public java.util.List throwTypes(TypeSystem ts)

Description copied from interface: NodeOps

List of Types of exceptions that might get thrown. The result is not necessarily correct until after type checking.

Specified by:

throwTypes in interface NodeOps

Overrides:

throwTypes in class Node_c

typeCheckOverride

public Node typeCheckOverride(Node parent,
                              TypeChecker tc)
                       throws SemanticException

Description copied from class: Node_c

Type check the AST.

Specified by:

typeCheckOverride in interface NodeOps

Overrides:

typeCheckOverride in class Node_c

Parameters:

parent -

tc -

Throws:

SemanticException

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