polyglot.ext.jl.ast
Class Call_c

java.lang.Object
  polyglot.ext.jl.ast.Node_c
      polyglot.ext.jl.ast.Term_c
          polyglot.ext.jl.ast.Expr_c
              polyglot.ext.jl.ast.Call_c

All Implemented Interfaces:

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

public class Call_c
extends Expr_c
implements Call

A Call is an immutable representation of a Java method call. It consists of a method name and a list of arguments. It may also have either a Type upon which the method is being called or an expression upon which the method is being called.

Field Summary

protected java.util.List	arguments
protected MethodInstance	mi
protected java.lang.String	name
protected Receiver	target
protected boolean	targetImplicit

Fields inherited from class polyglot.ext.jl.ast.Expr_c

type

Fields inherited from class polyglot.ext.jl.ast.Term_c

exceptions, reachable

Fields inherited from class polyglot.ext.jl.ast.Node_c

del, ext, position

Constructor Summary

Call_c(Position pos, Receiver target, java.lang.String name, java.util.List arguments)

Method Summary

java.util.List	acceptCFG(CFGBuilder v, java.util.List succs) Visit this term in evaluation order.
java.util.List	arguments() Get the actual arguments of the call.
ProcedureCall	arguments(java.util.List arguments) Set the actual arguments of the call.
Node	buildTypes(TypeBuilder tb) Collects classes, methods, and fields from the AST rooted at this node and constructs type objects for these.
protected void	checkConsistency(Context c)
Type	childExpectedType(Expr child, AscriptionVisitor av) Get the expected type of a child expression of this.
void	dump(CodeWriter w) Dumps the AST.
Term	entry() Return the first (sub)term performed when evaluating this term.
Node	exceptionCheck(ExceptionChecker ec) Check exceptions thrown by the call.
ReferenceType	findTargetType()
boolean	isTargetImplicit() Indicates if the target of this call is implicit, that is, was not specified explicitly in the syntax.
MethodInstance	methodInstance() Get the method instance of the call.
Call	methodInstance(MethodInstance mi) Set the method instance of the call.
java.lang.String	name() Get the name of the call.
Call	name(java.lang.String name) Set the name of the call.
Precedence	precedence() Get the precedence of the call.
void	prettyPrint(CodeWriter w, PrettyPrinter tr) Write the expression to an output file.
ProcedureInstance	procedureInstance() The type object of the method we are calling.
protected Call_c	reconstruct(Receiver target, java.util.List arguments) Reconstruct the call.
Receiver	target() Get the target object or type of the call.
Call	target(Receiver target) Set the target object or type of the call.
Call	targetImplicit(boolean targetImplicit) Set whether the target of this call is implicit.
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 call.
protected Node	typeCheckNullTarget(TypeChecker tc, java.util.List argTypes) Typecheck the Call when the target is null.
Node	visitChildren(NodeVisitor v) Visit the children of the call.

Methods inherited from class polyglot.ext.jl.ast.Expr_c

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

Methods inherited from class polyglot.ext.jl.ast.Term_c

exceptions, exceptions, listEntry, reachable, reachable

Methods inherited from class polyglot.ext.jl.ast.Node_c

addDecls, addMembers, addMembersEnter, addMembersOverride, buildTypesEnter, buildTypesOverride, copy, del, del, disambiguate, disambiguateEnter, disambiguateOverride, enterScope, enterScope, exceptionCheckEnter, exceptionCheckOverride, ext, ext, ext, ext, init, node, position, position, print, printBlock, printSubStmt, 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.Expr

constantValue, isConstant, printSubExpr, printSubExpr, type

Methods inherited from interface polyglot.ast.Node

del, del, ext, ext, ext, ext, position, position, visit, visitChild, visitEdge, visitList

Methods inherited from interface polyglot.ast.JL

init, node

Methods inherited from interface polyglot.ast.NodeOps

addDecls, addMembers, addMembersEnter, buildTypesEnter, disambiguate, disambiguateEnter, enterScope, enterScope, exceptionCheckEnter, 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

target

protected Receiver target

name

protected java.lang.String name

arguments

protected java.util.List arguments

mi

protected MethodInstance mi

targetImplicit

protected boolean targetImplicit

Constructor Detail

Call_c

public Call_c(Position pos,
              Receiver target,
              java.lang.String name,
              java.util.List arguments)

Method Detail

precedence

public Precedence precedence()

Get the precedence of the call.

Specified by:

precedence in interface Expr

Overrides:

precedence in class Expr_c

target

public Receiver target()

Get the target object or type of the call.

Specified by:

target in interface Call

target

public Call target(Receiver target)

Set the target object or type of the call.

Specified by:

target in interface Call

name

public java.lang.String name()

Get the name of the call.

Specified by:

name in interface Call

name

public Call name(java.lang.String name)

Set the name of the call.

Specified by:

name in interface Call

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

methodInstance

public MethodInstance methodInstance()

Get the method instance of the call.

Specified by:

methodInstance in interface Call

methodInstance

public Call methodInstance(MethodInstance mi)

Set the method instance of the call.

Specified by:

methodInstance in interface Call

isTargetImplicit

public boolean isTargetImplicit()

Description copied from interface: Call

Indicates if the target of this call is implicit, that is, was not specified explicitly in the syntax.

Specified by:

isTargetImplicit in interface Call

Returns:

boolean indicating if the target of this call is implicit

targetImplicit

public Call targetImplicit(boolean targetImplicit)

Description copied from interface: Call

Set whether the target of this call is implicit.

Specified by:

targetImplicit in interface Call

arguments

public java.util.List arguments()

Get the actual arguments of the call.

Specified by:

arguments in interface Call

Specified by:

arguments in interface ProcedureCall

Returns:

A list of Expr.

arguments

public ProcedureCall arguments(java.util.List arguments)

Set the actual arguments of the call.

Specified by:

arguments in interface Call

Specified by:

arguments in interface ProcedureCall

Parameters:

arguments - A list of Expr.

reconstruct

protected Call_c reconstruct(Receiver target,
                             java.util.List arguments)

Reconstruct the call.

visitChildren

public Node visitChildren(NodeVisitor v)

Visit the children of the call.

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.

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

typeCheckNullTarget

protected Node typeCheckNullTarget(TypeChecker tc,
                                   java.util.List argTypes)
                            throws SemanticException

Typecheck the Call when the target is null. This method finds an appropriate target, and then type checks accordingly.

Parameters:

argTypes - list of Types of the arguments

Throws:

SemanticException

typeCheck

public Node typeCheck(TypeChecker tc)
               throws SemanticException

Type check the call.

Specified by:

typeCheck in interface NodeOps

Overrides:

typeCheck in class Node_c

Parameters:

tc - The type checking visitor.

Throws:

SemanticException

findTargetType

public ReferenceType findTargetType()
                             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.

toString

public java.lang.String toString()

Overrides:

toString in class Node_c

prettyPrint

public void prettyPrint(CodeWriter w,
                        PrettyPrinter tr)

Write the expression to an output file.

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)

Dumps the AST.

Specified by:

dump in interface Node

Overrides:

dump in class Expr_c

entry

public Term entry()

Description copied from class: Term_c

Return the first (sub)term performed when evaluating this term.

Specified by:

entry in interface Term

Specified by:

entry in class Term_c

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

exceptionCheck

public Node exceptionCheck(ExceptionChecker ec)
                    throws SemanticException

Check exceptions thrown by the call.

Specified by:

exceptionCheck in interface NodeOps

Overrides:

exceptionCheck in class Term_c

Parameters:

ec - The visitor.

Throws:

SemanticException

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

checkConsistency

protected void checkConsistency(Context c)
                         throws SemanticException

Throws:

SemanticException